Canonical: https://masterchain.ton.tx.taxi/docs/api/rest # REST API tx.taxi / TON explorer ## One search across chains. Paste a transaction, block or address into tx.taxi. Open a confirmed match, choose between possible networks, or head straight to your chain’s explorer. [Open tx.taxi ↗︎](https://tx.taxi/) [Explore TON →](/) [TON Guide](/docs/faq)[REST API](/docs/api/rest)[WebSocket API](/docs/api/websocket) ## Conventions ### Values and pagination All routes below use GET. Precision-sensitive integers are decimal strings; parse them with arbitrary-precision arithmetic. GRAM balances and fees are nanograms. Jetton amounts use their declared decimals. Paginated responses include `_paging`. Continue only while `hasMore` is true, using `nextOffset`, `nextBeforeLt` or `nextBefore` for the matching endpoint. List limits are capped at 100; block lists at 16. `_meta.observedAt` identifies the observation time and `_meta.stale` marks retained data. HTTP 400 means invalid input, 404 means not found, and 503 means temporarily unavailable. ## Network and blocks ### Network overview `GET /api/ton/dashboard` Returns the selected workchain and shard, recent blocks, observed history, observation time and stale state. The default is the basechain. Use `workchain=-1` for the masterchain, or `workchain=0&shard=...` for an active basechain shard. `activeShards` lists available shards; `masterchainHead` is the network masterchain head. ### Blocks `GET /api/ton/blocks?workchain=0&limit=8` Returns blocks from one workchain and shard in descending sequence order. The default is the basechain; use `workchain=-1` for masterchain blocks. Continue with `before=_paging.nextBefore` and retain `workchain` and `shard` from the response; the boundary is exclusive. Pagination stops at a shard split or merge. ### Block details `GET /api/ton/block/:id` Use a masterchain sequence number or the full `(workchain,shard,seqno)` identifier. Returns hashes, timestamps, logical times, references and value-flow fields. ### Block transactions `GET /api/ton/block/:id/transactions` Returns the transactions included in the specified block. ### Masterchain shard references `GET /api/ton/block/:id/shards` Use a masterchain sequence number or masterchain block identifier. Returns the corresponding shard references. ### Network transactions `GET /api/ton/network-transactions?limit=20` Returns transactions across the shards in one masterchain interval. Continue within that interval using `master_seqno=_paging.masterSeqno` and `offset=_paging.nextOffset`. When `nextOffset` is null, continue with `before=_paging.nextBefore` instead. Limits are capped at 50. ### Masterchain transactions `GET /api/ton/transactions` Returns transactions from one masterchain block. Continue with `before=_paging.nextBefore`. These are masterchain transactions, not all transactions across every shard. ### Validators `GET /api/ton/validators` Returns validator election information, stake amounts and validator entries. ### Domain details `GET /api/ton/dns/:domain` Domain identity, expiry and linked NFT. Append `/resolve` for wallet, site, storage and resolver records, or `/bids` for bid history. ### DNS auctions `GET /api/ton/dns/auctions?tld=ton` Current domain auctions. Select `ton` or `t.me`. ### Expiring domains `GET /api/ton/address/:address/dns-expiring` Returns domains approaching expiry. The optional `period` is the number of days before expiry. ### Staking pool `GET /api/ton/staking-pool/:address` Pool stake, nominators, cycle, implementation and annual percentage yield. Append `/history` for observed APY history. ### Extra currency `GET /api/ton/extra-currency/:id` Currency ID, symbol, decimals and image. ### Extra currency history `GET /api/ton/address/:address/extra-currency/:id/history?limit=24` Account events for the selected currency. Continue with `before_lt`. ### Block BOC `GET /api/ton/block/:id/boc` Downloads the block as a binary Bag of Cells. ### Raw configuration `GET /api/ton/config/raw` Raw network configuration. Add `master_seqno` to request a historical masterchain configuration. ### Blockchain configuration `GET /api/ton/config` Returns decoded blockchain configuration parameters. Add `master_seqno` for a historical masterchain configuration. ### GRAM exchange rates `GET /api/ton/rates` Returns GRAM rates in AUD, CAD, CHF, EUR, GBP, JPY and USD. ## Transactions and messages ### Transaction details `GET /api/ton/tx/:hash` Returns the account transaction, messages, fees, phases and state changes, plus available trace and interpreted event details. `relatedUnavailable` identifies related sections that could not be loaded. ### Transaction by message hash `GET /api/ton/message/:hash` Finds the transaction associated with the supplied message hash. ### Trace `GET /api/ton/trace/:hash` Returns the linked transaction tree with child traces and execution details. ### Resolve search input `GET /api/ton/resolve?value=:input` Resolves a TON account, NFT, collection, jetton, transaction, message hash, block identifier or .ton domain. Returns the entity type and identifier. ## Accounts and contracts ### Account details `GET /api/ton/address/:address` Returns balance, status, contract interfaces, available blockchain state and DNS names. State can include code, data, storage information and extra currencies. ### Account transactions `GET /api/ton/address/:address/transactions?limit=24` Lists account transactions. Continue with `before_lt=_paging.nextBeforeLt`; `after_lt` is also accepted. ### Account transfers and events `GET /api/ton/address/:address/events?limit=24` Returns interpreted actions and their statuses. Continue with `before_lt`. ### Jetton balances `GET /api/ton/address/:address/jettons` Returns balances with master-contract metadata and the account’s jetton-wallet addresses. ### Account NFTs `GET /api/ton/address/:address/nfts?limit=24&offset=0` Returns NFT items, including recognized indirect sale ownership by default. Filter with `collection`, or use `indirect_ownership=false` for direct ownership only. Continue with `offset=_paging.nextOffset`. ### NFT operations `GET /api/ton/address/:address/nft-history?limit=24` Returns the account’s NFT operations. Continue with `before_lt`. ### Jetton history `GET /api/ton/address/:address/jetton-history?limit=24` Returns jetton events for the account. Continue with `before_lt`. ### Contract inspection `GET /api/ton/address/:address/inspect` Returns available contract inspection details and recognized interfaces. ### Read a contract method `GET /api/ton/address/:address/methods/:name` Executes a read-only getter. Supply each argument as a repeated `args` parameter, for example `?args=123&args=456`. Arguments remain strings and may contain integer, address or BOC values accepted by the method. ### Staking pools `GET /api/ton/address/:address/staking` Returns the account’s nominator-pool positions. ### Multisig contract `GET /api/ton/address/:address/multisig` Returns the multisig contract’s threshold, signers, proposers, sequence number and orders. Use the plural route below to find multisigs associated with a signer’s wallet. ### Multisig records `GET /api/ton/address/:address/multisigs` Returns multisig records associated with the account. ### Subscriptions `GET /api/ton/address/:address/subscriptions` Returns the account’s subscription records. ### DeFi assets `GET /api/ton/address/:address/defi` Returns recognized DeFi positions and assets for the account. ## NFTs and jettons ### NFT item `GET /api/ton/nft/:address` Returns the item’s owner, collection, metadata, media previews, trust and sale fields. `indexVerified` indicates whether `index` was confirmed by `get_nft_data`; the original index remains in `indexed_index`. ### Soulbound NFT details `GET /api/ton/nft/:address/sbt` For a soulbound NFT, returns the authority address and revocation timestamp from its contract. A zero revocation timestamp means not revoked. Soulbound items are non-transferable. ### NFT history `GET /api/ton/nft/:address/history?limit=24` Returns events for an individual NFT. Continue with `before_lt`. ### Collection details `GET /api/ton/collection/:address` Returns the collection’s owner, content, metadata and previews. When `indexVerified` is true, `next_item_index` is confirmed by the collection getter; it is not necessarily a total item count. ### Collection items `GET /api/ton/collection/:address/items?limit=24&offset=0` Returns NFT items from a collection. Continue with `offset=_paging.nextOffset`. ### Jetton details `GET /api/ton/jetton/:address` Returns master-contract metadata, total supply, administration, decimals and holder count. ### Jetton holders `GET /api/ton/jetton/:address/holders?limit=24&offset=0` Returns holder entries under `addresses`. Continue with `offset=_paging.nextOffset`. Balance values use the jetton’s decimals. [About ton.tx.taxi](/about) · [Terms of Service](/terms-of-service) · [Privacy Policy](/privacy-policy) · [Brand attribution](/trademark-policy) · [TON Guide](/docs/faq) · [REST API](/docs/api/rest) · [WebSocket API](/docs/api/websocket)