getoutmsgqueuesize - TON

Example code for the getoutmsgqueuesize JSON-RPC method. Сomplete guide on how to use getoutmsgqueuesize JSON-RPC in GetBlock.io Web3 documentation.

This method returns the current size of the outbound message queue. Useful for monitoring chain congestion and queue depth.

Parameters

• None

Request Example

cURL

REST (GET):

curl --location --request GET 'https://go.getblock.io/<ACCESS-TOKEN>/getOutMsgQueueSize' \
--header 'Content-Type: application/json'

JSON-RPC (POST):

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "getOutMsgQueueSize",
    "params": {},
    "id": "getblock.io"
}'

JavaScript (Axios)

Python (Requests)

Rust (Reqwest)

Response Example

{
    "ok": true,
    "result": {
        "@type": "blocks.outMsgQueueSize",
        "size": 42
    },
    "id": "getblock.io",
    "jsonrpc": "2.0"
}

Response Parameters

Field	Type	Description
result.size	integer	Number of messages currently in the outbound message queue

Use Cases

• Monitoring chain congestion

• Validator and node operator dashboards

• Routing logic that backs off under high queue pressure

Error Handling

Status Code	Error Message	Cause
403	Forbidden	Missing or invalid <ACCESS-TOKEN>
422	Validation Error	Request parameters are missing or malformed
429	Too Many Requests	Rate limit exceeded for your plan
504	Lite Server Timeout	Upstream TON liteserver timed out

SDK Integration

@ton/ton (JavaScript)

import { TonClient } from '@ton/ton';

const client = new TonClient({
    endpoint: 'https://go.getblock.io/<ACCESS-TOKEN>'
});

// The @ton/ton client wraps the same JSON-RPC methods.
// For low-level access, use client.callGetMethod or client.provider.

pytoniq (Python)