getVersion — TON JSON-RPC

Status: Available

Returns version and capability fields reported by the selected liteserver.

TON RPC node endpoint · Best TON RPC providers compared

POSThttps://triport.io/rpc/ton

Network: TON mainnet
Scope: ton:rpc
Auth: x-token: $TRIPORT_API_KEY
Rate limit: free+; ton_read_rpc: 15 / 20 / 100 / 250 RPS sustained · short burst 30 / 40 / 200 / 500 (free / basic / pro / business; default, unmeasured); Burst capacity

Request

cURLJavaScriptPython

curl https://triport.io/rpc/ton \
  -H "x-token: $TRIPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getVersion","params":{}}'

const res = await fetch("https://triport.io/rpc/ton", {
  method: "POST",
  headers: {
    "x-token": process.env.TRIPORT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getVersion",
    "params": {}
  }),
});
const data = await res.json();
console.log(data);

import os


import requests


resp = requests.post(
    "https://triport.io/rpc/ton",
    headers={
        "x-token": os.environ["TRIPORT_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "getVersion",
        "params": {},
    },
)
data = resp.json()
print(data)

Response

JSON

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "capabilities": "7",
    "mode": 0,
    "now": 1788347579,
    "version": 257
  }
}

Liteserver call over ADNL: liteServer.getVersion. See lite_api.tl (checked 2026-10-25).

getVersion exposes the version and capability data from the binary protocol. The values describe the selected upstream liteserver, not the Triport API version or the TON network protocol as a whole.

Use it for diagnostics and capability inspection. Applications that need chain progress should call getMasterchainInfo; applications that only need the server clock can call getTime.

The result schema intentionally allows additional properties because a liteserver can report implementation-defined version fields. This direct liteserver name has no public HTTP-gateway compatibility promise.

Parameters

JSON-RPC params is an empty by-name object.

Params: object (by-name).

——optional

This method has no parameters; send params: {}.

Response

Response fields

Field	Type	Description
`jsonrpc`	string	JSON-RPC protocol version.
`id`	number or string	Correlates the response with the request.
`result`	object	Liteserver version and capability result.
`result.capabilities`	string	Capability value as returned by the captured liteserver.
`result.mode`	integer	Response mode value returned by the liteserver.
`result.now`	integer	Unix time reported with the version response.
`result.version`	integer	Selected liteserver's version value.

The response is copied from the accepted live fixture. Other liteservers may expose additional fields allowed by the OpenRPC schema.

Errors

See TON errors for the shared envelope.

Code	Meaning	When it happens
`-32602`	Invalid params	The parameter structure is malformed or positional.
`-32601`	Method not found	The method is outside the published read-only catalog.
`401`	Unauthorized	The API key is missing or invalid.
`429`	Rate limited	The `ton_read_rpc` budget is exceeded.

Examples

JavaScript

const response = await fetch("https://triport.io/rpc/ton", {
  method: "POST",
  headers: { "x-token": process.env.TRIPORT_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ jsonrpc: "2.0", id: "version", method: "getVersion", params: {} }),
});
const { result: liteserver } = await response.json();

Notes

Treat all returned values as properties of the selected liteserver, not a uniform product-wide version declaration.
Requests use named params and batched responses are matched by id.
TON WebSocket diagnostics and public gateway upstreams are not published.
Related methods: getTime and getMasterchainInfo.
TON RPC endpoint and plans.