Home

Gram (GRAM) API Documentation

Gram

Gram (GRAM) is the primary currency of TON, a sharded Layer 1 secured by proof-of-stake validators and organized around workchains, shardchains, and the Infinite Sharding Paradigm. Smart contracts run in the TON Virtual Machine, with Tolk as the recommended language, while persistent state is stored per account and full nodes validate masterchain and shardchain blocks, transactions, messages, and account state. This asynchronous account-and-message model makes TON’s native block, message, transaction, and contract interfaces distinct from EVM-style RPC semantics.

Gram API Methods and Endpoints

NOWNodes exposes Gram's interface, plus a few others, depending on what your integration needs: the native Gram API for chain interaction, the Indexer API for indexed blockchain data, and OpenAPI for structured network queries.

Browse the interfaces below for endpoint details, request parameters, response formats, and integration examples. Create an API key, select Mainnet or Testnet, choose the required interface, and start sending requests from your application.

Weighing Gram RPC providers against each other? Read the comparison guide on our blog — this page stays focused on integration reference.

Quick start

01

Get an API key

Sign up and generate a free key from the dashboard.

Get key →
02

Select environment

Mainnet or Sepolia testnet.

03

Choose an interface

RPC, WSS, Blockbook, or Trace/Debug.

04

Send a request

Call it from your application.

RPCJSON-RPCStandard RPC methods for reading chain state and broadcasting transactions.Node APIs →WSSWebSocketPersistent connections for new blocks, pending transactions, and log events as they happen.WSS API →T/DTrace & DebugStep-level execution traces for inspecting calls and diagnosing transactions.Trace & Debug API →ARCArchive modeFull historical state access beyond standard node retention.Archive nodes →MCPModel Context ProtocolThe Model Context Protocol (MCP) is an open standard that lets AI assistants call external tools through a uniform interface.MCP →

Ready to build on: TON

Create a free API key and start sending requests in minutes.