Kusama blocks API

The blocks API from Kusama — 8 operation(s) for blocks.

Documentation Provider Profile APIs.io OpenAPI GitHub

Kusama blocks API is one of 21 APIs that Kusama publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include blocks. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 8 operations across 8 paths, and defines 24 schemas. It is described by OpenAPI 3.0.0, at version 20.14.1.

Requests are made against 5 base URLs: https://polkadot-public-sidecar.parity-chains.parity.io/, https://kusama-public-sidecar.parity-chains.parity.io/, https://polkadot-asset-hub-public-sidecar.parity-chains.parity.io/, https://kusama-asset-hub-public-sidecar.parity-chains.parity.io/, http://localhost:8080.

8 operations 8 paths 24 schemas 8 GET

Metadata

The identity and technical contract details declared by the specification.

Specification

OpenAPI 3.0.0

API Version

20.14.1

Base URL

https://kusama-rpc.polkadot.io/

Contact

https://github.com/paritytech/substrate-api-sidecar

License

GPL-3.0-or-later

Resource Areas

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 8 GET. Each is listed below with its method, path, parameters, and response codes.

blocks 8

GET

/blocks

Get a range of blocks by their height.

getBlock 7 params → 200400

GET

/blocks/{blockId}

Get a block by its height or hash.

getBlockById 10 params → 200400

GET

/blocks/{blockId}/header

Get a block's header by its height or hash.

getBlockHeaderById 3 params → 200400

GET

/blocks/{blockId}/extrinsics/{extrinsicIndex}

Get an extrinsic by its extrinsicIndex and block height or hash. The pair blockId, extrinsicIndex is sometimes referred to as a Timepoint.

getExtrinsicByTimepoint 8 params → 200400

GET

/blocks/head

Get the most recently finalized block.

getHeadBlock 9 params → 200

GET

/blocks/head/header

Get information about the header of the most recent finalized block.

getLatestBlockHeader 3 params → 200400

GET

/blocks/{blockId}/extrinsics-raw

Get a blocks header & its extrinsics as hex values.

getBlockRawExtrinsics 3 params → 200400

GET

/blocks/{blockId}/para-inclusions

Get all parachain inclusion information for a relay chain block.

getBlockParaInclusions 2 params → 200400

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are Block (14 properties), Extrinsic (11 properties), BlockRaw (9 properties), BlockHeader (8 properties). Each schema is shown below with its type and property counts.

RuntimeDispatchInfo

object

RuntimeDispatchInfo for the transaction. Includes the partialFee.

4 properties

Blocks

array

SanitizedEvent

object

2 properties

BlockFinalize

object

Object with an array of SanitizedEvents that occurred during block construction finalization with the method and data for each.

1 property

Block

object

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.

14 properties

ExtrinsicIndex

object

A single extrinsic at a given block.

5 properties

BlockRaw

object

9 properties

DecodedXcmMsgs

object

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 d…

1 property

BlockIdentifiers

object

2 properties

DigestItem

object

3 properties

WeightsV2

object

2 properties

BlockWithDecodedXcmMsgs

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 e…

DecodedXcmMsgsHorizontalMessagesInParachain

array

Extrinsic

object

11 properties

ParaInclusionDescriptor

object

Candidate descriptor containing parachain inclusion metadata

6 properties

ExtrinsicMethod

object

Extrinsic method

2 properties

BlockHeader

object

8 properties

BlockInitialize

object

Object with an array of SanitizedEvents that occurred during block initialization with the method and data for each.

1 property

Signature

object

Object with signature and signer, or null if unsigned.

2 properties

Error

object

4 properties

ParaInclusion

object

Information about a single parachain inclusion event

7 properties

GenericExtrinsicEra

object

The return value for era can either be mortalEra, or immortalEra and is represented as an enum in substrate. immortalEra meaning the transaction is valid forev…

2 properties

BlockParaInclusions

object

Contains all decoded parachain inclusion information for a relay chain block

2 properties

DecodedXcmMsgsHorizontalMessagesInRelay

array

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

Other APIs Kusama publishes across the network.

Kusama JSON-RPC API

AE Profile APIs.io

Kusama accounts API

AE Profile APIs.io

Kusama ahm API

AE Profile APIs.io

Kusama contracts API

AE Profile APIs.io

Kusama coretime API

AE Profile APIs.io

Kusama node API

AE Profile APIs.io

Kusama pallets API

AE Profile APIs.io

Kusama paras API

AE Profile APIs.io

Kusama rc accounts API

AE Profile APIs.io

Kusama rc API

AE Profile APIs.io

Kusama rc blocks API

AE Profile APIs.io

Kusama rc node API

AE Profile APIs.io

#blocks

← Back to K APIs

Discovery

Learnings

Guidance

Toolbox

Alignment

API Evangelist LLC

Kusama blocks API

Metadata

Paths & Operations 8

Schemas 24

Specification

Source

API Details

Provider

Explore more

Discovery

Learnings

Guidance

Toolbox

Alignment

API Evangelist LLC

Kusama blocks API

Metadata

Paths & Operations 8

Schemas 24

Specification

Source

More from Kusama 12

API Details

Provider

Explore more