TON DocsTON Docs
OnboardingNodesApplicationsAPIsContractsSmart contractsTolkTolk languageTVMTON Virtual MachineFoundationsBlockchain foundations

Run get method

POST
/api/v2/runGetMethod

Executes a read-only method on a smart contract. Get methods query contract state without sending a transaction. Common methods include seqno (wallet sequence number), get_wallet_data (wallet info), and get_jetton_data (token info). Method arguments are provided in the stack array.

Authorization

X-API-Key<token>

API key header of the form X-API-Key: <token>, where <token> is the API key. Requests without a key are limited to 1 RPS. Refer to the authentication guide for details.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

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

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v2/runGetMethod" \  -H "Content-Type: application/json" \  -d '{    "address": "string",    "method": "string",    "stack": [      [        "string",        "string"      ]    ]  }'
{  "ok": true,  "result": {    "@type": "smc.runResult",    "gas_used": 0,    "stack": [      [        "string",        "string"      ]    ],    "exit_code": 0,    "block_id": {      "@type": "ton.blockIdExt",      "workchain": 0,      "shard": "string",      "seqno": 0,      "root_hash": "string",      "file_hash": "string"    },    "last_transaction_id": {      "@type": "internal.transactionId",      "lt": "string",      "hash": "string"    }  },  "@extra": "string"}