📜 Get latest N blocks

Code samples

GET /api/v1/trx/block/latest/{num}

curl 'https://settla.net/api/v1/trx/block/latest/2' \
  -H 'X-API-Key: $SETTLA_API_KEY' \
  -H 'Accept: application/json'

Returns the last N blocks, newest first, wrapped in a block array. Each block carries its full transaction list. On mainnet that is roughly 0.5 MB per block, so num=2 already returns about 1 MB and larger values are slow and heavy. If you only need heights and timestamps, poll GET /api/v1/trx/block/last instead.

🛠️ Parameters

Name	In	Type	Required	Description
num	path	integer	true	Number of latest blocks to retrieve.

Example responses

200 Response

{
  "block": [
    {
      "blockID": "00000000051e892828708ea883becd0a3a3ccd6e4fc61bec4519f8fa0851de24",
      "block_header": {
        "raw_data": {
          "timestamp": 1788333420000,
          "txTrieRoot": "28686fb3ec404c7e605716dc6e15c858104fa37cfdcdae373362363a089bbddc",
          "parentHash": "00000000051e89276578bf219f05a29340b90665b12eb9fb6e620600993bb4ba",
          "number": 85887272,
          "witness_address": "412a4d700c196a78f8ff7f0bf17d93fe6018396d2e",
          "version": 36
        },
        "witness_signature": "3f1342fd2cb93b74ea6f4ffb4b22f90d03750c6d091a8df8eea3ff2141197b9e509a0cff318f7bbab0f3baa66f51750cfb9e80813e192a4fa74a362e044360dd00"
      },
      "transactions": [
        "… 467 transactions, omitted here — see the block-by-number example for their shape"
      ]
    }
  ]
}

500 Response

{
  "error": "Could not connect to TRX node."
}

🔁 Responses

Status	Meaning	Description	Schema
200	OK	Array of latest blocks	Inline
500	Internal Server Error	Could not connect to TRX node	Inline

🔄 Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» block	[object]	false	none	none
»» blockID	string	false	none	none
»» block_header	object	false	none	none
»»» raw_data	object	false	none	none
»»»» number	integer	false	none	none
»»»» txTrieRoot	string	false	none	none
»»»» witness_address	string	false	none	Block producer, in hex (`41…`) form.
»»»» parentHash	string	false	none	none
»»»» version	integer	false	none	none
»»»» timestamp	integer(int64)	false	none	none
»»» witness_signature	string	false	none	none
»» transactions	[object]	false	none	none
»»» txID	string	false	none	none
»»» raw_data	object	false	none	none
»»» raw_data_hex	string	false	none	The signable payload. `txID` is the SHA-256 of these bytes.
»»» signature	[string]	false	none	none
»»» ret	[object]	false	none	none
»»»» contractRet	string	false	none	none

Status Code 500

Name	Type	Required	Restrictions	Description
» error	string	false	none	none
» details	object	false	none	Present only on a few validation errors.