Run get method (standard)

Executes a get method with typed stack entries. Unlike runGetMethod which uses arrays, this endpoint uses explicit types (TvmStackEntryNumber, TvmStackEntryCell, etc.) for clearer input/output handling. Recommended for complex method calls.

POST /api/v2/runGetMethodStd

Try it

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

X-API-Key · string · header · required

Body

application/json

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 · object[] · required

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

Option 1

Show child attributes

stack. @type · enum<string> · default: tvm.stackEntrySlice · required

Object type identifier.

Available options: tvm.stackEntrySlice

stack. slice · object · required

TVM slice value.

Show child attributes

stack.slice. @type · enum<string> · default: tvm.slice · required

Object type identifier.

Available options: tvm.slice

stack.slice. bytes · string · required

Slice data in base64.

seqno · integer

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 in standard format.

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 · object[] · required

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

Option 1

Show child attributes

result.stack. @type · enum<string> · default: tvm.stackEntrySlice · required

Object type identifier.

Available options: tvm.stackEntrySlice

result.stack. slice · object · required

TVM slice value.

Show child attributes

result.stack.slice. @type · enum<string> · default: tvm.slice · required

Object type identifier.

Available options: tvm.slice

result.stack.slice. bytes · string · required

Slice data in base64.

result. exit_code · integer<int32> · required

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

@extra · string

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