# TonCenter v3

TON API is available on [Web3 API platform](https://crypto-chief.com/rpc/ton/).

TonCenter v3 is an indexed HTTP API built on top of a PostgreSQL database. It collects data from a TON full node, decodes it, and exposes it through a REST interface optimized for historical queries, traces, decoded Jettons and NFTs, DNS records, multisig wallets, vesting contracts, and analytical lookups.

Endpoints support flexible filtering, sorting by logical time or UTC timestamp, and offset-based pagination via `limit` and `offset` parameters. Every list response is accompanied by an `address_book` map with the user-friendly form, on-chain domain, and detected interfaces for each referenced address, and a `metadata` map with token info.

For sending transactions and running get-methods, v3 re-exposes the relevant v2 methods at the same paths.

***

### Methods supported

**Accounts**

* [`accountStates`](#accountstates) — retrieves account states for a list of addresses.
* [`addressBook`](#addressbook) — retrieves user-friendly forms, domains, and interfaces for a list of addresses.
* [`metadata`](#metadata) — retrieves indexed metadata for a list of addresses.
* [`walletStates`](#walletstates) — retrieves wallet states for a list of addresses.

**Blockchain**

* [`masterchainInfo`](#masterchaininfo) — retrieves the first and last indexed masterchain block.
* [`masterchainBlockShardState`](#masterchainblockshardstate) — retrieves the shard state for a given masterchain block seqno.
* [`masterchainBlockShards`](#masterchainblockshards) — retrieves all workchain blocks that appeared after the previous masterchain block.
* [`blocks`](#blocks) — retrieves blocks by specified filters.
* [`transactions`](#transactions) — retrieves transactions by specified filters.
* [`transactionsByMasterchainBlock`](#transactionsbymasterchainblock) — retrieves transactions from a masterchain block and all its shards.
* [`transactionsByMessage`](#transactionsbymessage) — retrieves transactions whose inbound or outbound message has the specified hash.
* [`adjacentTransactions`](#adjacenttransactions) — retrieves parent and/or child transactions of a given transaction.
* [`pendingTransactions`](#pendingtransactions) — retrieves pending transactions by specified filter.
* [`messages`](#messages) — retrieves messages by specified filters.

**Actions & Traces**

* [`traces`](#traces) — retrieves traces by specified filter.
* [`pendingTraces`](#pendingtraces) — retrieves pending traces by specified filter.
* [`actions`](#actions) — retrieves actions by specified filter.
* [`pendingActions`](#pendingactions) — retrieves pending actions by specified filter.

**Jettons**

* [`jetton/masters`](#jettonmasters) — retrieves Jetton masters by specified filters.
* [`jetton/wallets`](#jettonwallets) — retrieves Jetton wallets by specified filters.
* [`jetton/transfers`](#jettontransfers) — retrieves Jetton transfers by specified filters.
* [`jetton/burns`](#jettonburns) — retrieves Jetton burns by specified filters.

**NFTs**

* [`nft/collections`](#nftcollections) — retrieves NFT collections by specified filters.
* [`nft/items`](#nftitems) — retrieves NFT items by specified filters.
* [`nft/transfers`](#nfttransfers) — retrieves NFT transfers by specified filters.
* [`nft/sales`](#nftsales) — retrieves GetGems NFT sales and auctions by sale or auction contract address.

**DNS**

* [`dns/records`](#dnsrecords) — retrieves DNS records by specified filters.

**Multisig**

* [`multisig/wallets`](#multisigwallets) — retrieves multisig contracts by specified filters with associated orders.
* [`multisig/orders`](#multisigorders) — retrieves multisig orders by specified filters.

**Vesting**

* [`vesting`](#vesting) — retrieves vesting contracts by specified filters.

**Stats**

* [`topAccountsByBalance`](#topaccountsbybalance) — retrieves the list of accounts sorted descending by balance.

**Utilities**

* [`decode`](#decode) — decodes opcodes and message bodies.

**v2 compatibility**

* [`addressInformation`](#addressinformation) — retrieves smart contract information (v2-compatible).
* [`walletInformation`](#walletinformation) — retrieves wallet smart contract information (v2-compatible).
* [`runGetMethod`](#rungetmethod) — runs a get method of a smart contract.
* [`estimateFee`](#estimatefee) — estimates the fee required to process a query.
* [`message`](#message) — sends an external message to the TON network.

***

### `accountStates`

> Retrieves account states for a list of addresses.

Returns indexed account snapshots — status, balance, code/data hashes, last transaction, detected interfaces — for up to 1000 addresses at once.

#### Parameters

* `address` (array of strings; required): list of addresses in any form. Maximum 1000.
* `include_boc` (boolean; optional): include code and data BoCs in the response (default: `true`).

#### Returns

* `accounts`: array of account state objects (`address`, `account_state_hash`, `balance`, `status`, `last_transaction_hash`, `last_transaction_lt`, `data_hash`, `code_hash`, `contract_methods`, `interfaces`).
* `address_book`: map of user-friendly address forms, domains, and interfaces for every referenced address.
* `metadata`: map of indexed metadata per address.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/accountStates?address=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2&include_boc=false'
```

#### Response example

```json
{
    "accounts": [
        {
            "address": "0:ED1691307050047117B998B561D8DE82D31FBF84910CED6EB5FC92E7485EF8A7",
            "account_state_hash": "veni2Q8Bqd381VBCbGFWkRvR/x28n8sLRJ9PR5CeIwc=",
            "balance": "1277485861704527743",
            "extra_currencies": {},
            "status": "active",
            "last_transaction_hash": "MjpKVwMq6j5s4jLASmyzowATm6a/2BGZIipAxT+6mRM=",
            "last_transaction_lt": "78756620000015",
            "data_hash": "HpgtycjQc73Ff8WSKNazRBi+AJNzTd/PHboF/0jl/wM=",
            "code_hash": "gwyZpEfQl0222G7X2J/k8tLsIjWMtkKH4tMeVj695Uc=",
            "contract_methods": [0, 73490, 105200, 120881, 130076],
            "interfaces": ["locker"]
        }
    ],
    "address_book": {
        "0:ED1691307050047117B998B561D8DE82D31FBF84910CED6EB5FC92E7485EF8A7": {
            "user_friendly": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
            "domain": "crypto-flipper.ton",
            "interfaces": ["locker"]
        }
    },
    "metadata": {}
}
```

***

### `addressBook`

> Retrieves user-friendly forms, domains, and interfaces for a list of addresses.

Lightweight lookup that returns only the address book entries without the full account states.

#### Parameters

* `address` (array of strings; required): list of addresses in any form. Maximum 1024.

#### Returns

* Map keyed by raw address, each value containing `user_friendly`, `domain`, and `interfaces`.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/addressBook?address=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2'
```

#### Response example

```json
{
    "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2": {
        "user_friendly": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
        "domain": "crypto-flipper.ton",
        "interfaces": ["locker"]
    }
}
```

***

### `metadata`

> Retrieves indexed metadata for a list of addresses.

Returns whether the address has been indexed and any token info (e.g. Jetton master, Jetton wallet, NFT item) attached to it.

#### Parameters

* `address` (array of strings; required): list of addresses in any form. Maximum 1024.

#### Returns

* Map keyed by raw address, each value containing `is_indexed` and `token_info`.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/metadata?address=EQB-MPwrd1G6WKNkLz_VnV6WqBDd142KMQv-g1O-8QUA3728'
```

#### Response example

```json
{
    "0:7E30FC2B7751BA58A3642F3FD59D5E96A810DDD78D8A310BFE8353BEF1050037": {
        "is_indexed": true,
        "token_info": [
            {
                "valid": true,
                "type": "jetton_masters",
                "extra": {
                    "name": "USD₮",
                    "symbol": "USDT",
                    "decimals": "6"
                }
            }
        ]
    }
}
```

***

### `walletStates`

> Retrieves wallet states for a list of addresses.

Returns a compact wallet-oriented view (balance, status, code hash, last transaction) for up to 1000 addresses, plus address book and metadata maps.

#### Parameters

* `address` (array of strings; required): list of addresses in any form. Maximum 1000.

#### Returns

* `wallets`: array of `{ address, is_wallet, balance, status, code_hash, last_transaction_hash, last_transaction_lt }`.
* `address_book`: map of user-friendly forms.
* `metadata`: map of indexed metadata.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/walletStates?address=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2'
```

#### Response example

```json
{
    "wallets": [
        {
            "address": "0:ED1691307050047117B998B561D8DE82D31FBF84910CED6EB5FC92E7485EF8A7",
            "is_wallet": false,
            "balance": "1277485861704527743",
            "status": "active",
            "code_hash": "gwyZpEfQl0222G7X2J/k8tLsIjWMtkKH4tMeVj695Uc=",
            "last_transaction_hash": "MjpKVwMq6j5s4jLASmyzowATm6a/2BGZIipAxT+6mRM=",
            "last_transaction_lt": "78756620000015"
        }
    ],
    "address_book": {
        "0:ED1691307050047117B998B561D8DE82D31FBF84910CED6EB5FC92E7485EF8A7": {
            "user_friendly": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
            "domain": "crypto-flipper.ton",
            "interfaces": ["locker"]
        }
    },
    "metadata": {}
}
```

***

### `masterchainInfo`

> Retrieves the first and last indexed masterchain block.

#### Parameters

None.

#### Returns

* `first`: full block ID of the first indexed masterchain block.
* `last`: full block ID of the last indexed masterchain block.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/masterchainInfo'
```

#### Response example

```json
{
    "last": {
        "workchain": -1,
        "shard": "8000000000000000",
        "seqno": 68943095,
        "root_hash": "eFHdksdiccLBwqGj24XEnWwcYTtgJ3jLwnVlBcOexxs=",
        "file_hash": "/1y1fOsfdGJ71aXdMUcruKw0GAkFdyDKFrBp/9sQguk=",
        "global_id": -239,
        "version": 0,
        "gen_utime": "1779670044",
        "start_lt": "79219815000000",
        "end_lt": "79219815000004",
        "tx_count": 3
    },
    "first": {
        "workchain": -1,
        "shard": "8000000000000000",
        "seqno": 1,
        "root_hash": "8GYhhrigd8CwZGrRT59iulLDcgiTYuvOAzFJxugc0Ts=",
        "file_hash": "V+XzykEwun4yePZhAEPZk77RbMfMOgS/S4GiJkSKY6s=",
        "global_id": -239,
        "version": 0,
        "gen_utime": "1573822385",
        "start_lt": "1000000",
        "end_lt": "1000012",
        "tx_count": 9
    }
}
```

***

### `masterchainBlockShardState`

> Retrieves the shard state for a given masterchain block seqno.

Equivalent to v2's `/getShards`. Returns the masterchain block and its shard blocks.

#### Parameters

* `seqno` (integer; required): masterchain block seqno.

#### Returns

* `blocks`: array of block objects (the masterchain block and all referenced shard blocks).

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/masterchainBlockShardState?seqno=68944876'
```

#### Response example

```json
{
    "blocks": [
        {
            "workchain": -1,
            "shard": "8000000000000000",
            "seqno": 68944876,
            "root_hash": "qk+BO5Pst47D+RCKopd2H9oZJAILtt8Uq5LbKlfoqro=",
            "file_hash": "UaC6aEsFQJ7yN3HdfVE6zkg8DISpZxZvs3yLfxP58hw=",
            "global_id": -239,
            "gen_utime": "1779670771",
            "start_lt": "79221662000000",
            "end_lt": "79221662000004",
            "tx_count": 3
        }
    ]
}
```

***

### `masterchainBlockShards`

> Retrieves all workchain blocks that appeared after the previous masterchain block.

Returns the new shard blocks finalized in the requested masterchain block — useful for streaming consumers tracking shard progression.

#### Parameters

* `seqno` (integer; required): masterchain block seqno.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.

#### Returns

* `blocks`: array of block objects (new shard blocks).

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/masterchainBlockShards?seqno=68944876&limit=2'
```

#### Response example

```json
{
    "blocks": [
        {
            "workchain": -1,
            "shard": "8000000000000000",
            "seqno": 68944876,
            "root_hash": "qk+BO5Pst47D+RCKopd2H9oZJAILtt8Uq5LbKlfoqro=",
            "file_hash": "UaC6aEsFQJ7yN3HdfVE6zkg8DISpZxZvs3yLfxP58hw=",
            "global_id": -239,
            "gen_utime": "1779670771",
            "tx_count": 3
        },
        {
            "workchain": 0,
            "shard": "8000000000000000",
            "seqno": 73809083,
            "root_hash": "DqeO1zGLrVgQLIDpG8PBszEpkadr0j95hbhp8YeYyI4=",
            "file_hash": "pPk4/zOvdZAJqBh+DDEdPLXGs8nhpGUV0UaaYpr9X8w=",
            "global_id": -239
        }
    ]
}
```

***

### `blocks`

> Retrieves blocks by specified filters.

Lets you query indexed blocks by location (`workchain`, `shard`, `seqno`), by content hashes (`root_hash`, `file_hash`), by reference (`mc_seqno`), or by time range (`start_utime`, `end_utime`, `start_lt`, `end_lt`).

#### Parameters

* `workchain` (integer; optional): block workchain.
* `shard` (string; optional): block shard ID. Must be sent with `workchain`. Example: `8000000000000000`.
* `seqno` (integer; optional): block seqno. Must be sent with `workchain` and `shard`.
* `root_hash` (string; optional): block root hash.
* `file_hash` (string; optional): block file hash.
* `mc_seqno` (integer; optional): masterchain block seqno.
* `start_utime` (integer; optional): query blocks with `gen_utime >= start_utime`.
* `end_utime` (integer; optional): query blocks with `gen_utime <= end_utime`.
* `start_lt` (integer; optional): query blocks with `lt >= start_lt`.
* `end_lt` (integer; optional): query blocks with `lt <= end_lt`.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.
* `sort` (string; optional): sort by UTC timestamp, `asc` or `desc`.

#### Returns

* `blocks`: array of block objects.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/blocks?limit=1'
```

#### Response example

```json
{
    "blocks": [
        {
            "workchain": 0,
            "shard": "2000000000000000",
            "seqno": 91,
            "root_hash": "8Pen47XctoGyWCtuDa0DHb01yzEDjxgn4uesTNDZQxA=",
            "file_hash": "RK39ilWyq2qRPN0YyBxnDeciMy0HVnL9ZHRYLsYwW1s=",
            "global_id": -239,
            "version": 0,
            "gen_utime": "1573822660",
            "start_lt": "101000000",
            "end_lt": "101000001",
            "tx_count": 0,
            "masterchain_block_ref": {
                "workchain": -1,
                "shard": "8000000000000000",
                "seqno": 95
            },
            "prev_blocks": [
                { "workchain": 0, "shard": "2000000000000000", "seqno": 90 }
            ]
        }
    ]
}
```

***

### `transactions`

> Retrieves transactions by specified filters.

The primary endpoint for querying indexed transactions across any combination of account, block location, hash, logical time, or UTC timestamp range.

#### Parameters

* `workchain` (integer; optional): block workchain.
* `shard` (string; optional): block shard ID. Must be sent with `workchain`.
* `seqno` (integer; optional): block seqno. Must be sent with `workchain` and `shard`.
* `mc_seqno` (integer; optional): masterchain block seqno.
* `account` (array of strings; optional): list of account addresses.
* `exclude_account` (array of strings; optional): exclude transactions on specified accounts.
* `hash` (string; optional): transaction hash.
* `lt` (string; optional): transaction logical time.
* `start_utime` (integer; optional): query transactions with `now >= start_utime`.
* `end_utime` (integer; optional): query transactions with `now <= end_utime`.
* `start_lt` (integer; optional): query transactions with `lt >= start_lt`.
* `end_lt` (integer; optional): query transactions with `lt <= end_lt`.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.
* `sort` (string; optional): sort by lt, `asc` or `desc`.

#### Returns

* `transactions`: array of transaction objects (`account`, `hash`, `lt`, `now`, `mc_block_seqno`, `trace_id`, `orig_status`, `end_status`, `total_fees`, `description`, `block_ref`, `in_msg`, `out_msgs`, `account_state_before`, `account_state_after`).
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/transactions?limit=1'
```

#### Response example

```json
{
    "transactions": [
        {
            "account": "-1:5555555555555555555555555555555555555555555555555555555555555555",
            "hash": "KrcmEDfVLc1tfBUcmRy9Jji6g+WwcvVLHmMigTSROlA=",
            "lt": "79221528000003",
            "now": 1779670718,
            "mc_block_seqno": 68944747,
            "trace_id": "KrcmEDfVLc1tfBUcmRy9Jji6g+WwcvVLHmMigTSROlA=",
            "prev_trans_hash": "zC0AeLTXS/xUz6mfo7h/UKZ+2VRSSvmBthv6lpTnarM=",
            "prev_trans_lt": "79221527000003",
            "orig_status": "active",
            "end_status": "active",
            "total_fees": "0",
            "description": {
                "type": "tick_tock",
                "aborted": false,
                "compute_ph": {
                    "success": true,
                    "gas_fees": "2487",
                    "exit_code": 0,
                    "vm_steps": 46
                }
            },
            "block_ref": {
                "workchain": -1,
                "shard": "8000000000000000",
                "seqno": 68944747
            },
            "in_msg": null,
            "out_msgs": []
        }
    ],
    "address_book": {
        "-1:5555555555555555555555555555555555555555555555555555555555555555": {
            "user_friendly": "Ef9VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVbxn",
            "interfaces": ["wallet_v1r2", "wallet_v2r1", "wallet_v3r1", "wallet_v5_beta"]
        }
    }
}
```

***

### `transactionsByMasterchainBlock`

> Retrieves transactions from a masterchain block and all its shards.

#### Parameters

* `seqno` (integer; required): masterchain block seqno.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.
* `sort` (string; optional): sort by lt, `asc` or `desc`.

#### Returns

* `transactions`: array of transaction objects.
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/transactionsByMasterchainBlock?seqno=68944876&limit=1'
```

#### Response example

```json
{
    "transactions": [
        {
            "account": "-1:5555555555555555555555555555555555555555555555555555555555555555",
            "hash": "RpvCkxFTMj8akAuU/x/bELt9BlIc3FfT/NHj4xQ9sZ0=",
            "lt": "79221662000003",
            "now": 1779670771,
            "mc_block_seqno": 68944876,
            "trace_id": "RpvCkxFTMj8akAuU/x/bELt9BlIc3FfT/NHj4xQ9sZ0=",
            "orig_status": "active",
            "end_status": "active",
            "total_fees": "0",
            "description": {
                "type": "tick_tock",
                "compute_ph": { "success": true, "gas_fees": "2487", "exit_code": 0 }
            }
        }
    ]
}
```

***

### `transactionsByMessage`

> Retrieves transactions whose inbound or outbound message has the specified hash.

Useful for following a single message across the source and destination accounts.

#### Parameters

* `msg_hash` (string; optional): message hash in hex, base64, or base64url form.
* `body_hash` (string; optional): hash of the message body.
* `opcode` (string; optional): message opcode in hex or signed 32-bit decimal form.
* `direction` (string; optional): direction of message: `in` or `out`.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.

#### Returns

* `transactions`: array of transaction objects.
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/transactionsByMessage?msg_hash=xzyhgoOLEyLidSGDI1bbOpdlJhL9N5xH67V3rkaJOKE%3D'
```

#### Response example

```json
{
    "transactions": [
        {
            "account": "0:ED1691307050047117B998B561D8DE82D31FBF84910CED6EB5FC92E7485EF8A7",
            "hash": "MjpKVwMq6j5s4jLASmyzowATm6a/2BGZIipAxT+6mRM=",
            "lt": "78756620000015",
            "now": 1779485898,
            "total_fees": "209238"
        }
    ],
    "address_book": {}
}
```

***

### `adjacentTransactions`

> Retrieves parent and/or child transactions of a given transaction.

Given a transaction hash, returns the transactions immediately above and/or below it in the trace tree — useful for navigating message cascades.

#### Parameters

* `hash` (string; required): transaction hash.
* `direction` (string; optional): direction: `in`, `out`, or `both`.

#### Returns

* `transactions`: array of adjacent transactions.
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/adjacentTransactions?hash=KrcmEDfVLc1tfBUcmRy9Jji6g%2BWwcvVLHmMigTSROlA%3D&direction=both'
```

#### Response example

```json
{
    "transactions": [
        {
            "account": "0:6F2346852E7C3641B6608CC3C22D176D447C615328A742E760EAC762A2123083",
            "hash": "1nQsRhTxQ5g4cqUv4ZqyP8X1tF3GbHmJ0kLpW6vRmYU=",
            "lt": "79221527500001",
            "now": 1779670716,
            "total_fees": "190000"
        }
    ],
    "address_book": {}
}
```

***

### `pendingTransactions`

> Retrieves pending transactions by specified filter.

Returns transactions that have been observed by the indexer but are not yet finalized in a committed block.

#### Parameters

* `account` (array of strings; optional): list of account addresses.
* `trace_id` (string; optional): find pending transactions by trace ID.

#### Returns

* `transactions`: array of pending transaction objects.
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/pendingTransactions?account=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2'
```

#### Response example

```json
{
    "transactions": [],
    "address_book": {}
}
```

***

### `messages`

> Retrieves messages by specified filters.

Lets you query indexed messages by hash, body hash, opcode, sender, destination, direction, or time range. Includes decoded message content where the opcode is known.

#### Parameters

* `msg_hash` (string; optional): message hash in hex, base64, or base64url form.
* `body_hash` (string; optional): hash of the message body.
* `source` (string; optional): source account address. Use `null` to filter for external messages.
* `destination` (string; optional): destination account address. Use `null` to filter for log messages.
* `opcode` (string; optional): opcode in hex or signed 32-bit decimal form.
* `start_utime` (integer; optional): query messages with `created_at >= start_utime`.
* `end_utime` (integer; optional): query messages with `created_at <= end_utime`.
* `start_lt` (integer; optional): query messages with `created_lt >= start_lt`.
* `end_lt` (integer; optional): query messages with `created_lt <= end_lt`.
* `direction` (string; optional): direction: `in` or `out`.
* `exclude_externals` (boolean; optional): exclude external messages.
* `only_externals` (boolean; optional): return only external messages.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.
* `sort` (string; optional): sort by lt, `asc` or `desc`. With `desc`, set `start_lt=1` to retrieve the latest messages.

#### Returns

* `messages`: array of message objects (`hash`, `source`, `destination`, `value`, `fwd_fee`, `ihr_fee`, `created_lt`, `created_at`, `opcode`, `decoded_opcode`, `message_content` with `body` and decoded payload).
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/messages?limit=1'
```

#### Response example

```json
{
    "messages": [
        {
            "hash": "zZZZzYdjQFuU4PL8ArWy3NH4rc6wF7SXY6u2zwQRIjM=",
            "source": null,
            "destination": "0:634E899A60747E25A6F6B5F30B76A6C553DA2592964628479A5FB35136DBF502",
            "value": null,
            "fwd_fee": null,
            "ihr_fee": null,
            "created_lt": null,
            "created_at": null,
            "opcode": "0x7369676e",
            "decoded_opcode": "w5_external_signed_request",
            "import_fee": "0",
            "in_msg_tx_hash": "dIM8u2aMNELrF3POmxQG7Jcd4SS7pUowRlmWJxuTqzM=",
            "message_content": {
                "hash": "C0Cy4+BQc0xQ8n2bPNuTxjcrp8efVyM4AyFGA2vSRvQ=",
                "body": "te6cckEBBAEAlQABoXNpZ25///8RZzX3SgAAABKAYdamQOQS1F9V07xGA3/vdu4JGN/R9+/VhYAjTucfHcPG937i0IdtkwIGYOPPHH2vQqlonzFafLyQIgoU7VWA4AECCg7DyG2CAgMAAABoQgA4..."
            }
        }
    ]
}
```

***

### `traces`

> Retrieves traces by specified filter.

A trace is the full causal tree of transactions produced by a single external message — the canonical way to follow a multi-hop interaction across contracts.

#### Parameters

* `account` (array of strings; optional): list of account addresses.
* `trace_id` (string; optional): find trace by trace ID.
* `tx_hash` (string; optional): find trace by transaction hash.
* `msg_hash` (string; optional): find trace by message hash.
* `mc_seqno` (integer; optional): query traces completed in a masterchain block with the given seqno.
* `start_utime` (integer; optional): query traces finished after the given timestamp.
* `end_utime` (integer; optional): query traces finished before the given timestamp.
* `start_lt` (integer; optional): query traces with `end_lt >= start_lt`.
* `end_lt` (integer; optional): query traces with `end_lt <= end_lt`.
* `include_actions` (boolean; optional): include trace actions in the response.
* `supported_action_types` (array of strings; optional): which action types the client supports.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.
* `sort` (string; optional): sort by lt, `asc` or `desc`.

#### Returns

* `traces`: array of trace objects (`trace_id`, `start_lt`, `end_lt`, `trace_info`, `trace` tree, `transactions_order`, `transactions` map).

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/traces?limit=1&include_actions=false'
```

#### Response example

```json
{
    "traces": [
        {
            "trace_id": "+NwbZaUsaexH5J/wr9rv7nzYDUbpDdO2o5aMbHRZt08=",
            "external_hash": null,
            "mc_seqno_start": "68944871",
            "mc_seqno_end": "68944871",
            "start_lt": "79221657000003",
            "start_utime": 1779670769,
            "end_lt": "79221657000003",
            "end_utime": 1779670769,
            "trace_info": {
                "trace_state": "complete",
                "messages": 0,
                "transactions": 1,
                "pending_messages": 0
            },
            "is_incomplete": false,
            "trace": {
                "tx_hash": "+NwbZaUsaexH5J/wr9rv7nzYDUbpDdO2o5aMbHRZt08=",
                "children": []
            },
            "transactions_order": ["+NwbZaUsaexH5J/wr9rv7nzYDUbpDdO2o5aMbHRZt08="]
        }
    ]
}
```

***

### `pendingTraces`

> Retrieves pending traces by specified filter.

Returns traces that have been observed by the indexer but are not yet finalized in committed blocks.

#### Parameters

* `account` (array of strings; optional): list of account addresses.
* `ext_msg_hash` (string; optional): find trace by external message hash.

#### Returns

* `traces`: array of pending trace objects.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/pendingTraces?account=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2'
```

#### Response example

```json
{
    "traces": []
}
```

***

### `actions`

> Retrieves actions by specified filter.

Actions are decoded high-level events extracted from traces (e.g. `ton_transfer`, `jetton_transfer`, `nft_transfer`, `stake_deposit`). They are easier to consume than raw transactions when building activity feeds or wallets.

#### Parameters

* `account` (array of strings; optional): list of account addresses.
* `tx_hash` (string; optional): find actions by transaction hash.
* `msg_hash` (string; optional): find actions by message hash.
* `action_id` (string; optional): find actions by action ID.
* `trace_id` (string; optional): find actions by trace ID.
* `mc_seqno` (integer; optional): query actions of traces completed in a masterchain block with the given seqno.
* `start_utime` (integer; optional): query actions with `trace_end_utime >= start_utime`.
* `end_utime` (integer; optional): query actions with `trace_end_utime <= end_utime`.
* `start_lt` (integer; optional): query actions with `trace_end_lt >= start_lt`.
* `end_lt` (integer; optional): query actions with `trace_end_lt <= end_lt`.
* `action_type` (array of strings; optional): include only these action types.
* `exclude_action_type` (array of strings; optional): exclude these action types.
* `supported_action_types` (array of strings; optional): which action types the client supports.
* `include_accounts` (boolean; optional): include accounts array for each action.
* `include_transactions` (boolean; optional): include `transactions_full` array with detailed transaction data.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.
* `sort` (string; optional): sort by lt, `asc` or `desc`.

#### Returns

* `actions`: array of action objects (`trace_id`, `action_id`, `start_lt`, `end_lt`, `start_utime`, `end_utime`, `transactions`, `success`, `type`, `details`).
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/actions?limit=1'
```

#### Response example

```json
{
    "actions": [
        {
            "trace_id": "F44U/WpKawdPN0KkZFd0zJLFGgdc/YdRDh/Ce/kLMWQ=",
            "action_id": "0ZZrci3V8kA98OKBe1wcCBbZJD+Y/mndAYti5Bwya6Y=",
            "start_lt": "79221662000000",
            "end_lt": "79221662000002",
            "start_utime": 1779670771,
            "end_utime": 1779670771,
            "trace_end_lt": "79221662000002",
            "trace_end_utime": 1779670771,
            "transactions": ["F44U/WpKawdPN0KkZFd0zJLFGgdc/YdRDh/Ce/kLMWQ="],
            "success": true,
            "type": "ton_transfer",
            "details": {
                "source": "-1:0000000000000000000000000000000000000000000000000000000000000000",
                "destination": "-1:3333333333333333333333333333333333333333333333333333333333333333",
                "value": "2700256173",
                "comment": null,
                "encrypted": false
            },
            "finality": "finalized"
        }
    ],
    "address_book": {
        "-1:3333333333333333333333333333333333333333333333333333333333333333": {
            "user_friendly": "Ef8zMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzMzM0vF",
            "interfaces": null
        }
    }
}
```

***

### `pendingActions`

> Retrieves pending actions by specified filter.

Returns decoded actions extracted from pending (not yet finalized) traces.

#### Parameters

* `account` (array of strings; optional): list of account addresses.
* `ext_msg_hash` (string; optional): find actions by external trace hash.
* `supported_action_types` (array of strings; optional): which action types the client supports.
* `include_transactions` (boolean; optional): include `transactions_full` array with detailed transaction data.

#### Returns

* `actions`: array of pending action objects.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/pendingActions?account=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2'
```

#### Response example

```json
{
    "actions": []
}
```

***

### `jetton/masters`

> Retrieves Jetton masters by specified filters.

#### Parameters

* `address` (array of strings; optional): Jetton master address in any form. Maximum 1024.
* `admin_address` (array of strings; optional): admin address of the Jetton master. Maximum 1024.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.

#### Returns

* `jetton_masters`: array of `{ address, total_supply, mintable, admin_address, jetton_content, jetton_wallet_code_hash, code_hash, data_hash, last_transaction_lt }`.
* `address_book`, `metadata`: maps of user-friendly forms and indexed metadata.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/jetton/masters?limit=1'
```

#### Response example

```json
{
    "jetton_masters": [
        {
            "address": "0:5E71BCDE0B18EBA1B6FC36178138D48D2AD8FD0347C8BBC47D8D4CF5C40A703F",
            "total_supply": "201000000000000",
            "mintable": true,
            "admin_address": "0:58C731E8C7CB7B11D25EFBD30CE56C0D253D543C8DE320FFF29786C3C7305AC0",
            "jetton_content": {
                "uri": "http://localhost/nft-marketplace/my_collection.json"
            },
            "jetton_wallet_code_hash": "7CCR7kVPrPoV2on/5TyXRJAFWu/rR0r1MpnRvARAkgk=",
            "code_hash": "rOIINk/O5kGub/FI/RARmMN6SY7BLesBSOonmxrz5f4=",
            "data_hash": "xd7cWaRQdVSysuG+WVJv9KRuRUGxnehLoByEcK5ukOE=",
            "last_transaction_lt": "26640202000003"
        }
    ],
    "address_book": {
        "0:5E71BCDE0B18EBA1B6FC36178138D48D2AD8FD0347C8BBC47D8D4CF5C40A703F": {
            "user_friendly": "EQBecbzeCxjrobb8NheBONSNKtj9A0fIu8R9jUz1xApwP2PZ",
            "interfaces": []
        }
    },
    "metadata": {}
}
```

***

### `jetton/wallets`

> Retrieves Jetton wallets by specified filters.

#### Parameters

* `address` (array of strings; optional): Jetton wallet address in any form. Maximum 1000.
* `owner_address` (array of strings; optional): address of the Jetton wallet owner. Maximum 1000.
* `jetton_address` (string; optional): Jetton master address in any form.
* `exclude_zero_balance` (boolean; optional): exclude wallets with zero balance.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.
* `sort` (string; optional): sort by balance, `asc` or `desc`. **Warning:** results may be inconsistent during paginated reads.

#### Returns

* `jetton_wallets`: array of `{ address, balance, owner, jetton, last_transaction_lt, code_hash, data_hash }`.
* `address_book`, `metadata`: maps of user-friendly forms and indexed metadata.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/jetton/wallets?limit=1'
```

#### Response example

```json
{
    "jetton_wallets": [
        {
            "address": "0:AFE292518AC8C439C149141AD470F119A0A879376AEC65D8DFD7EFAF97DEF7CF",
            "balance": "200000000000000",
            "owner": "0:6F2346852E7C3641B6608CC3C22D176D447C615328A742E760EAC762A2123083",
            "jetton": "0:F791C89405D4F0D146E10320523604E730FBCB5B6493D3FC3BCE80D8B9A54280",
            "last_transaction_lt": "56592171000001",
            "code_hash": "uLL7Im4pkh88G4hgB1045TsL7CmBZ28r0ZlWn+8l8gM=",
            "data_hash": "K5N838pNmi8xDW0d7ovkcmfAZ6Xib6YUvH2iUdlGC40="
        }
    ],
    "address_book": {
        "0:AFE292518AC8C439C149141AD470F119A0A879376AEC65D8DFD7EFAF97DEF7CF": {
            "user_friendly": "EQCv4pJRisjEOcFJFBrUcPEZoKh5N2rsZdjf1--vl973z_PW",
            "interfaces": ["jetton_wallet"]
        }
    },
    "metadata": {}
}
```

***

### `jetton/transfers`

> Retrieves Jetton transfers by specified filters.

#### Parameters

* `owner_address` (array of strings; optional): address of the Jetton wallet owner. Maximum 1000.
* `jetton_wallet` (array of strings; optional): Jetton wallet address. Maximum 1000.
* `jetton_master` (string; optional): Jetton master address.
* `direction` (string; optional): direction of transfer (`in` or `out`). Only applied with `owner_address`.
* `start_utime` (integer; optional): query transfers with `now >= start_utime`.
* `end_utime` (integer; optional): query transfers with `now <= end_utime`.
* `start_lt` (integer; optional): query transfers with `lt >= start_lt`.
* `end_lt` (integer; optional): query transfers with `lt <= end_lt`.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.
* `sort` (string; optional): sort by lt, `asc` or `desc`.

#### Returns

* `jetton_transfers`: array of `{ query_id, source, destination, amount, source_wallet, jetton_master, transaction_hash, transaction_lt, transaction_now, response_destination, forward_ton_amount, forward_payload, decoded_forward_payload, trace_id }`.
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/jetton/transfers?limit=1'
```

#### Response example

```json
{
    "jetton_transfers": [
        {
            "query_id": "0",
            "source": "0:ACF9BEF2F9CA602C81683A851B6BA125D0BCB7BC53C8AD7E7582B114DC32665B",
            "destination": "0:6D75EB38E6867AF8403E1DA6C6B587469C11F3CBA13CB1F40E83D1914ECB767F",
            "amount": "272541079",
            "source_wallet": "0:AC4D8937C8BEF04F2669EF4861D75939AB5777A03D15D838E0C2096A966603F5",
            "jetton_master": "0:B113A994B5024A16719F69139328EB759596C38A25F59028B146FECDC3621DFE",
            "transaction_hash": "AkwJ89p2o1AfIb8baZAi6Zy9vNi/1MjdE56n/RwLkJ8=",
            "transaction_lt": "79221614000003",
            "transaction_now": 1779670752,
            "transaction_aborted": false,
            "response_destination": "0:ACF9BEF2F9CA602C81683A851B6BA125D0BCB7BC53C8AD7E7582B114DC32665B",
            "forward_ton_amount": "1",
            "forward_payload": "te6cckEBAQEABgAACAAAAADjAK8P",
            "decoded_forward_payload": {
                "@type": "text_comment",
                "comment": ""
            },
            "trace_id": "gbE02rQmQomRRSRX9tYVLS0yvxL++0zxZmGYSCGKwUE="
        }
    ]
}
```

***

### `jetton/burns`

> Retrieves Jetton burns by specified filters.

#### Parameters

* `address` (array of strings; optional): address of the Jetton wallet owner. Maximum 1000.
* `jetton_wallet` (array of strings; optional): Jetton wallet address. Maximum 1000.
* `jetton_master` (string; optional): Jetton master address.
* `start_utime` (integer; optional): query burns with `now >= start_utime`.
* `end_utime` (integer; optional): query burns with `now <= end_utime`.
* `start_lt` (integer; optional): query burns with `lt >= start_lt`.
* `end_lt` (integer; optional): query burns with `lt <= end_lt`.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.
* `sort` (string; optional): sort by lt, `asc` or `desc`.

#### Returns

* `jetton_burns`: array of `{ query_id, owner, jetton_wallet, jetton_master, transaction_hash, transaction_lt, transaction_now, response_destination, custom_payload, amount, trace_id }`.
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/jetton/burns?limit=1'
```

#### Response example

```json
{
    "jetton_burns": [
        {
            "query_id": "0",
            "owner": "0:6F2346852E7C3641B6608CC3C22D176D447C615328A742E760EAC762A2123083",
            "jetton_wallet": "0:AFE292518AC8C439C149141AD470F119A0A879376AEC65D8DFD7EFAF97DEF7CF",
            "jetton_master": "0:F791C89405D4F0D146E10320523604E730FBCB5B6493D3FC3BCE80D8B9A54280",
            "transaction_hash": "S0Lf+UoYbR8sZpzNVw1mUq9F2eHlT8jPyVxRdM3kAaY=",
            "transaction_lt": "56592171000001",
            "transaction_now": 1779667100,
            "response_destination": "0:6F2346852E7C3641B6608CC3C22D176D447C615328A742E760EAC762A2123083",
            "amount": "1000000",
            "trace_id": "ZJVwn5K3qNlEPyHmRBfTM4UoG9aXc8dILsWvObQrijc="
        }
    ]
}
```

***

### `nft/collections`

> Retrieves NFT collections by specified filters.

#### Parameters

* `collection_address` (array of strings; optional): collection address in any form. Maximum 1024.
* `owner_address` (array of strings; optional): address of the collection owner. Maximum 1024.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.

#### Returns

* `nft_collections`: array of `{ address, owner_address, last_transaction_lt, next_item_index, collection_content, data_hash, code_hash }`.
* `address_book`, `metadata`: maps of user-friendly forms and indexed metadata.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/nft/collections?limit=1'
```

#### Response example

```json
{
    "nft_collections": [
        {
            "address": "0:948C60752383D70D0F87C98FF7DA7510FF9A4C089247784B0CF284FB3DC3FC3E",
            "owner_address": "0:38DB6EB1AAA0E5C69D90D1D0BC5E3EF187017A7171954E7084942629991B8A30",
            "last_transaction_lt": "25824921000003",
            "next_item_index": "0",
            "collection_content": {
                "uri": "http://localhost:63342/token-contract/nft/web-example/my_collection.json"
            },
            "data_hash": "JECOtzLN9S+rNw5vy5/Vdu92zVZyOmImh4AIHLNulKc=",
            "code_hash": "k/e597m00C7AVlRye4pehoWFTbJ2pIx70WxsTVwCwLc="
        }
    ],
    "address_book": {
        "0:948C60752383D70D0F87C98FF7DA7510FF9A4C089247784B0CF284FB3DC3FC3E": {
            "user_friendly": "EQCUjGB1I4PXDQ-HyY_32nUQ_5pMCJJHeEsM8oT7PcP8PslV",
            "interfaces": []
        }
    },
    "metadata": {}
}
```

***

### `nft/items`

> Retrieves NFT items by specified filters.

#### Parameters

* `address` (array of strings; optional): NFT item address in any form. Maximum 1000.
* `owner_address` (array of strings; optional): address of the NFT owner. Maximum 1000.
* `collection_address` (string; optional): collection address.
* `index` (array of strings; optional): index of the item within the collection. Maximum 1000.
* `include_on_sale` (boolean; optional): include NFTs on sales and auctions. Used only with `owner_address`.
* `sort_by_last_transaction_lt` (boolean; optional): sort NFT items by last transaction lt descending. **Warning:** results may be inconsistent during paginated reads.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.

#### Returns

* `nft_items`: array of `{ address, init, index, collection_address, owner_address, content, last_transaction_lt, code_hash, data_hash, collection, on_sale }`.
* `address_book`, `metadata`: maps of user-friendly forms and indexed metadata.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/nft/items?limit=1'
```

#### Response example

```json
{
    "nft_items": [
        {
            "address": "0:BBE4B240CF509E7FBEEB4AC5925A83C55F4A14EB9A84BA19FD9481BFD4054BA6",
            "init": true,
            "index": "0",
            "collection_address": "0:5D63AB1346C87752BC9652108A53CAA0FCE41CA24F6437D19AEA2F8D48161CC5",
            "owner_address": "0:348BCF827469C5FC38541C77FDD91D4E347EAC200F6F2D9FD62DC08885F0415F",
            "content": {
                "uri": "http://localhost:63342/token-contract/nft/web-example/my_nft.json"
            },
            "last_transaction_lt": "25825255000005",
            "code_hash": "ESAEh1A/+UyOCHA+fqIJJusZ5PBQ0rMy27ywZCz8B/o=",
            "data_hash": "EWUdFqb5YqlZiTJScCXoDo7AJm1zyaJ4adbLB1j6oiY=",
            "collection": {
                "address": "0:5D63AB1346C87752BC9652108A53CAA0FCE41CA24F6437D19AEA2F8D48161CC5",
                "owner_address": "0:348BCF827469C5FC38541C77FDD91D4E347EAC200F6F2D9FD62DC08885F0415F",
                "next_item_index": "1"
            },
            "on_sale": false
        }
    ]
}
```

***

### `nft/transfers`

> Retrieves NFT transfers by specified filters.

#### Parameters

* `owner_address` (array of strings; optional): address of the NFT owner. Maximum 1000.
* `item_address` (array of strings; optional): NFT item address. Maximum 1000.
* `collection_address` (string; optional): collection address.
* `direction` (string; optional): direction of transfer (`in` or `out`).
* `start_utime` (integer; optional): query transfers with `now >= start_utime`.
* `end_utime` (integer; optional): query transfers with `now <= end_utime`.
* `start_lt` (integer; optional): query transfers with `lt >= start_lt`.
* `end_lt` (integer; optional): query transfers with `lt <= end_lt`.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.
* `sort` (string; optional): sort by lt, `asc` or `desc`.

#### Returns

* `nft_transfers`: array of `{ query_id, nft_item_address, transaction_hash, transaction_lt, transaction_now, old_owner, new_owner, response_destination, custom_payload, forward_amount, forward_payload, trace_id }`.
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/nft/transfers?limit=1'
```

#### Response example

```json
{
    "nft_transfers": [
        {
            "query_id": "0",
            "nft_item_address": "0:BBE4B240CF509E7FBEEB4AC5925A83C55F4A14EB9A84BA19FD9481BFD4054BA6",
            "transaction_hash": "QmTr3sFeR4hVbY8nKlPjW9zXcM2vL5tHpA1Ng0KdY7eJs=",
            "transaction_lt": "25825255000005",
            "transaction_now": 1779665100,
            "old_owner": "0:348BCF827469C5FC38541C77FDD91D4E347EAC200F6F2D9FD62DC08885F0415F",
            "new_owner": "0:5D63AB1346C87752BC9652108A53CAA0FCE41CA24F6437D19AEA2F8D48161CC5",
            "response_destination": "0:348BCF827469C5FC38541C77FDD91D4E347EAC200F6F2D9FD62DC08885F0415F",
            "forward_amount": "1",
            "forward_payload": null,
            "trace_id": "x8R3PnQz7Y6vL2kHbJ1mA5tFwIuCdNgB9KrEsXyV0a4="
        }
    ]
}
```

***

### `nft/sales`

> Retrieves GetGems NFT sales and auctions by sale or auction contract address.

#### Parameters

* `address` (array of strings; required): sale or auction contract address in any form. Maximum 1000.

#### Returns

* `nft_sales`: array of sale/auction objects with marketplace, price, currency, NFT item, and contract details.
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/nft/sales?address=EQB6QbA9c8YfsOgYf4DfvgRkJrXMaBgPpDxiK1QGz8nNqaqj'
```

#### Response example

```json
{
    "nft_sales": [
        {
            "address": "0:7A41B03D73C61FB0E8187F80DFBE046426B5CC68180FA43C622B5406CFC9CDA9",
            "is_complete": false,
            "marketplace_address": "0:5B5E767F08D4A1B49DBB6E60A3DB22D9FBD1C1FD9A0BBED9CF1B73C2A8A92010",
            "nft_address": "0:BBE4B240CF509E7FBEEB4AC5925A83C55F4A14EB9A84BA19FD9481BFD4054BA6",
            "nft_owner_address": "0:348BCF827469C5FC38541C77FDD91D4E347EAC200F6F2D9FD62DC08885F0415F",
            "full_price": "10000000000",
            "marketplace_fee": "250000000",
            "royalty_address": "0:38DB6EB1AAA0E5C69D90D1D0BC5E3EF187017A7171954E7084942629991B8A30",
            "royalty_amount": "500000000",
            "last_transaction_lt": "79221700000003"
        }
    ]
}
```

***

### `dns/records`

> Retrieves DNS records by specified filters.

Currently `.ton` and `.t.me` DNS records are supported.

#### Parameters

* `wallet` (string; optional): wallet address in any form. Returns DNS records containing this address in the wallet category.
* `domain` (string; optional): domain name to search for.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.

#### Returns

* `dns_records`: array of `{ nft_item_address, nft_item_owner, domain, dns_next_resolver, dns_wallet, dns_site_adnl, dns_storage_bag_id, last_transaction_lt }`.
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/dns/records?domain=crypto-flipper.ton'
```

#### Response example

```json
{
    "dns_records": [
        {
            "nft_item_address": "0:5A8FCB39C1E47A2F8E9D34B7D2C1A5E76F03BB5C9A2D7E48F1C5B6A0E4D9F2A1",
            "nft_item_owner": "0:ED1691307050047117B998B561D8DE82D31FBF84910CED6EB5FC92E7485EF8A7",
            "domain": "crypto-flipper.ton",
            "dns_next_resolver": null,
            "dns_wallet": "0:ED1691307050047117B998B561D8DE82D31FBF84910CED6EB5FC92E7485EF8A7",
            "dns_site_adnl": null,
            "dns_storage_bag_id": null,
            "last_transaction_lt": "78900000000001"
        }
    ]
}
```

***

### `multisig/wallets`

> Retrieves multisig contracts by specified filters with associated orders.

#### Parameters

* `address` (array of strings; optional): multisig contract address. Maximum 1024.
* `wallet_address` (array of strings; optional): address of a signer or proposer wallet. Maximum 1024.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.
* `sort` (string; optional): sort by `last_transaction_lt`, `asc` or `desc`.
* `include_orders` (boolean; optional): include associated multisig orders.

#### Returns

* `multisig_wallets`: array of `{ address, next_order_seqno, threshold, signers, proposers, orders, last_transaction_lt, code_hash, data_hash }`.
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/multisig/wallets?limit=1&include_orders=false'
```

#### Response example

```json
{
    "multisig_wallets": [
        {
            "address": "0:8F3B41E72CD05A8E1B9D4F6CA2E59731D7B0F3C24A8E1B2D5F6A0E4C7B1D9A53",
            "next_order_seqno": "5",
            "threshold": 2,
            "signers": [
                "0:6F2346852E7C3641B6608CC3C22D176D447C615328A742E760EAC762A2123083",
                "0:58C731E8C7CB7B11D25EFBD30CE56C0D253D543C8DE320FFF29786C3C7305AC0"
            ],
            "proposers": [],
            "last_transaction_lt": "79220000000001",
            "code_hash": "fA1R4MnQc9X7L8KdVm5sP3hHpEt4yWqOzJrBxYZ6aN0=",
            "data_hash": "Wg9pV2nMzJxL8KdT5sX0H7fQbY6vR3hPe4cYrBxNqAi="
        }
    ]
}
```

***

### `multisig/orders`

> Retrieves multisig orders by specified filters.

#### Parameters

* `address` (array of strings; optional): order address in any form. Maximum 1024.
* `multisig_address` (array of strings; optional): address of the parent multisig. Maximum 1024.
* `parse_actions` (boolean; optional): parse order actions in the response.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.
* `sort` (string; optional): sort by `last_transaction_lt`, `asc` or `desc`.

#### Returns

* `multisig_orders`: array of `{ address, multisig_address, order_seqno, threshold, sent_for_execution, signers, approvals_mask, approvals_num, expiration_date, order_boc, actions, last_transaction_lt }`.
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/multisig/orders?limit=1'
```

#### Response example

```json
{
    "multisig_orders": [
        {
            "address": "0:2E8FA34C9B1D7F0E5K3M6P9Q2R5T8V1X4Y7Z0A3B6D9G2J5L8N1P4R7T0V3X6Y9",
            "multisig_address": "0:8F3B41E72CD05A8E1B9D4F6CA2E59731D7B0F3C24A8E1B2D5F6A0E4C7B1D9A53",
            "order_seqno": "1",
            "threshold": 2,
            "sent_for_execution": false,
            "approvals_mask": "1",
            "approvals_num": 1,
            "expiration_date": 1780000000,
            "last_transaction_lt": "79221000000003"
        }
    ]
}
```

***

### `vesting`

> Retrieves vesting contracts by specified filters.

#### Parameters

* `contract_address` (array of strings; optional): vesting contract address. Maximum 1000.
* `wallet_address` (array of strings; optional): wallet address to filter by owner or sender. Maximum 1000.
* `check_whitelist` (boolean; optional): check if the wallet address is in the contract's whitelist.
* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.

#### Returns

* `vesting_contracts`: array of `{ address, vesting_start_time, vesting_total_duration, unlock_period, cliff_duration, vesting_total_amount, vesting_sender_address, owner_address, whitelist, last_transaction_lt }`.
* `address_book`: map of user-friendly forms.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/vesting?limit=1'
```

#### Response example

```json
{
    "vesting_contracts": [
        {
            "address": "0:1A4B7E9C2D5F8021456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123",
            "vesting_start_time": 1700000000,
            "vesting_total_duration": 31536000,
            "unlock_period": 86400,
            "cliff_duration": 2592000,
            "vesting_total_amount": "1000000000000",
            "vesting_sender_address": "0:6F2346852E7C3641B6608CC3C22D176D447C615328A742E760EAC762A2123083",
            "owner_address": "0:58C731E8C7CB7B11D25EFBD30CE56C0D253D543C8DE320FFF29786C3C7305AC0",
            "whitelist": [],
            "last_transaction_lt": "79215000000003"
        }
    ]
}
```

***

### `topAccountsByBalance`

> Retrieves the list of accounts sorted descending by balance.

#### Parameters

* `limit` (integer; optional): limit number of queried rows.
* `offset` (integer; optional): skip first N rows.

#### Returns

* Array of `{ account, balance }` entries ordered by balance descending.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/topAccountsByBalance?limit=2'
```

#### Response example

```json
[
    {
        "account": "0:ED1691307050047117B998B561D8DE82D31FBF84910CED6EB5FC92E7485EF8A7",
        "balance": "1277485861704527743"
    },
    {
        "account": "-1:3333333333333333333333333333333333333333333333333333333333333333",
        "balance": "1254976019091652155"
    }
]
```

***

### `decode`

> Decodes opcodes and message bodies.

Opcodes can be passed in hex (with or without `0x` prefix) or decimal format. Bodies should be in base64 or hex format. Use the POST form for long parameters that may be truncated in a URL.

#### Parameters

* `opcodes` (array of strings; optional): opcodes to decode.
* `bodies` (array of strings; optional): message bodies to decode.

#### Returns

* `opcodes`: array of resolved opcode names (e.g. `jetton_transfer`, `nft_transfer`).
* `bodies`: array of decoded body objects.

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/decode?opcodes=0x178d4519&opcodes=0xf8a7ea5'
```

#### Response example

```json
{
    "opcodes": [
        "jetton_internal_transfer",
        "jetton_transfer"
    ],
    "bodies": []
}
```

***

### `addressInformation`

> Retrieves smart contract information (v2-compatible).

Mirrors v2's [`getAddressInformation`](/chains/ton/ton-v2.md#getaddressinformation). Pass `use_v2=false` to read the indexed v3 representation instead (recommended).

#### Parameters

* `address` (string; required): account address in any form.
* `use_v2` (boolean; optional): use the v2 method (not recommended).

#### Returns

* Account state object (see v2 [`getAddressInformation`](/chains/ton/ton-v2.md#getaddressinformation)).

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/addressInformation?address=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2'
```

#### Response example

```json
{
    "balance": "1277485861704527743",
    "code": "te6cckECEgEAAvUAART/APSkE/S88sgLAQIBYgIDA27QM9DTAwFxsJJfA+D6QDDbPALTHyGCENZBa/664wIBwADyvdMH0SDA...",
    "data": "te6cckECBgEAAQ8AAUKA5YQILcgsXJgD8ASdQrbkAGU1t4Bo6u+ABY/UAAAnjQABART/APSkE/S88sgLAgIBYgMEAZ7Q7aLt+zMx0NMDAXGw...",
    "last_transaction_id": {
        "lt": "78756620000015",
        "hash": "MjpKVwMq6j5s4jLASmyzowATm6a/2BGZIipAxT+6mRM="
    },
    "block_id": {
        "workchain": -1,
        "shard": "-9223372036854775808",
        "seqno": 68943483
    },
    "frozen_hash": "",
    "sync_utime": 1779670202,
    "state": "active"
}
```

***

### `walletInformation`

> Retrieves wallet smart contract information (v2-compatible).

Supports wallets `v1r1`, `v1r2`, `v1r3`, `v2r1`, `v2r2`, `v3r1`, `v3r2`, `v4r1`, `v4r2`, `v5beta`, `v5r1`. Returns error code 409 if the account is not a recognized wallet.

#### Parameters

* `address` (string; required): account address in any form.
* `use_v2` (boolean; optional): use the v2 method (not recommended).

#### Returns

* Wallet state object: `balance`, `seqno`, `wallet_type`, `last_transaction_id`, `account_state`, `wallet_id` (for v4+ wallets).

#### Request example

```bash
curl -X GET 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/walletInformation?address=EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2'
```

#### Response example (non-wallet)

```json
{
    "error": "not a wallet"
}
```

#### Response example (wallet)

```json
{
    "balance": "1000000000",
    "seqno": 42,
    "wallet_id": 698983191,
    "wallet_type": "wallet v4 r2",
    "account_state": "active",
    "last_transaction_id": {
        "lt": "79220000000003",
        "hash": "ZJVwn5K3qNlEPyHmRBfTM4UoG9aXc8dILsWvObQrijc="
    }
}
```

***

### `runGetMethod`

> Runs a get method of a smart contract.

Stack supports `num`, `cell`, and `slice` types. Each stack entry is `{ "type": "num", "value": "0x12a" }` for numbers or `{ "type": "cell|slice", "value": "te6..." }` for base64-encoded BoCs.

#### Parameters

Body (JSON):

* `address` (string; required): smart contract address.
* `method` (string or integer; required): method name or method ID.
* `stack` (array; required): input stack with typed entries.

#### Returns

* `gas_used`: gas consumed during execution.
* `stack`: output stack.
* `exit_code` (integer): TVM exit code (`0` means success).

#### Request example

```bash
curl -X POST 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/runGetMethod' \
-H 'Content-Type: application/json' \
-d '{
    "address": "EQB-MPwrd1G6WKNkLz_VnV6WqBDd142KMQv-g1O-8QUA3728",
    "method": "get_jetton_data",
    "stack": []
}'
```

#### Response example

```json
{
    "gas_used": 1308,
    "stack": [
        { "type": "num", "value": "0xfa491a042" },
        { "type": "num", "value": "-1" },
        { "type": "cell", "value": "te6cckEBAQEA..." }
    ],
    "exit_code": 0
}
```

***

### `estimateFee`

> Estimates the fee required to process a query.

Body, `init_code`, and `init_data` are accepted in serialized format (base64-encoded BoC).

#### Parameters

Body (JSON):

* `address` (string; required): destination smart contract address.
* `body` (string; required): base64-encoded BoC of the message body.
* `init_code` (string; optional): base64-encoded BoC of the init code.
* `init_data` (string; optional): base64-encoded BoC of the init data.
* `ignore_chksig` (boolean; optional): skip the signature check.

#### Returns

* `source_fees`: `{ in_fwd_fee, storage_fee, gas_fee, fwd_fee }` for the source.
* `destination_fees`: same shape for the destination(s).

#### Request example

```bash
curl -X POST 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/estimateFee' \
-H 'Content-Type: application/json' \
-d '{
    "address": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
    "body": "te6cckEBAQEAAgAAAEysuc0=",
    "init_code": "",
    "init_data": "",
    "ignore_chksig": true
}'
```

#### Response example

```json
{
    "source_fees": {
        "in_fwd_fee": 1437452,
        "storage_fee": 0,
        "gas_fee": 309000,
        "fwd_fee": 666672
    },
    "destination_fees": []
}
```

***

### `message`

> Sends an external message to the TON network.

#### Parameters

Body (JSON):

* `boc` (string; required): base64-encoded BoC of the external message.

#### Returns

* `message_hash`: base64-encoded hash of the broadcasted message.
* `message_hash_norm`: normalized hash of the message.

#### Request example

```bash
curl -X POST 'https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}/message' \
-H 'Content-Type: application/json' \
-d '{
    "boc": "te6cckEBAgEAcwAB4YgB2i0iYOCgCOIvczFqw7G9BaY/fwkiGdrda/klzpC98U8DwH..."
}'
```

#### Response example

```json
{
    "message_hash": "xzyhgoOLEyLidSGDI1bbOpdlJhL9N5xH67V3rkaJOKE=",
    "message_hash_norm": "C0Cy4+BQc0xQ8n2bPNuTxjcrp8efVyM4AyFGA2vSRvQ="
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-rpc.crypto-chief.com/chains/ton/ton-v3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.