Home

Polkadot REST API

v0.1.1
Base URL
https://dotassethub-playbook.nownodes.io

High-performance Rust REST API for Substrate/Polkadot blockchain data. Drop-in replacement for substrate-api-sidecar.

Authentication

api-keyAuthapiKey

API Key: api-key in header

Asset Hub / PLAYBOOK

health

Health check

Health check

GET
https://dotassethub-playbook.nownodes.io/v1/health

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the health status of the API server.

Response

202Accepted

API is healthy

node

Connected node information

Node network info

GET
https://dotassethub-playbook.nownodes.io/v1/node/network

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the node's network information including peer count, syncing status, and local peer ID.

Response

200OK

Node network information

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Transaction pool

GET
https://dotassethub-playbook.nownodes.io/v1/node/transaction-pool

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the node's transaction pool with optional fee information.

Parameters

includeFeebooleanquery

Include fee details for each transaction

Response

200OK

Transaction pool entries

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Node version

GET
https://dotassethub-playbook.nownodes.io/v1/node/version

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the node's version information including client version, implementation name, and chain name.

Response

200OK

Node version information

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

version

API version

API version

GET
https://dotassethub-playbook.nownodes.io/v1/version

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the current version of the Polkadot REST API.

Response

200OK

API version

blocks

Block queries and extrinsic data

Get blocks by range

GET
https://dotassethub-playbook.nownodes.io/v1/blocks

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns a collection of blocks given a numeric range. Range is inclusive and limited to 500 blocks.

Parameters

rangestringquery

Block range in format 'start-end' (e.g. '100-200')

eventDocsbooleanquery

Include documentation for events

extrinsicDocsbooleanquery

Include documentation for extrinsics

noFeesbooleanquery

Skip fee calculation for extrinsics

useRcBlockbooleanquery

Treat range as Relay Chain blocks

useEvmFormatbooleanquery

Convert AccountId32 addresses to EVM format for revive pallet events

Response

200OK

Array of block information

400Bad Request

Invalid range parameter

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get latest block

GET
https://dotassethub-playbook.nownodes.io/v1/blocks/head

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the latest finalized or canonical block with full extrinsic and event details.

Parameters

finalizedbooleanquery

When true (default), returns finalized head. When false, returns canonical head.

eventDocsbooleanquery

Include documentation for events

extrinsicDocsbooleanquery

Include documentation for extrinsics

noFeesbooleanquery

Skip fee calculation for extrinsics

decodedXcmMsgsbooleanquery

Decode and include XCM messages

paraIdinteger<int32>>= 0query

Filter XCM messages by parachain ID

useRcBlockbooleanquery

When true, use relay chain head to find corresponding Asset Hub blocks

useEvmFormatbooleanquery

Convert AccountId32 addresses to EVM format for revive pallet events

Response

200OK

Latest block information

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get head block header

GET
https://dotassethub-playbook.nownodes.io/v1/blocks/head/header

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the header of the latest finalized or canonical block (lightweight, no extrinsics/events).

Parameters

finalizedbooleanquery

When true (default), returns finalized head header. When false, returns canonical head header.

useRcBlockbooleanquery

Treat as Relay Chain block and return Asset Hub blocks

Response

200OK

Block header information

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get block by ID

GET
https://dotassethub-playbook.nownodes.io/v1/blocks/{blockId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns block information for a given block identifier (hash or number), including extrinsics, events, and fees.

Parameters

blockIdstringrequiredpath

Block height number or block hash

eventDocsbooleanquery

Include documentation for events

extrinsicDocsbooleanquery

Include documentation for extrinsics

noFeesbooleanquery

Skip fee calculation for extrinsics

finalizedKeybooleanquery

When true (default), include finalized status in response

decodedXcmMsgsbooleanquery

Decode and include XCM messages

paraIdinteger<int32>>= 0query

Filter XCM messages by parachain ID

useRcBlockbooleanquery

Treat blockId as Relay Chain block and return Asset Hub blocks

useEvmFormatbooleanquery

Convert AccountId32 addresses to EVM format for revive pallet events

Response

200OK

Block information

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get raw extrinsics

GET
https://dotassethub-playbook.nownodes.io/v1/blocks/{blockId}/extrinsics-raw

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns raw block data with hex-encoded extrinsics for a given block identifier. The extrinsics are returned as raw hex strings without decoding.

Parameters

blockIdstringrequiredpath

Block height number or block hash

useRcBlockbooleanquery

When true, treat blockId as Relay Chain block and return Asset Hub blocks

Response

200OK

Raw block data with hex-encoded extrinsics

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get extrinsic by index

GET
https://dotassethub-playbook.nownodes.io/v1/blocks/{blockId}/extrinsics/{extrinsicIndex}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns a specific extrinsic from a block by its index within the block.

Parameters

blockIdstringrequiredpath

Block height number or block hash

extrinsicIndexstringrequiredpath

Index of the extrinsic within the block

eventDocsbooleanquery

Include documentation for events

extrinsicDocsbooleanquery

Include documentation for extrinsics

noFeesbooleanquery

Skip fee calculation

useRcBlockbooleanquery

When true, treat blockId as Relay Chain block and return Asset Hub extrinsics

useEvmFormatbooleanquery

Convert AccountId32 addresses to EVM format for revive pallet events

Response

200OK

Extrinsic details

400Bad Request

Invalid block identifier or extrinsic index

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get block header by ID

GET
https://dotassethub-playbook.nownodes.io/v1/blocks/{blockId}/header

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the header of the specified block (lightweight, no extrinsics/events).

Parameters

blockIdstringrequiredpath

Block height number or block hash

useRcBlockbooleanquery

Treat blockId as Relay Chain block and return Asset Hub blocks

Response

200OK

Block header information

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get parachain inclusions

GET
https://dotassethub-playbook.nownodes.io/v1/blocks/{blockId}/para-inclusions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns parachain inclusion information for a given relay chain block. Extracts CandidateIncluded events from the ParaInclusion pallet.

Parameters

blockIdstringrequiredpath

Block height number or block hash

paraIdinteger<int32>>= 0query

Filter results by a specific parachain ID

Response

200OK

Parachain inclusion information

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

accounts

Account balance, staking, and proxy information

Compare account addresses

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/compare

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Compares multiple SS58 addresses to determine if they have the same underlying public key.

Parameters

addressesstringrequiredquery

Comma-separated list of SS58 addresses to compare (max 30)

Response

200OK

Comparison result

400Bad Request

Invalid parameters

Account asset approvals

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/asset-approvals

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns asset approval information for a given account, asset, and delegate.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

assetIdstringrequiredquery

The asset ID to query approval for

delegatestringrequiredquery

The delegate address with spending approval

Response

200OK

Asset approval information

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Account asset balances

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/asset-balances

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns asset balances for a given account on Asset Hub chains.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

assetsstringquery

Comma-separated list of asset IDs to query

showEmptybooleanquery

When true, include assets with zero balance (default: false)

Response

200OK

Account asset balances

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Account balance info

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/balance-info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns balance information for a given account including free, reserved, and locked balances.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

tokenstringquery

Token symbol for chains with multiple tokens

denominatedbooleanquery

When true, denominate balances using chain decimals

Response

200OK

Account balance information

400Bad Request

Invalid account or block parameter

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Convert account format

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/convert

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Converts an account address between different SS58 formats and key types.

Parameters

accountIdstringrequiredpath

SS58-encoded account address or hex public key

schemestringquery

Cryptographic scheme: ed25519, sr25519, or ecdsa (default: sr25519)

prefixinteger<int32>>= 0query

SS58 prefix number (default: 42)

publicKeybooleanquery

If true, treat input as a public key

Response

200OK

Converted account information

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Account foreign asset balances

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/foreign-asset-balances

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns foreign asset balances for a given account on Asset Hub chains. Foreign assets use XCM MultiLocation as their identifier.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

foreignAssetsArray<string>query

List of multilocation JSON strings to filter by

showEmptybooleanquery

When true, include assets with zero balance (default: false)

Response

200OK

Foreign asset balances

400Bad Request

Invalid account or parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Account pool asset approvals

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/pool-asset-approvals

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns pool asset approval information for a given account, asset, and delegate.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

assetIdstringrequiredquery

The pool asset ID to query approval for

delegatestringrequiredquery

The delegate address with spending approval

Response

200OK

Pool asset approval information

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Account pool asset balances

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/pool-asset-balances

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns pool asset balances for a given account.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

assetsstringquery

Comma-separated list of pool asset IDs to query

showEmptybooleanquery

When true, include assets with zero balance (default: false)

Response

200OK

Pool asset balances

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Account proxy info

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/proxy-info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns proxy information for a given account including delegated proxies and their types.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Proxy information

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Account staking info

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/staking-info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns staking information for a given stash account including bonded amount, controller, and nominations.

Parameters

accountIdstringrequiredpath

SS58-encoded stash account address

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

includeClaimedRewardsbooleanquery

When true, include claimed rewards in the response

Response

200OK

Staking information

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Account staking payouts

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/staking-payouts

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns staking payout history for a given account including era rewards and claimed status.

Parameters

accountIdstringrequiredpath

SS58-encoded stash account address

atstringquery

Block hash or number to query at

depthstringquery

Number of eras to query (default: 1)

erastringquery

The era to query at (default: active_era - 1)

unclaimedOnlybooleanquery

Only show unclaimed rewards (default: true)

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Staking payout information

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Validate account address

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/validate

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Validates an SS58-encoded account address and returns details about its format.

Parameters

accountIdstringrequiredpath

SS58-encoded account address to validate

atstringquery

Block hash or number (accepted for API consistency)

Response

200OK

Validation result

Account vesting info

GET
https://dotassethub-playbook.nownodes.io/v1/accounts/{accountId}/vesting-info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns vesting information for a given account including vesting schedules and locked amounts.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

includeClaimablebooleanquery

When true, calculate vested amounts

Response

200OK

Vesting information

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

pallets

Runtime pallet metadata, storage, constants, events, errors

Liquidity pools

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/asset-conversion/liquidity-pools

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all liquidity pools from the AssetConversion pallet.

Parameters

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Liquidity pools

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Next available pool ID

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/asset-conversion/next-available-id

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the next available pool asset ID from the AssetConversion pallet.

Parameters

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Next available ID

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Asset info

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/assets/{assetId}/asset-info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns details for a specific asset including supply, admin, and metadata.

Parameters

assetIdstringrequiredpath

Asset ID

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Asset information

404Not Found

Asset not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Foreign assets

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/foreign-assets

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all foreign assets with their details and metadata. Foreign assets use XCM MultiLocation as their identifier.

Parameters

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Foreign assets list

400Bad Request

Not supported on this chain

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Nomination pools info

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/nomination-pools/info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns global nomination pools statistics and configuration.

Parameters

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Nomination pools information

400Bad Request

Not supported on this chain

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Nomination pool details

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/nomination-pools/{poolId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns details for a specific nomination pool.

Parameters

poolIdstringrequiredpath

Pool ID

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Pool details

404Not Found

Pool not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

On-going referenda

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/on-going-referenda

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all currently active referenda from the Referenda pallet.

Parameters

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Active referenda

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Pool asset info

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/pool-assets/{assetId}/asset-info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns details for a specific pool asset including supply, admin, and metadata.

Parameters

assetIdstringrequiredpath

Pool asset ID

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Pool asset information

404Not Found

Pool asset not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Staking progress

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/staking/progress

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns staking progress including era, session info, and validator counts.

Parameters

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Staking progress information

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Staking validators

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/staking/validators

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the list of active validators and their info.

Parameters

atstringquery

Block hash or number to query at

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Validator information

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Pallet constants

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/{palletId}/consts

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all constants defined in a pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

atstringquery

Block hash or number to query at

onlyIdsbooleanquery

Only return constant names

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Pallet constants

400Bad Request

Invalid pallet

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Pallet constant value

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/{palletId}/consts/{constantItemId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the value and metadata of a specific constant in a pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

constantItemIdstringrequiredpath

Name of the constant

atstringquery

Block hash or number to query at

metadatabooleanquery

Include metadata

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Constant value

400Bad Request

Invalid parameters

404Not Found

Constant not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Pallet dispatchables

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/{palletId}/dispatchables

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the dispatchable calls defined in a pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

atstringquery

Block hash or number to query at

onlyIdsbooleanquery

Only return dispatchable names

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Pallet dispatchables

400Bad Request

Invalid pallet

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Pallet dispatchable details

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/{palletId}/dispatchables/{dispatchableId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns a single dispatchable call defined in a pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

dispatchableIdstringrequiredpath

Name of the dispatchable

atstringquery

Block hash or number to query at

metadatabooleanquery

Include metadata

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Dispatchable details

404Not Found

Dispatchable not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Pallet errors

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/{palletId}/errors

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all errors defined in a pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

atstringquery

Block hash or number to query at

onlyIdsbooleanquery

Only return error names

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Pallet errors

400Bad Request

Invalid pallet

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Pallet error details

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/{palletId}/errors/{errorItemId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns metadata for a specific error in a pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

errorItemIdstringrequiredpath

Name of the error

atstringquery

Block hash or number to query at

metadatabooleanquery

Include metadata

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Error details

404Not Found

Error not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get pallet events

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/{palletId}/events

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all events defined in a pallet.

Parameters

palletIdstringrequiredpath

Pallet name or index

atstringquery

Block identifier (number or hash)

onlyIdsbooleanquery

Only return event names

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Pallet events

400Bad Request

Invalid request

404Not Found

Pallet not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get pallet event item

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/{palletId}/events/{eventItemId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns metadata for a specific event in a pallet.

Parameters

palletIdstringrequiredpath

Pallet name or index

eventItemIdstringrequiredpath

Event name

atstringquery

Block identifier (number or hash)

metadatabooleanquery

Include full event metadata

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Event item details

400Bad Request

Invalid request

404Not Found

Pallet or event not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Pallet storage items

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/{palletId}/storage

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the list of storage items for a given pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

atstringquery

Block hash or number to query at

onlyIdsbooleanquery

Only return storage item names

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Pallet storage items

400Bad Request

Invalid pallet or parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Pallet storage item value

GET
https://dotassethub-playbook.nownodes.io/v1/pallets/{palletId}/storage/{storageItemId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the value of a specific storage item in a pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

storageItemIdstringrequiredpath

Name of the storage item

atstringquery

Block hash or number to query at

keys[]Array<string>query

Storage key arguments

metadatabooleanquery

Include metadata for the storage item

useRcBlockbooleanquery

Treat 'at' as relay chain block identifier

Response

200OK

Storage item value

400Bad Request

Invalid parameters

404Not Found

Storage item not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

runtime

Runtime specification, metadata, and code

Runtime Wasm code

GET
https://dotassethub-playbook.nownodes.io/v1/runtime/code

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the Wasm code blob of the Substrate runtime at a given block.

Parameters

atstringquery

Block hash or number to query at

Response

200OK

Runtime code

400Bad Request

Invalid block parameter

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Runtime metadata

GET
https://dotassethub-playbook.nownodes.io/v1/runtime/metadata

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the decoded runtime metadata in JSON format.

Parameters

atstringquery

Block hash or number to query at

Response

200OK

Runtime metadata

400Bad Request

Invalid block parameter

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Available metadata versions

GET
https://dotassethub-playbook.nownodes.io/v1/runtime/metadata/versions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the available metadata versions at a given block.

Parameters

atstringquery

Block hash or number to query at

Response

200OK

List of available metadata versions

400Bad Request

Invalid block parameter

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Runtime metadata by version

GET
https://dotassethub-playbook.nownodes.io/v1/runtime/metadata/{version}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the metadata at a specific version. The version parameter should be in 'vX' format (e.g., 'v14', 'v15').

Parameters

versionstringrequiredpath

Metadata version (e.g., 'v14', 'v15')

atstringquery

Block hash or number to query at

Response

200OK

Runtime metadata at specified version

400Bad Request

Invalid version format or block parameter

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Runtime specification

GET
https://dotassethub-playbook.nownodes.io/v1/runtime/spec

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the runtime specification including version, APIs, and chain properties.

Parameters

atstringquery

Block hash or number to query at

Response

200OK

Runtime specification

400Bad Request

Invalid block parameter

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

transaction

Transaction submission, fee estimation, and construction material

Submit transaction

POST
https://dotassethub-playbook.nownodes.io/v1/transaction

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Submit a signed extrinsic to the transaction pool.

Body

application/json

Signed extrinsic with 'tx' field containing hex-encoded transaction

object

Response

200OK

Transaction hash

400Bad Request

Invalid transaction

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Dry run transaction

POST
https://dotassethub-playbook.nownodes.io/v1/transaction/dry-run

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Dry run a transaction to check validity without submitting.

Body

application/json

Transaction with 'tx', 'senderAddress', and optional 'at' fields

object

Response

200OK

Dry run result

400Bad Request

Invalid transaction

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Estimate transaction fee

POST
https://dotassethub-playbook.nownodes.io/v1/transaction/fee-estimate

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Estimate the fee for a transaction.

Body

application/json

Transaction with 'tx' field containing hex-encoded transaction

object

Response

200OK

Fee estimate

400Bad Request

Invalid transaction

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Transaction construction material

GET
https://dotassethub-playbook.nownodes.io/v1/transaction/material

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns network information needed for transaction construction including genesis hash, spec version, and optionally metadata.

Parameters

atstringquery

Block hash or number to query at

noMetabooleanquery

DEPRECATED: If true, metadata is not included

metadatastringquery

Metadata format: 'json' or 'scale'

Response

200OK

Transaction material

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Transaction material with versioned metadata

GET
https://dotassethub-playbook.nownodes.io/v1/transaction/material/{metadataVersion}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns transaction construction material with metadata at a specific version.

Parameters

metadataVersionstringrequiredpath

Metadata version (e.g., 'v14', 'v15')

atstringquery

Block hash or number to query at

noMetabooleanquery

DEPRECATED: If true, metadata is not included

metadatastringquery

Metadata format: 'json' or 'scale'

Response

200OK

Transaction material with versioned metadata

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Generate metadata blob

POST
https://dotassethub-playbook.nownodes.io/v1/transaction/metadata-blob

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Generates a metadata blob for transaction signing with the CheckMetadataHash extension.

Body

application/json

Request with 'tx' field and optional 'at' block

object

Response

200OK

Metadata blob

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Parse transaction

POST
https://dotassethub-playbook.nownodes.io/v1/transaction/parse

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Decode a raw transaction and return its components without executing or submitting it. Returns the decoded pallet/method, call arguments, signature info, nonce, tip, era, and hash. Note: This endpoint uses the chain's current (latest) metadata for decoding. Transactions created for older runtime versions may fail to decode if the extrinsic format has changed.

Body

application/json

Transaction with 'tx' field containing hex-encoded extrinsic

Request body for transaction parsing.

txstring

Hex-encoded extrinsic with optional 0x prefix.

Response

200OK

Parsed transaction

400Bad Request

Invalid transaction

500Internal Server Error

Internal server error

coretime

Coretime system information

Get coretime info

GET
https://dotassethub-playbook.nownodes.io/v1/coretime/info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns coretime chain status information including the last committed timeslice.

Parameters

atstringquery

Block identifier (number or hash)

Response

200OK

Coretime info

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get coretime leases

GET
https://dotassethub-playbook.nownodes.io/v1/coretime/leases

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all leases registered on a coretime chain with task IDs and validity timeslices.

Parameters

atstringquery

Block identifier (number or hash)

Response

200OK

Coretime leases

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get coretime overview

GET
https://dotassethub-playbook.nownodes.io/v1/coretime/overview

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns an overview of all cores with assignments, queue state, workload, workplan, and regions.

Parameters

atstringquery

Block identifier (number or hash)

Response

200OK

Coretime overview

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get coretime regions

GET
https://dotassethub-playbook.nownodes.io/v1/coretime/regions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all regions on a coretime chain including begin/end timeslices, core, owner, and mask.

Parameters

atstringquery

Block identifier (number or hash)

Response

200OK

Coretime regions

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get coretime potential renewals

GET
https://dotassethub-playbook.nownodes.io/v1/coretime/renewals

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns potential renewals on a coretime chain sorted by core index, including price, completion status, and task assignment.

Parameters

atstringquery

Block identifier (number or hash)

Response

200OK

Coretime renewals

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Get coretime reservations

GET
https://dotassethub-playbook.nownodes.io/v1/coretime/reservations

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all reservations on a coretime chain. Reserved cores are permanently allocated and not available for sale.

Parameters

atstringquery

Block identifier (number or hash)

Response

200OK

Coretime reservations

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

paras

Parachain inclusion data

Parachain inclusion data

GET
https://dotassethub-playbook.nownodes.io/v1/paras/{number}/inclusion

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns inclusion information for a given parachain block, searching relay chain blocks for when the parachain block was included.

Parameters

numberstringrequiredpath

Parachain block number

depthstringquery

Search depth for relay chain blocks (max 100, default 10, must be divisible by 5)

Response

200OK

Parachain inclusion information

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

ahm

Asset Hub Migration information

Asset Hub Migration info

GET
https://dotassethub-playbook.nownodes.io/v1/ahm-info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns information about the Asset Hub migration, including start and end blocks for both relay chain and Asset Hub.

Response

200OK

AHM migration boundaries

404Not Found

No migration data available

capabilities

API capabilities and chain pallets

API capabilities

GET
https://dotassethub-playbook.nownodes.io/v1/capabilities

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the chain name and list of available pallets in the runtime metadata.

Parameters

atstringquery

Block hash or number to query at

Response

200OK

Chain capabilities

400Bad Request

Invalid block parameter

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

rc

Relay chain endpoints (available on parachains only)

RC get balance info

GET
https://dotassethub-playbook.nownodes.io/v1/rc/accounts/{accountId}/balance-info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns balance information for a given account on the relay chain.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block identifier (number or hash)

tokenstringquery

Token symbol (defaults to native token)

denominatedbooleanquery

Denominate balances using chain decimals

Response

200OK

Balance information

400Bad Request

Invalid account address

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get proxy info

GET
https://dotassethub-playbook.nownodes.io/v1/rc/accounts/{accountId}/proxy-info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns proxy information for a given account on the relay chain.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block identifier (number or hash)

Response

200OK

Proxy information

400Bad Request

Invalid account address

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get staking info

GET
https://dotassethub-playbook.nownodes.io/v1/rc/accounts/{accountId}/staking-info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns staking information for a given stash account on the relay chain.

Parameters

accountIdstringrequiredpath

SS58-encoded stash account address

atstringquery

Block identifier (number or hash)

includeClaimedRewardsbooleanquery

When true, include claimed rewards in the response

Response

200OK

Staking information

400Bad Request

Invalid account address

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get staking payouts

GET
https://dotassethub-playbook.nownodes.io/v1/rc/accounts/{accountId}/staking-payouts

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns staking payout information for a given account on the relay chain.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block identifier (number or hash)

depthinteger<int32>>= 0query

Number of eras to query (default: 1)

erainteger<int32>>= 0query

The era to query at (default: active_era - 1)

unclaimedOnlybooleanquery

Only show unclaimed rewards (default: true)

Response

200OK

Staking payouts

400Bad Request

Invalid account address

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get vesting info

GET
https://dotassethub-playbook.nownodes.io/v1/rc/accounts/{accountId}/vesting-info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns vesting information for a given account on the relay chain.

Parameters

accountIdstringrequiredpath

SS58-encoded account address

atstringquery

Block identifier (number or hash)

Response

200OK

Vesting information

400Bad Request

Invalid account address

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get blocks by range

GET
https://dotassethub-playbook.nownodes.io/v1/rc/blocks

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns relay chain blocks within a specified range (max 500 blocks).

Parameters

rangestringquery

Block range (e.g., '100-200')

eventDocsbooleanquery

Include event documentation

extrinsicDocsbooleanquery

Include extrinsic documentation

noFeesbooleanquery

Skip fee calculation

decodedXcmMsgsbooleanquery

Decode and include XCM messages

paraIdinteger<int32>>= 0query

Filter XCM messages by parachain ID

Response

200OK

Relay chain blocks

400Bad Request

Invalid range or missing parameter

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get head block

GET
https://dotassethub-playbook.nownodes.io/v1/rc/blocks/head

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the latest block on the relay chain.

Parameters

finalizedbooleanquery

When true returns finalized head (default: true)

eventDocsbooleanquery

Include event documentation

extrinsicDocsbooleanquery

Include extrinsic documentation

noFeesbooleanquery

Skip fee calculation

decodedXcmMsgsbooleanquery

Decode and include XCM messages

paraIdinteger<int32>>= 0query

Filter XCM messages by parachain ID

Response

200OK

Relay chain head block

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get head block header

GET
https://dotassethub-playbook.nownodes.io/v1/rc/blocks/head/header

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the header of the latest relay chain block.

Parameters

finalizedbooleanquery

When true returns finalized head (default: true)

Response

200OK

Relay chain head block header

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get block by ID

GET
https://dotassethub-playbook.nownodes.io/v1/rc/blocks/{blockId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns relay chain block information for a given block identifier.

Parameters

blockIdstringrequiredpath

Block height number or block hash

eventDocsbooleanquery

Include event documentation

extrinsicDocsbooleanquery

Include extrinsic documentation

noFeesbooleanquery

Skip fee calculation

decodedXcmMsgsbooleanquery

Include decoded XCM messages

paraIdinteger<int32>>= 0query

Filter XCM messages by parachain ID

Response

200OK

Relay chain block information

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get raw extrinsics

GET
https://dotassethub-playbook.nownodes.io/v1/rc/blocks/{blockId}/extrinsics-raw

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns raw hex-encoded extrinsics for a relay chain block without decoding.

Parameters

blockIdstringrequiredpath

Block height number or block hash

Response

200OK

Raw extrinsics

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get extrinsic by index

GET
https://dotassethub-playbook.nownodes.io/v1/rc/blocks/{blockId}/extrinsics/{extrinsicIndex}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns a specific extrinsic from a relay chain block by its index.

Parameters

blockIdstringrequiredpath

Block height number or block hash

extrinsicIndexstringrequiredpath

Index of the extrinsic in the block

eventDocsbooleanquery

Include event documentation

extrinsicDocsbooleanquery

Include extrinsic documentation

noFeesbooleanquery

Skip fee calculation

Response

200OK

Extrinsic details

400Bad Request

Invalid block ID or extrinsic index

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get block header

GET
https://dotassethub-playbook.nownodes.io/v1/rc/blocks/{blockId}/header

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the header of a relay chain block by block hash or block number.

Parameters

blockIdstringrequiredpath

Block height number or block hash

Response

200OK

Relay chain block header

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get parachain inclusions

GET
https://dotassethub-playbook.nownodes.io/v1/rc/blocks/{blockId}/para-inclusions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns parachain inclusion information for a given relay chain block.

Parameters

blockIdstringrequiredpath

Block height number or block hash

paraIdinteger<int32>>= 0query

Filter by parachain ID

Response

200OK

Parachain inclusions

400Bad Request

Invalid block identifier

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get node network

GET
https://dotassethub-playbook.nownodes.io/v1/rc/node/network

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the relay chain node's network information.

Response

200OK

Relay chain node network info

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get transaction pool

GET
https://dotassethub-playbook.nownodes.io/v1/rc/node/transaction-pool

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the relay chain's transaction pool with optional fee information.

Parameters

includeFeebooleanquery

Include fee information for each transaction (default: false)

Response

200OK

Relay chain transaction pool

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get node version

GET
https://dotassethub-playbook.nownodes.io/v1/rc/node/version

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the relay chain node's version information.

Response

200OK

Relay chain node version

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC on-going referenda

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/on-going-referenda

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all currently active referenda from the relay chain's Referenda pallet.

Parameters

atstringquery

Block hash or number to query at

Response

200OK

Active referenda from relay chain

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC staking progress

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/staking/progress

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns staking progress from the relay chain.

Parameters

atstringquery

Block hash or number to query at

Response

200OK

Relay chain staking progress

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC staking validators

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/staking/validators

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the list of active validators from the relay chain.

Parameters

atstringquery

Block hash or number to query at

Response

200OK

Relay chain validator information

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC pallet constants

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/{palletId}/consts

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all constants defined in a relay chain pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

atstringquery

Block hash or number to query at

onlyIdsbooleanquery

Only return constant names

Response

200OK

Relay chain pallet constants

400Bad Request

Invalid pallet

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC pallet constant value

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the value and metadata of a specific constant from a relay chain pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

constantItemIdstringrequiredpath

Name of the constant

atstringquery

Block hash or number to query at

metadatabooleanquery

Include metadata

Response

200OK

Relay chain constant value

404Not Found

Constant not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC pallet dispatchables

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/{palletId}/dispatchables

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the dispatchable calls defined in a relay chain pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

atstringquery

Block hash or number to query at

onlyIdsbooleanquery

Only return dispatchable names

Response

200OK

Relay chain pallet dispatchables

400Bad Request

Invalid pallet

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC pallet dispatchable details

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns a single dispatchable call from a relay chain pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

dispatchableIdstringrequiredpath

Name of the dispatchable

atstringquery

Block hash or number to query at

metadatabooleanquery

Include metadata

Response

200OK

Relay chain dispatchable details

404Not Found

Dispatchable not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC pallet errors

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/{palletId}/errors

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all errors defined in a relay chain pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

atstringquery

Block hash or number to query at

onlyIdsbooleanquery

Only return error names

Response

200OK

Relay chain pallet errors

400Bad Request

Invalid pallet

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC pallet error details

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns metadata for a specific error in a relay chain pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

errorItemIdstringrequiredpath

Name of the error

atstringquery

Block hash or number to query at

metadatabooleanquery

Include metadata

Response

200OK

Relay chain error details

404Not Found

Error not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC pallet events

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/{palletId}/events

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns all events defined in a relay chain pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

atstringquery

Block hash or number to query at

onlyIdsbooleanquery

Only return event names

Response

200OK

Relay chain pallet events

400Bad Request

Invalid pallet

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC pallet event details

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns metadata for a specific event in a relay chain pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

eventItemIdstringrequiredpath

Event name

atstringquery

Block hash or number to query at

metadatabooleanquery

Include full event metadata

Response

200OK

Relay chain event details

404Not Found

Pallet or event not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC pallet storage items

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/{palletId}/storage

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the list of storage items for a relay chain pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

atstringquery

Block hash or number to query at

onlyIdsbooleanquery

Only return storage item names

Response

200OK

Relay chain pallet storage items

400Bad Request

Invalid pallet or parameters

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC pallet storage item value

GET
https://dotassethub-playbook.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the value of a specific storage item from a relay chain pallet.

Parameters

palletIdstringrequiredpath

Name or index of the pallet

storageItemIdstringrequiredpath

Name of the storage item

atstringquery

Block hash or number to query at

keys[]Array<string>query

Storage key arguments

metadatabooleanquery

Include metadata for the storage item

Response

200OK

Relay chain storage item value

400Bad Request

Invalid parameters

404Not Found

Storage item not found

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC get runtime code

GET
https://dotassethub-playbook.nownodes.io/v1/rc/runtime/code

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the Wasm code blob of the relay chain runtime at a given block.

Parameters

atstringquery

Block identifier (number or hash)

Response

200OK

Relay chain runtime code

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get runtime metadata

GET
https://dotassethub-playbook.nownodes.io/v1/rc/runtime/metadata

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the decoded runtime metadata of the relay chain in JSON format.

Parameters

atstringquery

Block identifier (number or hash)

Response

200OK

Relay chain runtime metadata

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get metadata versions

GET
https://dotassethub-playbook.nownodes.io/v1/rc/runtime/metadata/versions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the available metadata versions on the relay chain at a given block.

Parameters

atstringquery

Block identifier (number or hash)

Response

200OK

Available metadata versions

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get metadata by version

GET
https://dotassethub-playbook.nownodes.io/v1/rc/runtime/metadata/{version}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the relay chain metadata at a specific version (e.g., v14, v15).

Parameters

versionstringrequiredpath

Metadata version in 'vX' format (e.g., v14, v15)

atstringquery

Block identifier (number or hash)

Response

200OK

Relay chain metadata at specified version

400Bad Request

Invalid version format

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC get runtime spec

GET
https://dotassethub-playbook.nownodes.io/v1/rc/runtime/spec

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the runtime spec of the relay chain at a given block.

Parameters

atstringquery

Block identifier (number or hash)

Response

200OK

Relay chain runtime spec

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

Submit transaction (relay chain)

POST
https://dotassethub-playbook.nownodes.io/v1/rc/transaction

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Submit a signed extrinsic to the relay chain transaction pool. Only available on parachains.

Body

application/json

Signed extrinsic with 'tx' field containing hex-encoded transaction

object

Response

200OK

Transaction hash

400Bad Request

Invalid transaction

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain not configured

RC dry run transaction

POST
https://dotassethub-playbook.nownodes.io/v1/rc/transaction/dry-run

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Dry run a transaction on the relay chain.

Body

application/json

Transaction with 'tx', 'senderAddress', and optional 'at' fields

object

Response

200OK

Dry run result

400Bad Request

Invalid transaction

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC fee estimate

POST
https://dotassethub-playbook.nownodes.io/v1/rc/transaction/fee-estimate

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Estimate the fee for a relay chain transaction.

Body

application/json

Transaction with 'tx' field

object

Response

200OK

Fee estimate

400Bad Request

Invalid transaction

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC transaction material

GET
https://dotassethub-playbook.nownodes.io/v1/rc/transaction/material

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns relay chain network information for transaction construction.

Parameters

atstringquery

Block hash or number to query at

noMetabooleanquery

DEPRECATED: If true, metadata is not included

metadatastringquery

Metadata format: 'json' or 'scale'

Response

200OK

Relay chain transaction material

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC transaction material versioned

GET
https://dotassethub-playbook.nownodes.io/v1/rc/transaction/material/{metadataVersion}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns relay chain transaction material with metadata at a specific version.

Parameters

metadataVersionstringrequiredpath

Metadata version (e.g., 'v14', 'v15')

atstringquery

Block hash or number to query at

noMetabooleanquery

DEPRECATED: If true, metadata is not included

metadatastringquery

Metadata format: 'json' or 'scale'

Response

200OK

Relay chain transaction material with versioned metadata

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

RC metadata blob

POST
https://dotassethub-playbook.nownodes.io/v1/rc/transaction/metadata-blob

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Generates a metadata blob from the relay chain for transaction signing.

Body

application/json

Request with 'tx' field and optional 'at' block

object

Response

200OK

Metadata blob

500Internal Server Error

Internal server error

503Service Unavailable

Service unavailable

Parse transaction (relay chain)

POST
https://dotassethub-playbook.nownodes.io/v1/rc/transaction/parse

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Decode a raw transaction using relay chain metadata. Only available on parachains. Returns the decoded pallet/method, call arguments, signature info, nonce, tip, era, and hash. Note: This endpoint uses the relay chain's current (latest) metadata for decoding. Transactions created for older runtime versions may fail to decode if the extrinsic format has changed.

Body

application/json

Transaction with 'tx' field containing hex-encoded extrinsic

Request body for transaction parsing.

txstring

Hex-encoded extrinsic with optional 0x prefix.

Response

200OK

Parsed transaction

400Bad Request

Invalid transaction or relay chain not configured

500Internal Server Error

Internal server error

503Service Unavailable

Relay chain unavailable