Run get method

Executes a read-only method on a smart contract. Get methods let you query contract state without sending a transaction. Common methods: seqno (wallet sequence number), get_wallet_data (wallet info), get_jetton_data (token info). Pass method arguments in the stack array.

POST /api/v2/runGetMethod

Try it

Run get method

cURL

curl --request POST \
  --url https://toncenter.com/api/v2/runGetMethod \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "address": "<string>",
  "method": "<string>",
  "stack": [
    [
      "<string>"
    ]
  ],
  "seqno": 123
}
'

200

{
  "ok": true,
  "result": {
    "@type": "smc.runResult",
    "gas_used": 123,
    "stack": [
      [
        "<string>"
      ]
    ],
    "exit_code": 123,
    "block_id": {
      "@type": "ton.blockIdExt",
      "workchain": 123,
      "shard": "<string>",
      "seqno": 123,
      "root_hash": "<string>",
      "file_hash": "<string>"
    },
    "last_transaction_id": {
      "@type": "internal.transactionId",
      "lt": "<string>",
      "hash": "<string>"
    }
  },
  "@extra": "<string>"
}

Authorizations

X-API-Key · string · header · required

Body

application/json

Request to execute a smart contract get method. Specify address, method name/ID, and input stack.

address · string · required

The account address in user-friendly format.

method · required

The get method name (e.g., "seqno", "get_wallet_data") or its numeric ID.

stack · string · integer<int64> · object · object · object[][] · required

Input arguments or output values as a TVM stack. Each entry has a type and value.

Required array length: 2 elements

seqno · integer<int32>

Block or wallet sequence number. For blocks, this is the block height. For wallets, increment this for each outgoing transaction.

Response

200

application/json

OK

Response containing get method execution results.

ok · boolean · default: true · required

Indicates if the request succeeded. If false, check the error field for details.

result · object · required

The response data. Only present when ok is true.

Show child attributes

result. @type · enum<string> · default: smc.runResult · required

Object type identifier.

Available options: smc.runResult

result. gas_used · integer<int64> · required

Amount of gas consumed during execution. Useful for estimating costs of similar operations.

result. stack · string · integer<int64> · object · object · object[][] · required

Input arguments or output values as a TVM stack. Each entry has a type and value.

Required array length: 2 elements

result. exit_code · integer<int32> · required

TVM execution result: 0 or 1 means success, other values indicate errors. Check TON docs for error codes.

result. block_id · object · required

Full block identifier where this event occurred.

Show child attributes

result.block_id. @type · enum<string> · default: ton.blockIdExt · required

Object type identifier.

Available options: ton.blockIdExt

result.block_id. workchain · integer · required

Workchain ID: -1 for masterchain, 0 for basechain. Most user transactions are on workchain 0.

result.block_id. shard · string · required

Shard identifier. A signed 64-bit integer. Masterchain uses -9223372036854775808.

result.block_id. seqno · integer · required

Block or wallet sequence number. For blocks, this is the block height. For wallets, increment this for each outgoing transaction.

result.block_id. root_hash · string · required

Merkle root hash of the block state tree. Used for cryptographic verification.

result.block_id. file_hash · string · required

Hash of the serialized block data. Together with root_hash, uniquely identifies a block.

result. last_transaction_id · object · required

Reference to the most recent transaction. Use as starting point for getTransactions.

Show child attributes

result.last_transaction_id. @type · enum<string> · default: internal.transactionId · required

Object type identifier.

Available options: internal.transactionId

result.last_transaction_id. lt · string · required

Logical time of this event. A globally unique counter that orders all blockchain events. Higher values are more recent.

result.last_transaction_id. hash · string · required

Unique identifier hash for this object.

@extra · string

Optional request ID that you can pass in the request and receive back in the response. Useful for matching async responses.