Account Profiling
Build a comprehensive profile of any TRON account covering asset holdings, resource status, staking/voting behavior, transaction patterns, and investment preferences.
MCP Server
- Prerequisite: TronGrid MCP Guide
Instructions
Step 1: Validate the Address
Call validateAddress with the target address. If invalid, inform the user and ask for correction before proceeding.
Step 2: Fetch Account Fundamentals
Run these calls in parallel for speed:
getAccount— TRX balance, TRC-10 holdings (assetV2), creation time, permissions, frozen balances (Stake 1.0 & 2.0), vote infogetAccountResource— Energy/bandwidth limits, usage, delegated resources, staked TRX amountsgetAccountNet— Free and staked bandwidth details
Step 3: Fetch Token Holdings
getTrc20Balance— All TRC-20 token balances- For significant holdings, call
getTrc20Infowith contract addresses to resolve token names, symbols, and decimals - TRC-10 assets are already in the
getAccountresponse (assetV2 field)
Step 4: Analyze Staking & Voting
getDelegatedResourceAccountIndexV2— List of addresses this account delegates to / receives fromgetDelegatedResourceV2— Detailed delegation amounts for specific pairsgetReward— Unclaimed voting rewards- Extract vote list from
getAccountresponse to show which SRs the account votes for
Step 5: Examine Transaction History
getAccountTransactions— Recent transaction history (uselimitandorder_byparams)getAccountTrc20Transactions— TRC-20 transfer historygetInternalTransactions— Contract-triggered internal transfers
Analyze patterns: frequency, common types (transfers/contract calls/staking), most-interacted addresses, average value.
Step 6: Identify DeFi Participation
From transaction history, identify interactions with known DeFi protocols (SunSwap, JustLend, SunIO, etc.) and categorize as DEX trades, liquidity provision, lending/borrowing, or yield farming.
Step 7: Compile Account Profile
Present findings in this format:
## Account Profile: [address]
### Overview
- Created: [date]
- Account Type: [Regular/Contract/SR]
- Total Asset Value: ~$[estimated USD value]
### TRX Holdings
- Available: [amount] TRX
- Staked (Energy): [amount] TRX
- Staked (Bandwidth): [amount] TRX
### Token Holdings
| Token | Balance | Value (USD) |
|-------|---------|-------------|
| USDT | X,XXX | $X,XXX |
### Resources
- Energy: [used]/[total] ([X%] utilized)
- Bandwidth: [used]/[total] ([X%] utilized)
### Voting & Staking
- Votes Cast: [total]
- Voting For: [SR list]
- Unclaimed Rewards: [amount] TRX
### Activity Analysis
- Recent Activity (30d): [count] transactions
- Primary Activities: [transfer/contract call/staking]
- Most Interacted Contracts: [list]
### Account Classification
- Type: [Whale/Active Trader/HODLer/DeFi User/Developer/Inactive]
- Activity Trend: [Increasing/Stable/Decreasing]
Error Handling
| Error | Cause | Resolution |
|---|---|---|
| Invalid address | Malformed TRON address | Ask user to verify the address format (T-prefix, 34 chars) |
| Empty account | Address exists but never activated | Inform user this address has no on-chain activity |
| No TRC-20 data | Account has no TRC-20 tokens | Skip token section, note "No TRC-20 holdings found" |
| API timeout | TronGrid rate limit or network issue | Retry the specific failed call; partial results are still useful |