REST API

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.

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.

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.

Use a masterchain sequence number or the full (workchain,shard,seqno) identifier. Returns hashes, timestamps, logical times, references and value-flow fields.

Returns the transactions included in the specified block.

Use a masterchain sequence number or masterchain block identifier. Returns the corresponding shard references.

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.

Returns transactions from one masterchain block. Continue with before=_paging.nextBefore. These are masterchain transactions, not all transactions across every shard.

Returns validator election information, stake amounts and validator entries.

Domain identity, expiry and linked NFT. Append /resolve for wallet, site, storage and resolver records, or /bids for bid history.

Current domain auctions. Select ton or t.me.

Returns domains approaching expiry. The optional period is the number of days before expiry.

Pool stake, nominators, cycle, implementation and annual percentage yield. Append /history for observed APY history.

Currency ID, symbol, decimals and image.

Account events for the selected currency. Continue with before_lt.

Downloads the block as a binary Bag of Cells.

Raw network configuration. Add master_seqno to request a historical masterchain configuration.

Returns decoded blockchain configuration parameters. Add master_seqno for a historical masterchain configuration.

Returns GRAM rates in AUD, CAD, CHF, EUR, GBP, JPY and USD.

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.

Finds the transaction associated with the supplied message hash.

Returns the linked transaction tree with child traces and execution details.

Resolves a TON account, NFT, collection, jetton, transaction, message hash, block identifier or .ton domain. Returns the entity type and identifier.

Returns balance, status, contract interfaces, available blockchain state and DNS names. State can include code, data, storage information and extra currencies.

Lists account transactions. Continue with before_lt=_paging.nextBeforeLt; after_lt is also accepted.

Returns interpreted actions and their statuses. Continue with before_lt.

Returns balances with master-contract metadata and the account’s jetton-wallet addresses.

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.

Returns the account’s NFT operations. Continue with before_lt.

Returns jetton events for the account. Continue with before_lt.

Returns available contract inspection details and recognized interfaces.

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.

Returns the account’s nominator-pool positions.

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.

Returns multisig records associated with the account.

Returns the account’s subscription records.

Returns recognized DeFi positions and assets for the account.

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.

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.

Returns events for an individual NFT. Continue with before_lt.

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.

Returns NFT items from a collection. Continue with offset=_paging.nextOffset.

Returns master-contract metadata, total supply, administration, decimals and holder count.

Returns holder entries under addresses. Continue with offset=_paging.nextOffset. Balance values use the jetton’s decimals.