Chains

Lists block hashes

get

Lists block hashes from '', up to the last checkpoint, sorted with decreasing fitness. Without arguments it returns the head of the chain. Optional arguments allow to return the list of predecessors of a given block or of a set of blocks.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

chain_idstringRequired

A chain identifier. This is either a chain hash in Base58Check notation or a one the predefined aliases: 'main', 'test'.

Query parameters

lengthstringOptional

The requested number of predecessors to return (per request; see next argument).

headstringOptional

block_hash (Base58Check-encoded) An empty argument requests blocks starting with the current head. A non empty list allows to request one or more specific fragments of the chain.

min_datestringOptional

A date in seconds from epoch When min_date is provided, blocks with a timestamp before min_date are filtered out. However, if the length parameter is also provided, then up to that number of predecessors will be returned regardless of their date.

Responses

200

Valid response

application/json

itemsone ofOptional

stringOptional

or

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/chains/{chain_id}/blocks

HTTPcURLJavaScriptPython

GET /chains/{chain_id}/blocks HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

[
  [
    "text"
  ]
]

Chain ID

get

The chain unique identifier.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

chain_idstringRequired

A chain identifier. This is either a chain hash in Base58Check notation or a one the predefined aliases: 'main', 'test'.

Responses

200

Valid response

application/json

stringOptional

or

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/chains/{chain_id}/chain_id

HTTPcURLJavaScriptPython

GET /chains/{chain_id}/chain_id HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

text

Checkpoint

get

DEPRECATED: use ../levels/{checkpoint, savepoint, caboose, history_mode} instead. The current checkpoint for this chain.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

chain_idstringRequired

A chain identifier. This is either a chain hash in Base58Check notation or a one the predefined aliases: 'main', 'test'.

Responses

200

Valid response

application/json

savepointinteger · min: -2147483648 · max: 2147483647Required

cabooseinteger · min: -2147483648 · max: 2147483647Required

history_modeone ofRequired

Storage mode for the Tezos shell.

string · enumOptional

Archive mode retains every block and operations since the genesis block including their metadata and their associated contexts.

Possible values:

or

or

or

string · enumOptional

Full mode with default number of additional cycles.

Possible values:

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/chains/{chain_id}/checkpoint

HTTPcURLJavaScriptPython

GET /chains/{chain_id}/checkpoint HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "block": {
    "level": 1,
    "proto": 1,
    "predecessor": "text",
    "timestamp": "text",
    "validation_pass": 1,
    "operations_hash": "text",
    "fitness": [
      "text"
    ],
    "context": "text",
    "protocol_data": "text"
  },
  "savepoint": 1,
  "caboose": 1,
  "history_mode": "archive"
}

Invalid blocks

get

Lists blocks that have been declared invalid along with the errors that led to them being declared invalid.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

chain_idstringRequired

A chain identifier. This is either a chain hash in Base58Check notation or a one the predefined aliases: 'main', 'test'.

Responses

200

Valid response

application/json

blockone ofRequired

stringOptional

or

levelinteger · min: -2147483648 · max: 2147483647Required

errorsanyRequired

The full list of errors is available with the global RPC GET errors

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/chains/{chain_id}/invalid_blocks

HTTPcURLJavaScriptPython

GET /chains/{chain_id}/invalid_blocks HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

[
  {
    "block": "text",
    "level": 1,
    "errors": null
  }
]

The errors that appears during the block (in)validation.

get

The errors that appears during the block (in)validation.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

chain_idstringRequired

A chain identifier. This is either a chain hash in Base58Check notation or a one the predefined aliases: 'main', 'test'.

block_hashstringRequired

block_hash (Base58Check-encoded)

Responses

200

Valid response

application/json

blockone ofRequired

stringOptional

or

levelinteger · min: -2147483648 · max: 2147483647Required

errorsanyRequired

The full list of errors is available with the global RPC GET errors

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/chains/{chain_id}/invalid_blocks/{block_hash}

HTTPcURLJavaScriptPython

GET /chains/{chain_id}/invalid_blocks/{block_hash} HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "block": "text",
  "level": 1,
  "errors": null
}

Is bootstrapped

get

The bootstrap status of a chain

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

chain_idstringRequired

A chain identifier. This is either a chain hash in Base58Check notation or a one the predefined aliases: 'main', 'test'.

Responses

200

Valid response

application/json

bootstrappedbooleanRequired

sync_statestring · enumRequired

If 'unsynced', the node is not currently synchronized with of its peers (it is probably still bootstrapping and its head is lagging behind the chain's). If 'synced', the node considers itself synchronized with its peers and the current head timestamp is recent. If 'stuck', the node considers itself synchronized with its peers but the chain seems to be halted from its viewpoint.

Possible values:

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/chains/{chain_id}/is_bootstrapped

HTTPcURLJavaScriptPython

GET /chains/{chain_id}/is_bootstrapped HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "bootstrapped": true,
  "sync_state": "stuck"
}

Caboose

get

The current caboose for this chain.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

chain_idstringRequired

A chain identifier. This is either a chain hash in Base58Check notation or a one the predefined aliases: 'main', 'test'.

Responses

200

Valid response

application/json

block_hashone ofRequired

stringOptional

or

levelinteger · min: -2147483648 · max: 2147483647Required

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/chains/{chain_id}/levels/caboose

HTTPcURLJavaScriptPython

GET /chains/{chain_id}/levels/caboose HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "block_hash": "text",
  "level": 1
}

Checkpoint

get

The current checkpoint for this chain.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

chain_idstringRequired

A chain identifier. This is either a chain hash in Base58Check notation or a one the predefined aliases: 'main', 'test'.

Responses

200

Valid response

application/json

block_hashone ofRequired

stringOptional

or

levelinteger · min: -2147483648 · max: 2147483647Required

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/chains/{chain_id}/levels/checkpoint

HTTPcURLJavaScriptPython

GET /chains/{chain_id}/levels/checkpoint HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "block_hash": "text",
  "level": 1
}

Savepoint

get

The current savepoint for this chain.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

chain_idstringRequired

A chain identifier. This is either a chain hash in Base58Check notation or a one the predefined aliases: 'main', 'test'.

Responses

200

Valid response

application/json

block_hashone ofRequired

stringOptional

or

levelinteger · min: -2147483648 · max: 2147483647Required

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/chains/{chain_id}/levels/savepoint

HTTPcURLJavaScriptPython

GET /chains/{chain_id}/levels/savepoint HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "block_hash": "text",
  "level": 1
}