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
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
getTrc20Info with contract addresses to resolve token names, symbols, and decimals
- TRC-10 assets are already in the
getAccount response (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
getAccount response to show which SRs the account votes for
Step 5: Examine Transaction History
getAccountTransactions — Recent transaction history (use limit and order_by params)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 |
Examples
- Check account balance and holdings
- Analyze a whale account
1---2name: trongrid-account-profiling3description: Analyze any TRON account's assets, token holdings, staking, voting, energy/bandwidth, and transaction patterns. Use when a user asks about a TRON address, wants to check wallet balance, analyze account activity, track whale wallets, or look up what an address holds. Covers TRX balance, TRC-20/TRC-10 tokens, resource usage, delegation, voting rewards, transaction history, and DeFi participation.4---56# Account Profiling78Build a comprehensive profile of any TRON account covering asset holdings, resource status, staking/voting behavior, transaction patterns, and investment preferences.910# MCP Server11- **Prerequisite**: [TronGrid MCP Guide](https://developers.tron.network/reference/mcp-api)1213## Instructions1415### Step 1: Validate the Address1617Call `validateAddress` with the target address. If invalid, inform the user and ask for correction before proceeding.1819### Step 2: Fetch Account Fundamentals2021Run these calls in parallel for speed:22231. `getAccount` — TRX balance, TRC-10 holdings (assetV2), creation time, permissions, frozen balances (Stake 1.0 & 2.0), vote info242. `getAccountResource` — Energy/bandwidth limits, usage, delegated resources, staked TRX amounts253. `getAccountNet` — Free and staked bandwidth details2627### Step 3: Fetch Token Holdings28291. `getTrc20Balance` — All TRC-20 token balances302. For significant holdings, call `getTrc20Info` with contract addresses to resolve token names, symbols, and decimals313. TRC-10 assets are already in the `getAccount` response (assetV2 field)3233### Step 4: Analyze Staking & Voting34351. `getDelegatedResourceAccountIndexV2` — List of addresses this account delegates to / receives from362. `getDelegatedResourceV2` — Detailed delegation amounts for specific pairs373. `getReward` — Unclaimed voting rewards384. Extract vote list from `getAccount` response to show which SRs the account votes for3940### Step 5: Examine Transaction History41421. `getAccountTransactions` — Recent transaction history (use `limit` and `order_by` params)432. `getAccountTrc20Transactions` — TRC-20 transfer history443. `getInternalTransactions` — Contract-triggered internal transfers4546Analyze patterns: frequency, common types (transfers/contract calls/staking), most-interacted addresses, average value.4748### Step 6: Identify DeFi Participation4950From transaction history, identify interactions with known DeFi protocols (SunSwap, JustLend, SunIO, etc.) and categorize as DEX trades, liquidity provision, lending/borrowing, or yield farming.5152### Step 7: Compile Account Profile5354Present findings in this format:5556```57## Account Profile: [address]5859### Overview60- Created: [date]61- Account Type: [Regular/Contract/SR]62- Total Asset Value: ~$[estimated USD value]6364### TRX Holdings65- Available: [amount] TRX66- Staked (Energy): [amount] TRX67- Staked (Bandwidth): [amount] TRX6869### Token Holdings70| Token | Balance | Value (USD) |71|-------|---------|-------------|72| USDT | X,XXX | $X,XXX |7374### Resources75- Energy: [used]/[total] ([X%] utilized)76- Bandwidth: [used]/[total] ([X%] utilized)7778### Voting & Staking79- Votes Cast: [total]80- Voting For: [SR list]81- Unclaimed Rewards: [amount] TRX8283### Activity Analysis84- Recent Activity (30d): [count] transactions85- Primary Activities: [transfer/contract call/staking]86- Most Interacted Contracts: [list]8788### Account Classification89- Type: [Whale/Active Trader/HODLer/DeFi User/Developer/Inactive]90- Activity Trend: [Increasing/Stable/Decreasing]91```9293## Error Handling9495| Error | Cause | Resolution |96|-------|-------|------------|97| Invalid address | Malformed TRON address | Ask user to verify the address format (T-prefix, 34 chars) |98| Empty account | Address exists but never activated | Inform user this address has no on-chain activity |99| No TRC-20 data | Account has no TRC-20 tokens | Skip token section, note "No TRC-20 holdings found" |100| API timeout | TronGrid rate limit or network issue | Retry the specific failed call; partial results are still useful |101102## Examples103104- [Check account balance and holdings](examples/check-account-balance.md)105- [Analyze a whale account](examples/analyze-whale-account.md)
dvcrn