# TON

<figure><img src="/files/V6QPkYsyx9N0NkrapQQL" alt=""><figcaption></figcaption></figure>

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

*TON* (The Open Network) is a proof-of-stake Layer 1 blockchain with a dynamic sharding architecture built around a masterchain and multiple workchains. Smart contracts run on the TON Virtual Machine (TVM) using the FunC and Tact languages and communicate through an asynchronous message-passing model — each contract processes incoming messages independently, enabling parallel execution across shards. TON uses a Bag of Cells (BoC) binary encoding for all data structures: blocks, transactions, messages, and contract state.

Crypto Chief exposes TON through two TonCenter REST API interfaces. v2 wraps the TON liteserver protocol behind an HTTP REST interface and is suited for real-time operations. v3 queries an indexed PostgreSQL database and is suited for historical lookups, analytics, and decoded token data.

***

### Endpoints

| Interface    | Network | Endpoint                                             | Auth              |
| ------------ | ------- | ---------------------------------------------------- | ----------------- |
| TonCenter v2 | Mainnet | `https://rpc.crypto-chief.com/ton-v2/{YOUR_API_KEY}` | Token for Premium |
| TonCenter v3 | Mainnet | `https://rpc.crypto-chief.com/ton-v3/{YOUR_API_KEY}` | Token for Premium |

For Premium endpoints, append your token to the URL. All responses are returned in [JSON format](https://www.json.org/json-en.html).

***

### Interfaces

#### TonCenter v2

A direct interface to a TON liteserver. Best suited for: querying account balances and state, executing get-methods on smart contracts, broadcasting external messages, and looking up the latest masterchain and shard blocks. Endpoints are exposed as REST methods (GET and POST) and are additionally available through a JSON-RPC envelope at `/jsonRPC`.

[View TonCenter v2 methods →](/chains/ton/ton-v2.md)

#### TonCenter v3

An indexed data layer built on top of a PostgreSQL database. Best suited for: historical transaction and trace queries, decoded Jetton and NFT data, analytics across multiple accounts, DNS lookups, and powering explorers and reporting tools. Supports rich filtering, sorting, and offset-based pagination.

[View TonCenter v3 methods →](/chains/ton/ton-v3.md)

***

### Getting started

1. **Get your API token** — Sign up at [crypto-chief.com/rpc](https://crypto-chief.com/rpc/ton/) to get a Premium token, or use the public endpoints without authentication.
2. **Choose your interface** — pick v2 for direct liteserver operations and sending transactions, or v3 for indexed historical data, Jettons, NFTs, and traces.
3. **Connect** — use the endpoints from the table above with your preferred HTTP client.

Official TON links: [Website](https://ton.org/), [Docs](https://docs.ton.org/), [GitHub](https://github.com/ton-blockchain)


---

# 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.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.