Get consensus block

Returns the latest block that has reached consensus and is guaranteed to be final. This block will never be reverted, making it safe for confirming transactions that require absolute finality.

GET /api/v2/getConsensusBlock

Get consensus block

cURL

curl --request GET \
  --url https://toncenter.com/api/v2/getConsensusBlock \
  --header 'X-API-Key: <api-key>'

200

{
  "ok": true,
  "result": {
    "@type": "ext.blocks.consensusBlock",
    "consensus_block": 123,
    "timestamp": 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.

Response

200

application/json

The latest masterchain block that has achieved finality — guaranteed to never be reverted. Returns its sequence number and Unix timestamp.

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.