{"uid":"cap_csBiNzSkd628nm68IgQ_k","slug":"tzkt-token-balances-api-a128d621","name":"TzKT Token Balances API","description":"TzKT is a comprehensive Tezos blockchain indexer API. Access blocks, operations, accounts, contracts, bigmaps, delegates, tokens and network stats through a fast REST API. No signup or API key required.","url":"https://x402.tzkt.io/v1/tokens/balances","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"type":"string","description":"Sorting field and direction"},"limit":{"type":"integer","description":"Max items to return (1-10000)"},"offset":{"type":"integer","description":"Pagination offset"},"select":{"type":"string","description":"Comma-separated list of fields to return"},"account":{"type":"string","description":"Filter by account address"},"balance":{"type":"string","description":"Filter by balance (supports .eq .gt .lt)"},"contract":{"type":"string","description":"Filter by token contract address"},"token.tokenId":{"type":"string","description":"Filter by token ID"},"token.standard":{"enum":["fa1.2","fa2"],"type":"string","description":"Filter by token standard"}}},"responseSchema":{"type":"array","items":{"type":"object"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_t-fpkejoVkcIdCTog2S7k","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves Tezos token balances for accounts, filterable by contract, token ID, standard, and balance amount","exampleAgentPrompt":"Show me all FA2 token balances for the Tezos address tz1abc123... — return up to 50 results sorted by balance descending.","exampleUseCases":[{"title":"NFT portfolio lookup for Tezos wallet","prompt":"Pull all token balances for the Tezos wallet tz1VSUr8wwNhLAzempoch5d6hLRiTh8Cjcjb, limit to 100 results and sort by balance descending so I can see what NFTs and tokens they hold."},{"title":"Top token holders of a specific contract","prompt":"Give me the top 20 accounts holding tokens from the Tezos contract KT1RJ6PbjHpwc3M5rw5s2Nbmefwbuwbdxton with token ID 0, sorted by balance descending."},{"title":"DeFi balance audit above threshold","prompt":"Find all Tezos accounts with a balance greater than 1000 for the FA1.2 token at contract KT1K9gCRgaLRFKTErYL1F4HHwheelchair, limit 500 results."}],"resultDescription":"Returns an array of token balance objects, each containing the account address, token contract details (address, token ID, standard, metadata), and the current balance amount. Supports pagination and field selection for efficient data retrieval.","failureModes":["Invalid account address format returns empty array or 400 error","Unknown contract address returns empty results","Limit exceeding 10000 returns validation error","Invalid sort field name returns 400 error","Network congestion may cause slower response times","Malformed filter operators (e.g. balance comparisons) return 400"],"whenToPreferThis":"Use this endpoint when you need to query Tezos token holdings — FA1.2, FA2, or NFT balances — for one or more accounts without needing an API key. Prefer this over general Tezos RPC nodes when you need indexed, filterable, paginated token balance data rather than raw chain state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:55:36.227Z","isFirstParty":false}