get_token_balance
Check ERC-20 token balance for any wallet address across multiple blockchain networks. Retrieve token holdings by providing blockchain name, token contract address, and wallet address.
Instructions
Get ERC-20 token balance for an address
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blockchain | Yes | Blockchain name | |
| network | No | Network type (defaults to mainnet) | |
| tokenAddress | Yes | Token contract address | |
| walletAddress | Yes | Wallet address to check balance |
Implementation Reference
- src/handlers/token-handlers.ts:82-104 (handler)MCP tool handler execution logic for 'get_token_balance', parses arguments and delegates to AdvancedBlockchainService.getTokenBalancecase 'get_token_balance': { const blockchain = args?.blockchain as string; const tokenAddress = args?.tokenAddress as string; const walletAddress = args?.walletAddress as string; const network = (args?.network as 'mainnet' | 'testnet') || 'mainnet'; const result = await advancedBlockchain.getTokenBalance( blockchain, tokenAddress, walletAddress, network ); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], isError: !result.success, }; }
- src/handlers/token-handlers.ts:15-41 (schema)Tool schema definition including input validation for blockchain, tokenAddress, walletAddress{ name: 'get_token_balance', description: 'Get ERC-20 token balance for an address', inputSchema: { type: 'object', properties: { blockchain: { type: 'string', description: 'Blockchain name', }, tokenAddress: { type: 'string', description: 'Token contract address', }, walletAddress: { type: 'string', description: 'Wallet address to check balance', }, network: { type: 'string', enum: ['mainnet', 'testnet'], description: 'Network type (defaults to mainnet)', }, }, required: ['blockchain', 'tokenAddress', 'walletAddress'], }, },
- src/index.ts:88-101 (registration)Server-wide tool registration including registerTokenHandlers which adds 'get_token_balance' to the MCP server tools listconst tools: Tool[] = [ ...registerBlockchainHandlers(server, blockchainService), ...registerDomainHandlers(server, domainResolver), ...registerTransactionHandlers(server, advancedBlockchain), ...registerTokenHandlers(server, advancedBlockchain), ...registerMultichainHandlers(server, advancedBlockchain), ...registerContractHandlers(server, advancedBlockchain), ...registerUtilityHandlers(server, advancedBlockchain), ...registerEndpointHandlers(server, endpointManager), ...registerSolanaHandlers(server, solanaService), ...registerCosmosHandlers(server, cosmosService), ...registerSuiHandlers(server, suiService), ...registerDocsHandlers(server, docsManager), ];
- Core helper function implementing ERC-20 token balance query via eth_call to balanceOf methodasync getTokenBalance( blockchain: string, tokenAddress: string, walletAddress: string, network: 'mainnet' | 'testnet' = 'mainnet' ): Promise<EndpointResponse> { const service = this.blockchainService.getServiceByBlockchain(blockchain, network); if (!service) { return { success: false, error: `Blockchain service not found: ${blockchain} (${network})`, }; } // Encode balanceOf(address) call const paddedAddress = walletAddress.replace('0x', '').padStart(64, '0'); const data = AdvancedBlockchainService.ERC20_BALANCE_OF + paddedAddress; const result = await this.blockchainService.callRPCMethod( service.id, 'eth_call', [ { to: tokenAddress, data: data, }, 'latest', ] ); if (result.success && result.data) { // Convert hex to decimal const balance = BigInt(result.data).toString(); return { success: true, data: { balance, balanceHex: result.data, }, metadata: result.metadata, }; } return result; }