{"uid":"cap_OHcA7B9IRNJSSmJhzBqAP","slug":"arkham-x402-token-balance-134e0ad4","name":"Arkham x402 Token Balance","description":"Get Arkham token balance by pricing ID or chain/address. $0.20 per call.","url":"https://api.arkm.com/x402/token/balance","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The CoinGecko pricing ID of the token."},"chain":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Blockchain network where the token is deployed."},"address":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Addresses to query the balance for, passed as a single comma-separated string, e.g. '0x28C6…,0x21a3…' (not a JSON array…"},"entityID":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Entity ID to query the balance for. Provide either entityID or address; if both are given, address takes precedence and…"}}},"responseSchema":{"type":"json","example":{"usd":0,"name":"USD Coin","price":0.99993,"symbol":"USDC","balance":0,"pricingID":"usd-coin"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rvYCqGbYkXLM9sUGvZVz4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the token balance, current price, and USD value for a specific crypto token in a wallet, billed per-request via x402.","exampleAgentPrompt":"What's the USDC balance of wallet address 0xAbC...123 right now, and what's it worth in USD?","exampleUseCases":[{"title":"Portfolio snapshot for a single wallet","prompt":"Can you check how much USDC and ETH are sitting in wallet 0xAbC...123 and tell me the current USD value of each?"},{"title":"DeFi treasury monitoring","prompt":"Pull the current USDC balance for our DAO treasury wallet 0xDef...456 — I need the token amount and its USD value right now."},{"title":"On-chain due diligence check","prompt":"Before we finalize this deal, can you look up the USDC balance on wallet 0x789...XYZ using Arkham and tell me exactly how much is there and what price USDC is trading at?"}],"resultDescription":"A JSON object containing the token's name, symbol, current USD price, raw balance amount, and total USD value for the queried wallet and token. Example: {\"usd\": 0, \"name\": \"USD Coin\", \"price\": 0.99993, \"symbol\": \"USDC\", \"balance\": 0, \"pricingID\": \"usd-coin\"}.","failureModes":["Invalid or malformed wallet address returns an error","Unsupported token symbol results in no data or error response","Insufficient x402 payment causes request to be rejected","Rate limiting if too many requests are made in quick succession","Network or RPC issues may cause stale or unavailable balance data"],"whenToPreferThis":"Use this endpoint when you need real-time, per-token balance data tied to Arkham's wallet intelligence layer, especially when you want both the raw on-chain balance and a USD-denominated valuation in one call. Prefer this over generic blockchain RPC queries when you need price data alongside balance, or when building pay-as-you-go agent workflows using x402 micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:32:06.075Z","isFirstParty":false}