Monitor

Monitor active_chains

get

Monitor every chain creation and destruction. Currently active chains will be given as first elements

Authorizations

api-keyAuth

api-keystringRequired

Responses

200

Valid response

application/json

or

or

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/monitor/active_chains

HTTPcURLJavaScriptPython

GET /monitor/active_chains HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

[
  {
    "chain_id": "text"
  }
]

Monitor applied blocks

get

Monitor all blocks that are successfully applied and stored by the node, disregarding whether they were selected as the new head or not.

Authorizations

api-keyAuth

api-keystringRequired

Query parameters

protocolstringOptional

Protocol_hash (Base58Check-encoded)

next_protocolstringOptional

Protocol_hash (Base58Check-encoded)

chainstringOptional

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

chain_idone ofRequired

stringOptional

or

hashone ofRequired

stringOptional

or

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/monitor/applied_blocks

HTTPcURLJavaScriptPython

GET /monitor/applied_blocks HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "chain_id": "text",
  "hash": "text",
  "header": {
    "level": 1,
    "proto": 1,
    "predecessor": "text",
    "timestamp": "text",
    "validation_pass": 1,
    "operations_hash": "text",
    "fitness": [
      "text"
    ],
    "context": "text",
    "protocol_data": "text"
  },
  "operations": [
    [
      {
        "branch": "text",
        "data": "text"
      }
    ]
  ]
}

Monitor bootstrapped

get

Wait for the node to have synchronized its chain with a few peers (configured by the node's administrator), streaming head updates that happen during the bootstrapping process, and closing the stream at the end. If the node was already bootstrapped, returns the current head immediately.

Authorizations

api-keyAuth

api-keystringRequired

Responses

200

Valid response

application/json

blockone ofRequired

stringOptional

or

timestampone ofRequired

A timestamp as seen by the protocol: second-level precision, epoch based.

stringOptional

or

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/monitor/bootstrapped

HTTPcURLJavaScriptPython

GET /monitor/bootstrapped HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "block": "text",
  "timestamp": "text"
}

Monitor commit hash

get

DEPRECATED: use version instead.

Authorizations

api-keyAuth

api-keystringRequired

Responses

200

Valid response

application/json

Either a plain UTF8 string, or a sequence of bytes for strings that contain invalid byte sequences.

stringOptional

or

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/monitor/commit_hash

HTTPcURLJavaScriptPython

GET /monitor/commit_hash HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

text

Monitor all blocks that are successfully validated

get

Monitor all blocks that are successfully validated and applied by the node and selected as the new head of the given 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'.

Query parameters

protocolstringOptional

Protocol_hash (Base58Check-encoded)

next_protocolstringOptional

Protocol_hash (Base58Check-encoded)

Responses

200

Valid response

application/json

Block header. It contains both shell and protocol specific data.

hashone ofRequired

stringOptional

or

levelinteger · min: -2147483648 · max: 2147483647Required

protointeger · max: 255Required

predecessorone ofRequired

stringOptional

or

timestampone ofRequired

A timestamp as seen by the protocol: second-level precision, epoch based.

stringOptional

or

validation_passinteger · max: 255Required

operations_hashone ofRequired

stringOptional

or

fitnessstring[]Required

The fitness, or score, of a block, that allow the Tezos to decide which chain is the best. A fitness value is a list of byte sequences. They are compared as follows: shortest lists are smaller; lists of the same length are compared according to the lexicographical order.

contextone ofRequired

stringOptional

or

protocol_datastringRequiredPattern: ^([a-zA-Z0-9][a-zA-Z0-9])*$

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/monitor/heads/{chain_id}

HTTPcURLJavaScriptPython

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

{
  "hash": "text",
  "level": 1,
  "proto": 1,
  "predecessor": "text",
  "timestamp": "text",
  "validation_pass": 1,
  "operations_hash": "text",
  "fitness": [
    "text"
  ],
  "context": "text",
  "protocol_data": "text"
}

Monitor protocols

get

Monitor all economic protocols that are retrieved and successfully loaded and compiled by the node.

Authorizations

api-keyAuth

api-keystringRequired

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

/monitor/protocols

HTTPcURLJavaScriptPython

GET /monitor/protocols HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

text

Monitor validated blocks

get

Monitor all blocks that were successfully validated by the node but are not applied nor stored yet, disregarding whether they are going to be selected as the new head or not.

Authorizations

api-keyAuth

api-keystringRequired

Query parameters

protocolstringOptional

Protocol_hash (Base58Check-encoded)

next_protocolstringOptional

Protocol_hash (Base58Check-encoded)

chainstringOptional

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

chain_idone ofRequired

stringOptional

or

hashone ofRequired

stringOptional

or

400

Bad Request - missing or invalid parameters

application/json

404

Not Found error

application/json

500

Internal server error

application/json

get

/monitor/validated_blocks

HTTPcURLJavaScriptPython

GET /monitor/validated_blocks HTTP/1.1
Host: xtz.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "chain_id": "text",
  "hash": "text",
  "header": {
    "level": 1,
    "proto": 1,
    "predecessor": "text",
    "timestamp": "text",
    "validation_pass": 1,
    "operations_hash": "text",
    "fitness": [
      "text"
    ],
    "context": "text",
    "protocol_data": "text"
  },
  "operations": [
    [
      {
        "branch": "text",
        "data": "text"
      }
    ]
  ]
}