Blocks

Get a range of blocks by their height.

get

Given a range query parameter return an array of all the blocks within that range.

Query parameters

rangestringRequired

A range of integers. There is a max limit of 500 blocks per request.

Example: 0-499

eventDocsbooleanOptional

When set to true, every event will have an extra docs property with a string of the events documentation.

Default: false

extrinsicDocsbooleanOptional

When set to true, every extrinsic will have an extra docs property with a string of the extrinsics documentation.

Default: false

noFeesbooleanOptional

When set to true, the fee won't be calculated for the extrinsics.

Default: false

Responses

200

successful operation

application/json

400

invalid Block identifier supplied

application/json

get

HTTPcURLJavaScriptPython

GET /blocks HTTP/1.1
Host: dot-playbook.nownodes.io
Accept: */*

[
  {
    "number": "text",
    "hash": "text",
    "parentHash": "text",
    "stateRoot": "text",
    "extrinsicRoot": "text",
    "authorId": "text",
    "logs": [
      {
        "type": "text",
        "index": "text",
        "value": [
          "text"
        ]
      }
    ],
    "onInitialize": {
      "events": [
        {
          "method": "text",
          "data": [
            "text"
          ]
        }
      ]
    },
    "extrinsics": [
      {
        "method": {
          "pallet": "text",
          "method": "text"
        },
        "signature": {
          "signature": "text",
          "signer": "text"
        },
        "nonce": "text",
        "args": {},
        "tip": "text",
        "hash": "text",
        "info": {
          "weight": {
            "refTime": "text",
            "proofSize": "text"
          },
          "class": "Normal",
          "partialFee": "text",
          "kind": "text"
        },
        "era": "{\"mortalEra\":[\"64\", \"11\"]}",
        "events": [
          {
            "method": "text",
            "data": [
              "text"
            ]
          }
        ],
        "success": true,
        "paysFee": true
      }
    ],
    "onFinalize": {
      "events": [
        {
          "method": "text",
          "data": [
            "text"
          ]
        }
      ]
    },
    "finalized": true
  }
]

Get a block by its height or hash.

get

Returns a single block. BlockId can either be a block hash or a block height. Replaces /block/{number} from versions < v1.0.0.

Path parameters

blockIdstringRequired

Block identifier, as the block height or block hash.

Pattern: ^0[xX][0-9a-fA-F]{1,64}$|[0-9]{1,12}

Query parameters

eventDocsbooleanOptional

When set to true, every event will have an extra docs property with a string of the events documentation.

Default: false

extrinsicDocsbooleanOptional

When set to true, every extrinsic will have an extra docs property with a string of the extrinsics documentation.

Default: false

noFeesbooleanOptional

When set to true, the fee won't be calculated for the extrinsics.

Default: false

finalizedKeybooleanOptional

When set to false, this will override the chain-config, and omit the finalized key in the response. This can increase performance slightly by avoiding an additional RPC call to the node.

decodedXcmMsgsbooleanOptional

When set to true, this will show the decoded XCM messages within the extrinsics of the requested block.

Default: false

paraIdstringOptional

When it is set, this will return only the decoded XCM messages for the specified origin Parachain Id (originParaId). To activate this functionality, ensure that the decodedXcmMsgs parameter is set to true.

Responses

200

successful operation

application/json

Responseall of

Block information that includes the decoded XCM messages if any are found in the queried block. If not, the decodedXcmMsgs object will be returned with three empty arrays corresponding to each direction, horizontalMessages, downwardMessages, upwardMessages.

and

400

invalid Block identifier supplied

application/json

get

HTTPcURLJavaScriptPython

GET /blocks/{blockId} HTTP/1.1
Host: dot-playbook.nownodes.io
Accept: */*

{
  "number": "text",
  "hash": "text",
  "parentHash": "text",
  "stateRoot": "text",
  "extrinsicRoot": "text",
  "authorId": "text",
  "logs": [
    {
      "type": "text",
      "index": "text",
      "value": [
        "text"
      ]
    }
  ],
  "onInitialize": {
    "events": [
      {
        "method": "text",
        "data": [
          "text"
        ]
      }
    ]
  },
  "extrinsics": [
    {
      "method": {
        "pallet": "text",
        "method": "text"
      },
      "signature": {
        "signature": "text",
        "signer": "text"
      },
      "nonce": "text",
      "args": {},
      "tip": "text",
      "hash": "text",
      "info": {
        "weight": {
          "refTime": "text",
          "proofSize": "text"
        },
        "class": "Normal",
        "partialFee": "text",
        "kind": "text"
      },
      "era": "{\"mortalEra\":[\"64\", \"11\"]}",
      "events": [
        {
          "method": "text",
          "data": [
            "text"
          ]
        }
      ],
      "success": true,
      "paysFee": true
    }
  ],
  "onFinalize": {
    "events": [
      {
        "method": "text",
        "data": [
          "text"
        ]
      }
    ]
  },
  "finalized": true,
  "decodedXcmMsgs": {
    "horizontalMessages": {
      "0": {
        "originParaId": "text",
        "destinationParaId": "text",
        "data": {}
      }
    },
    "downwardMessages": [
      {
        "sentAt": "text",
        "msg": "text",
        "data": {}
      }
    ],
    "upwardMessages": [
      {
        "originParaId": "text",
        "data": {}
      }
    ]
  }
}