Head

Get the most recently finalized block.

get

Returns the most recently finalized block. Replaces /block from versions < v1.0.0.

Query parameters

finalizedbooleanOptional

Boolean representing whether or not to get the finalized head. If it is not set the value defaults to true. When set to false it will attempt to get the newest known block, which may not be finalized.

Default: true

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

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

application/json

all ofOptional

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.

Note: Block finalization does not correspond to consensus, i.e. whether the block is in the canonical chain. It denotes the finalization of block construction.

Object with three arrays, one for every XCM direction. The arrays are populated or left empty based on the direction of the current XCM message that is being decoded. The XCM messages can be Upward and/or Horizontal (in transit) messages when connected to a Relay chain. When connected to a Parachain, the messages can be Downward and/or Horizontal. One or more messages can be present in a single block. In case of multiple messages from the same paraIds (originParaId and/or destinationParaId), the messages will be shown under the field data.

get

HTTPcURLJavaScriptPython

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

200

successful operation

{
  "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": {}
      }
    ]
  }
}