{"uid":"cap_2ax-8nkVu2e-fzCBuzBXx","slug":"agents-allium-so-e65b7b5d","name":"Allium Wallet Token Balances","description":"Get current wallet token balances","url":"https://agents.allium.so/api/v1/developer/wallet/balances","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"type":"object","required":["chain","address"],"properties":{"chain":{"type":"string","description":"Blockchain network (e.g. ethereum, solana, base)"},"address":{"type":"string","description":"Wallet address"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"chain":"ethereum","token":{"info":{"name":"Wrapped Ether","symbol":"WETH"},"type":"evm_erc20","chain":"ethereum","price":2500.5,"object":"token","address":"0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2","decimals":18},"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","raw_balance":1500000000000000000,"block_number":20000000,"block_timestamp":"2025-06-17T18:00:00Z","raw_balance_str":"1500000000000000000"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_53h6azfjxr7EgnTGOB0BK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current token balances for a given blockchain wallet address","exampleAgentPrompt":"What tokens does wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 currently hold, and what are the balances for each?","exampleUseCases":null,"resultDescription":"A list of token balances for the specified wallet address, including token symbols, amounts, and likely USD-denominated values for each holding across supported chains.","failureModes":["Invalid or malformed wallet address returns an error","Unsupported chain returns no results or error","Wallet with no token holdings returns an empty list","Payment failure (x402) if USDC balance is insufficient","Rate limiting if too many requests are made"],"whenToPreferThis":"Use this endpoint when you need real-time, current token balances for a specific wallet address on supported blockchains. Prefer this over transaction history endpoints when you only need the current state of holdings, not historical activity. Best for portfolio snapshots, DeFi position checks, and balance verification tasks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:51:52.063Z","isFirstParty":false}