token_rank_list¶

Ranks tokens by the quality and strength of their holder community. TokenRank analyses every holder of a token, scores them using ChainAware's 14M+ wallet behavioural profiles, and ranks the token based on the aggregate strength of its community — not market cap, not price, not hype.

The stronger the holders, the stronger the token.

MCP Endpoint: https://prediction.mcp.chainaware.ai/sse

Supported Networks¶

Identifier	Network
`ETH`	Ethereum
`BNB`	BNB Smart Chain
`BASE`	Base
`SOLANA`	Solana

Input Schema¶

Field	Type	Required	Description
`limit`	string	Yes	Number of results per page — e.g. `"10"`, `"25"`
`offset`	string	Yes	Page number for pagination — `"0"` for first page
`network`	string	Yes	One of the network identifiers above
`sort_by`	string	Yes	Field to sort by — use `"communityRank"`
`sort_order`	string	Yes	`"ASC"` or `"DESC"`
`category`	string	Yes	Token category filter (see below) — pass `""` for all categories
`contract_name`	string	Yes	Search by token or contract name — pass `""` for no filter

Token Categories¶

Value	Description
`AI Token`	Tokens in the AI / artificial intelligence sector
`RWA Token`	Real-World Asset tokens
`DeFi Token`	Decentralized finance tokens
`DeFAI Token`	DeFi + AI hybrid tokens
`DePIN Token`	Decentralized Physical Infrastructure tokens

Pass an empty string "" to return tokens across all categories.

Output Schema¶

{
  "message": "string",
  "data": {
    "total": 0,
    "contracts": [
      {
        "contractAddress": "string",
        "contractName": "string",
        "ticker": "string",
        "chain": "string",
        "category": "string",
        "type": "string",
        "communityRank": 0,
        "normalizedRank": 0,
        "totalHolders": 0,
        "lastProcessedAt": "ISO-8601",
        "createdAt": "ISO-8601",
        "updatedAt": "ISO-8601"
      }
    ]
  }
}

Key Fields¶

Field	Description
`communityRank`	Raw ranking based on aggregate behavioural quality of all token holders. Lower = stronger community.
`normalizedRank`	Normalized score for easier cross-chain and cross-category comparison
`totalHolders`	Total unique wallet addresses holding this token
`category`	Token category label — useful for filtering and sector comparisons

Code Examples¶

Node.js¶

const result = await client.callTool({
  name: "token_rank_list",
  arguments: {
    limit: "10",
    offset: "0",
    network: "ETH",
    sort_by: "communityRank",
    sort_order: "DESC",
    category: "AI Token",
    contract_name: ""
  }
});

console.log(`Total AI tokens on ETH: ${result.data.total}`);
result.data.contracts.forEach((token, i) => {
  console.log(
    `${i + 1}. ${token.contractName} (${token.ticker}) — ` +
    `Rank: ${token.communityRank}, Holders: ${token.totalHolders}`
  );
});

Python¶

result = await session.call_tool("token_rank_list", {
    "limit": "10",
    "offset": "0",
    "network": "ETH",
    "sort_by": "communityRank",
    "sort_order": "DESC",
    "category": "AI Token",
    "contract_name": ""
})

print(f"Total AI tokens on ETH: {result['data']['total']}")
for i, token in enumerate(result["data"]["contracts"]):
    print(
        f"{i+1}. {token['contractName']} ({token['ticker']}) — "
        f"Rank: {token['communityRank']}, Holders: {token['totalHolders']}"
    )

Example Agent Prompts¶

"What are the top AI tokens on Ethereum by community strength?"
"Rank DeFi tokens on BNB."
"Which RWA tokens have the strongest holder base?"
"Show me the top 10 DePIN tokens on Solana."
"Find the best DeFAI tokens right now."
"Search for tokens named 'Render' on Ethereum."
"Compare AI tokens across ETH and BASE by community rank."

Pagination¶

Use limit and offset together to page through results:

// Page 1 — first 10 results
{ limit: "10", offset: "0", ... }

// Page 2 — next 10 results
{ limit: "10", offset: "1", ... }

// Page 3
{ limit: "10", offset: "2", ... }

data.total gives the total number of matching tokens, so you can calculate the number of pages as Math.ceil(total / limit).

Use Cases¶

Token discovery — find the strongest tokens in any category based on holder quality, not hype or market cap
Due diligence — compare community strength before investing; weak holder bases signal fragility
Portfolio construction — weight portfolios toward tokens with high-quality, committed holders
DEX and aggregator curation — surface top-ranked tokens in category pages and search results
Research and analytics — track how token community quality evolves over time across chains
Marketing intelligence — identify which token communities attract the strongest wallets

Error Codes¶

Code	Meaning
`403`	Invalid or missing API key
`400`	Malformed `network`, `category`, or pagination parameters
`500`	Temporary backend failure — retry after a short delay

token_rank_single — deep-dive into a specific token: full rank details + top holder wallet intelligence
predictive_fraud — run fraud checks on a token's top holders to assess community risk