{"uid":"cap_Y7mjgtsw7xogp9_fXjj7L","slug":"tzkt-balance-history-43ef6544","name":"TzKT Balance History","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/accounts/%7Baddress%7D/balance_history","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"type":"string","description":"Sorting direction"},"step":{"type":"integer","description":"Step size in blocks for sampling"},"limit":{"type":"integer","description":"Max items to return (1-10000)"},"quote":{"type":"string","description":"Quote currency for balance values"},"offset":{"type":"integer","description":"Pagination offset"}}},"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_z_n_rmUi4-H0B5_6pZnRo","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":"Returns the historical balance snapshots for a given Tezos account address over time, sampled at configurable block intervals.","exampleAgentPrompt":"Pull the balance history for Tezos account tz1VSUr8wwNhLAzempoch5d6hLRiTh8Cjcjb, sampled every 1000 blocks, showing the last 50 data points in descending order with balances quoted in USD.","exampleUseCases":[{"title":"Portfolio balance trend analysis","prompt":"Show me how the XTZ balance changed over time for wallet tz1gjaF81ZRRvdzjobyfVNsAeSC6PScjfQwN — give me 100 data points sampled every 500 blocks, sorted oldest to newest, with values quoted in USD."},{"title":"Whale wallet monitoring","prompt":"I want to see the historical balance snapshots for the Tezos address KT1TxqZ8QtKvLu3V3JH7Gx58n7Co4MCM2vXb, sampled every 2000 blocks, limit 200 records, in descending order so I see the most recent first."},{"title":"Audit trail for account activity","prompt":"Fetch the balance history for Tezos account tz1aRoaRhSpRYvFdyvgWLL6TGyRoGF51wDjM using a step of 100 blocks and return up to 500 entries — I need to reconstruct the balance changes for a compliance review."}],"resultDescription":"An array of objects, each representing a balance snapshot at a particular point in time (block level), including the account's balance and optionally the balance converted to a requested quote currency (e.g. USD, EUR, BTC). The array is ordered and paginated according to the sort, offset, and limit parameters supplied.","failureModes":["Invalid or non-existent Tezos address returns empty array or 400 error","Step value of 0 or negative integers cause a validation error","Limit exceeding 10000 returns a 400 bad request","Address format errors (wrong prefix or length) return 400","Payment failure via x402 returns 402 Payment Required, blocking data access","Offset beyond total records returns an empty array"],"whenToPreferThis":"Use this endpoint when you need time-series balance data for a specific Tezos account — ideal for charting portfolio growth, auditing balance changes, or monitoring large wallets over time. It is preferable over transaction-level endpoints when you want sampled snapshots rather than individual operation details. It suits analytics and visualization pipelines that need evenly spaced balance data points rather than raw operation logs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:53:01.851Z","isFirstParty":false}