# TON Center

> Python SDK for TON Center — REST API and Streaming for TON blockchain.

## Docs

- [Detect Address](https://toncenter.ness.uz/api_v2/detect_address_get.md): Get all possible address forms
- [Detect Hash](https://toncenter.ness.uz/api_v2/detect_hash_get.md): Get all possible hash forms
- [Estimate Fee](https://toncenter.ness.uz/api_v2/estimate_fee_post.md): Estimate fee for query
- [Get Address Balance](https://toncenter.ness.uz/api_v2/get_address_balance_get.md): Get address balance in nanotons
- [Get Address Information](https://toncenter.ness.uz/api_v2/get_address_information_get.md): Get basic information about address
- [Get Address State](https://toncenter.ness.uz/api_v2/get_address_state_get.md): Get address state (active, uninitialized or frozen)
- [Get Block Header](https://toncenter.ness.uz/api_v2/get_block_header_get.md): Get block header information
- [Get Block Transactions Ext](https://toncenter.ness.uz/api_v2/get_block_transactions_ext_get.md): Get transactions in specified block with extended information
- [Get Block Transactions](https://toncenter.ness.uz/api_v2/get_block_transactions_get.md): Get transactions in specified block
- [Get Config All](https://toncenter.ness.uz/api_v2/get_config_all_get.md): Get all blockchain configuration parameters
- [Get Config Param](https://toncenter.ness.uz/api_v2/get_config_param_get.md): Get blockchain configuration parameter
- [Get Consensus Block](https://toncenter.ness.uz/api_v2/get_consensus_block_get.md): Get block that was confirmed by consensus
- [Get Extended Address Information](https://toncenter.ness.uz/api_v2/get_extended_address_information_get.md): Get extended information about address
- [Get Libraries](https://toncenter.ness.uz/api_v2/get_libraries_get.md): Get library code by their hashes
- [Get Masterchain Block Signatures](https://toncenter.ness.uz/api_v2/get_masterchain_block_signatures_get.md): Get signatures of validators for masterchain block
- [Get Masterchain Info](https://toncenter.ness.uz/api_v2/get_masterchain_info_get.md): Get up-to-date masterchain state
- [Get Out Msg Queue Size](https://toncenter.ness.uz/api_v2/get_out_msg_queue_size_get.md): Get size of outbound message queue
- [Get Shard Block Proof](https://toncenter.ness.uz/api_v2/get_shard_block_proof_get.md): Get merkle proof of shard block
- [Get Shards](https://toncenter.ness.uz/api_v2/get_shards_get.md): Get shards information by given masterchain block seqno
- [Get Token Data](https://toncenter.ness.uz/api_v2/get_token_data_get.md): Get Jetton/NFT metadata from token smart contract
- [Get Transactions](https://toncenter.ness.uz/api_v2/get_transactions_get.md): Get transactions for specified address
- [Get Transactions Std](https://toncenter.ness.uz/api_v2/get_transactions_std_get.md): Standardized version of getTransactions
- [Get Wallet Information](https://toncenter.ness.uz/api_v2/get_wallet_information_get.md): Get wallet-specific information about address
- [Json Rpc](https://toncenter.ness.uz/api_v2/json_rpc_post.md): Endpoint for JSON-RPC requests
- [Lookup Block](https://toncenter.ness.uz/api_v2/lookup_block_get.md): Look up block by seqno, shard and workchain
- [Pack Address](https://toncenter.ness.uz/api_v2/pack_address_get.md): Pack address to base64 form
- [Run Get Method](https://toncenter.ness.uz/api_v2/run_get_method_post.md): Run get method of smart contract
- [Run Get Method Std](https://toncenter.ness.uz/api_v2/run_get_method_std_post.md): Run get method of smart contract
- [Send Boc](https://toncenter.ness.uz/api_v2/send_boc_post.md): Send bag of cells to blockchain
- [Send Boc Return Hash](https://toncenter.ness.uz/api_v2/send_boc_return_hash_post.md): Send bag of cells to blockchain and return hash
- [Try Locate Result Tx](https://toncenter.ness.uz/api_v2/try_locate_result_tx_get.md): Same as previous. Try to locate outcoming transaction of destination address by incoming message
- [Try Locate Source Tx](https://toncenter.ness.uz/api_v2/try_locate_source_tx_get.md): Try to locate source transaction by destination transaction parameters
- [Try Locate Tx](https://toncenter.ness.uz/api_v2/try_locate_tx_get.md): Try to locate outcoming transaction of __destination__ address by incoming message
- [Unpack Address](https://toncenter.ness.uz/api_v2/unpack_address_get.md): Unpack address from base64 form
- [Get Account States](https://toncenter.ness.uz/api_v3/account_states_get.md): Query account states
- [Get Actions](https://toncenter.ness.uz/api_v3/actions_get.md): Get actions by specified filter.
- [Get Address Book](https://toncenter.ness.uz/api_v3/address_book_get.md): Query address book
- [Get Address Information](https://toncenter.ness.uz/api_v3/address_information_get.md): Get smart contract information.
- [Get Adjacent Transactions](https://toncenter.ness.uz/api_v3/adjacent_transactions_get.md): Get parent and/or children for specified transaction.
- [Get Blocks](https://toncenter.ness.uz/api_v3/blocks_get.md): Returns blocks by specified filters.
- [Get Decode](https://toncenter.ness.uz/api_v3/decode_get.md): Decode opcodes and message bodies. Opcodes can be in hex (with or without 0x prefix) or decimal format. Bodies should be in base64 or hex format.
- [Post Decode](https://toncenter.ness.uz/api_v3/decode_post.md): Decode opcodes and message bodies. Opcodes can be in hex (with or without 0x prefix) or decimal format. Bodies should be in base64 or hex format. Use POST method for long parameters that may be truncated in GET requests.
- [Get Dns Records](https://toncenter.ness.uz/api_v3/dns_records_get.md): Query DNS records by specified filters. Currently .ton and .t.me DNS are supported.
- [Estimate Fee](https://toncenter.ness.uz/api_v3/estimate_fee_post.md): Estimate fees required for query processing. Fields body, init-code and init-data accepted in serialized format (b64-encoded).
- [Get Jetton Burns](https://toncenter.ness.uz/api_v3/jetton_burns_get.md): Get Jetton burns by specified filters
- [Get Jetton Masters](https://toncenter.ness.uz/api_v3/jetton_masters_get.md): Get Jetton masters by specified filters
- [Get Jetton Transfers](https://toncenter.ness.uz/api_v3/jetton_transfers_get.md): Get Jetton transfers by specified filters
- [Get Jetton Wallets](https://toncenter.ness.uz/api_v3/jetton_wallets_get.md): Get Jetton wallets by specified filters
- [Get Masterchain Block Shard State](https://toncenter.ness.uz/api_v3/masterchain_block_shard_state_get.md): Get masterchain block shard state. Same as /api/v2/shards.
- [Get Masterchain Block Shards](https://toncenter.ness.uz/api_v3/masterchain_block_shards_get.md): Returns all worchain blocks, that appeared after previous masterchain block.
- [Get Masterchain Info](https://toncenter.ness.uz/api_v3/masterchain_info_get.md): Get first and last indexed block
- [Send Message](https://toncenter.ness.uz/api_v3/message_post.md): Send an external message to the TON network.
- [Get Messages](https://toncenter.ness.uz/api_v3/messages_get.md): Get messages by specified filters.
- [Get Metadata](https://toncenter.ness.uz/api_v3/metadata_get.md): Query address metadata
- [Get Multisig Orders](https://toncenter.ness.uz/api_v3/multisig_orders_get.md): Get multisig orders by specified filters
- [Get Multisig Wallets](https://toncenter.ness.uz/api_v3/multisig_wallets_get.md): Get multisig contracts by specified filters with associated orders
- [Get Nft Collections](https://toncenter.ness.uz/api_v3/nft_collections_get.md): Get NFT collections by specified filters
- [Get Nft Items](https://toncenter.ness.uz/api_v3/nft_items_get.md): Get NFT items by specified filters
- [Get Nft Sales](https://toncenter.ness.uz/api_v3/nft_sales_get.md): Get GetGems NFT sales and auctions by sale/auction contract addresses
- [Get Nft Transfers](https://toncenter.ness.uz/api_v3/nft_transfers_get.md): Get transfers of NFT items by specified filters
- [Get Pending Actions](https://toncenter.ness.uz/api_v3/pending_actions_get.md): Get actions by specified filter.
- [Get Pending Traces](https://toncenter.ness.uz/api_v3/pending_traces_get.md): Get traces by specified filter.
- [Get Pending Transactions](https://toncenter.ness.uz/api_v3/pending_transactions_get.md): Get pending transactions by specified filter.
- [Run Get Method](https://toncenter.ness.uz/api_v3/run_get_method_post.md): Run get method of smart contract. Stack supports only `num`, `cell` and `slice` types: ``` [ { "type": "num", "value": "0x12a" }, { "type": "cell", "value": "te6..." // base64 encoded boc with cell }, { "type": "slice", "value": "te6..." // base64 encoded boc with slice } ] ```
- [Get Top Accounts By Balance](https://toncenter.ness.uz/api_v3/top_accounts_by_balance_get.md): Get list of accounts sorted descending by balance.
- [Get Traces](https://toncenter.ness.uz/api_v3/traces_get.md): Get traces by specified filter.
- [Get Transactions By Masterchain Block](https://toncenter.ness.uz/api_v3/transactions_by_masterchain_block_get.md): Returns transactions from masterchain block and from all shards.
- [Get Transactions By Message](https://toncenter.ness.uz/api_v3/transactions_by_message_get.md): Get transactions whose inbound/outbound message has the specified hash. \
- [Get Transactions](https://toncenter.ness.uz/api_v3/transactions_get.md): Get transactions by specified filter.
- [Get Vesting Contracts](https://toncenter.ness.uz/api_v3/vesting_get.md): Get vesting contracts by specified filters
- [Get Wallet Information](https://toncenter.ness.uz/api_v3/wallet_information_get.md): Get wallet smart contract information. The following wallets are supported: `v1r1`, `v1r2`, `v1r3`, `v2r1`, `v2r2`, `v3r1`, `v3r2`, `v4r1`, `v4r2`, `v5beta`, `v5r1`. In case the account is not a wallet error code 409 is returned.
- [Get Wallet States](https://toncenter.ness.uz/api_v3/wallet_states_get.md): Query wallet information
- [AI Plugin](https://toncenter.ness.uz/claude-plugin.md): Claude Code plugin for TON Center
- [Errors](https://toncenter.ness.uz/errors.md): Exception hierarchy and HTTP error codes
- [Getting Started](https://toncenter.ness.uz/index.md): Python SDK for TON Center
- [Guide](https://toncenter.ness.uz/rest/guide.md): Client setup, sessions, retries, and key rotation
- [Overview](https://toncenter.ness.uz/rest/overview.md): Networks, V2 vs V3, and quick example
- [Guide](https://toncenter.ness.uz/streaming/guide.md): Client setup, handlers, finality, and reconnection
- [Overview](https://toncenter.ness.uz/streaming/overview.md): SSE and WebSocket subscriptions with automatic reconnection
- [Utilities](https://toncenter.ness.uz/utilities.md): Address conversion and amount formatting

## OpenAPI Specs

- [v3](https://toncenter.ness.uz/openapi/v3.yaml)
- [v2](https://toncenter.ness.uz/openapi/v2.yaml)
- [openapi](https://toncenter.ness.uz/api-reference/openapi.json)