Run get method (standard)

Executes a read-only method on a smart contract using typed stack entries. Input and output stack entries use explicit types (TvmStackEntryNumber, TvmStackEntryCell, etc.) for structured input/output handling. Common methods: seqno (wallet sequence number), get_wallet_data (wallet info), get_jetton_data (token info).

POST /api/v2/runGetMethodStd

Run get method (standard)

cURL

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

200

{
  "ok": true,
  "result": {
    "@type": "smc.runResult",
    "gas_used": 123,
    "stack": [
      {
        "@type": "tvm.stackEntrySlice",
        "slice": {
          "@type": "tvm.slice",
          "bytes": "<string>"
        }
      }
    ],
    "exit_code": 123
  },
  "@extra": "<string>"
}

Authorizations

APIKeyHeaderAPIKeyQuery

X-API-Key · string · header · required

API key header of the form X-API-Key: <token>, where <token> is your API key. Requests without a key are limited to 1 RPS. More info here.

Body

application/json

address · string · required

Account address in raw format (e.g., 0:ca6e321c...) or user-friendly format (e.g., EQDKbjIcfM...). All formats are automatically detected.

method · string integer<int32> · required

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

stack · object[] · required

Input arguments as a TVM stack. Each entry is a typed object with @type discriminator: tvm.stackEntryNumber (decimal string), tvm.stackEntryCell (base64 BOC), tvm.stackEntrySlice (base64 BOC), tvm.stackEntryTuple, or tvm.stackEntryList.

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Show child attributes

seqno · integer

Masterchain block sequence number. Run the get method against the contract state at this specific block height. If omitted, uses the current state.

Response

200

application/json

Returns the get method result in standardized stack format.

ok · boolean · default: true · required

Returns true if the request succeeded; otherwise false. See the error field for details.

result · object · required

Response data. Present only when ok is true.

Show child attributes

@extra · string

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