Polkadot REST API
v0.1.1https://ksm-playbook.nownodes.ioHigh-performance Rust REST API for Substrate/Polkadot blockchain data. Drop-in replacement for substrate-api-sidecar.
Authentication
api-keyAuthapiKeyAPI Key: api-key in header
NODE
health
Health check
Health check
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the health status of the API server.
Response
API is healthy
node
Connected node information
Node network info
Authorizations
ApiKeyAuthApiKeyAuthapi-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
Node network information
Internal server error
Service unavailable
Transaction pool
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the node's transaction pool with optional fee information.
Parameters
includeFeebooleanqueryInclude fee details for each transaction
Response
Transaction pool entries
Internal server error
Service unavailable
Node version
Authorizations
ApiKeyAuthApiKeyAuthapi-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
Node version information
Internal server error
Service unavailable
version
API version
API version
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the current version of the Polkadot REST API.
Response
API version
blocks
Block queries and extrinsic data
Get blocks by range
Authorizations
ApiKeyAuthApiKeyAuthapi-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
rangestringqueryBlock range in format 'start-end' (e.g. '100-200')
eventDocsbooleanqueryInclude documentation for events
extrinsicDocsbooleanqueryInclude documentation for extrinsics
noFeesbooleanquerySkip fee calculation for extrinsics
useRcBlockbooleanqueryTreat range as Relay Chain blocks
useEvmFormatbooleanqueryConvert AccountId32 addresses to EVM format for revive pallet events
Response
Array of block information
Invalid range parameter
Internal server error
Service unavailable
Get latest block
Authorizations
ApiKeyAuthApiKeyAuthapi-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
finalizedbooleanqueryWhen true (default), returns finalized head. When false, returns canonical head.
eventDocsbooleanqueryInclude documentation for events
extrinsicDocsbooleanqueryInclude documentation for extrinsics
noFeesbooleanquerySkip fee calculation for extrinsics
decodedXcmMsgsbooleanqueryDecode and include XCM messages
paraIdinteger<int32>>= 0queryFilter XCM messages by parachain ID
useRcBlockbooleanqueryWhen true, use relay chain head to find corresponding Asset Hub blocks
useEvmFormatbooleanqueryConvert AccountId32 addresses to EVM format for revive pallet events
Response
Latest block information
Internal server error
Service unavailable
Get head block header
Authorizations
ApiKeyAuthApiKeyAuthapi-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
finalizedbooleanqueryWhen true (default), returns finalized head header. When false, returns canonical head header.
useRcBlockbooleanqueryTreat as Relay Chain block and return Asset Hub blocks
Response
Block header information
Internal server error
Service unavailable
Get block by ID
Authorizations
ApiKeyAuthApiKeyAuthapi-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
blockIdstringrequiredpathBlock height number or block hash
eventDocsbooleanqueryInclude documentation for events
extrinsicDocsbooleanqueryInclude documentation for extrinsics
noFeesbooleanquerySkip fee calculation for extrinsics
finalizedKeybooleanqueryWhen true (default), include finalized status in response
decodedXcmMsgsbooleanqueryDecode and include XCM messages
paraIdinteger<int32>>= 0queryFilter XCM messages by parachain ID
useRcBlockbooleanqueryTreat blockId as Relay Chain block and return Asset Hub blocks
useEvmFormatbooleanqueryConvert AccountId32 addresses to EVM format for revive pallet events
Response
Block information
Invalid block identifier
Internal server error
Service unavailable
Get raw extrinsics
Authorizations
ApiKeyAuthApiKeyAuthapi-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
blockIdstringrequiredpathBlock height number or block hash
useRcBlockbooleanqueryWhen true, treat blockId as Relay Chain block and return Asset Hub blocks
Response
Raw block data with hex-encoded extrinsics
Invalid block identifier
Internal server error
Service unavailable
Get extrinsic by index
Authorizations
ApiKeyAuthApiKeyAuthapi-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
blockIdstringrequiredpathBlock height number or block hash
extrinsicIndexstringrequiredpathIndex of the extrinsic within the block
eventDocsbooleanqueryInclude documentation for events
extrinsicDocsbooleanqueryInclude documentation for extrinsics
noFeesbooleanquerySkip fee calculation
useRcBlockbooleanqueryWhen true, treat blockId as Relay Chain block and return Asset Hub extrinsics
useEvmFormatbooleanqueryConvert AccountId32 addresses to EVM format for revive pallet events
Response
Extrinsic details
Invalid block identifier or extrinsic index
Internal server error
Service unavailable
Get block header by ID
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the header of the specified block (lightweight, no extrinsics/events).
Parameters
blockIdstringrequiredpathBlock height number or block hash
useRcBlockbooleanqueryTreat blockId as Relay Chain block and return Asset Hub blocks
Response
Block header information
Invalid block identifier
Internal server error
Service unavailable
Get parachain inclusions
Authorizations
ApiKeyAuthApiKeyAuthapi-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
blockIdstringrequiredpathBlock height number or block hash
paraIdinteger<int32>>= 0queryFilter results by a specific parachain ID
Response
Parachain inclusion information
Invalid block identifier
Internal server error
Service unavailable
accounts
Account balance, staking, and proxy information
Compare account addresses
Authorizations
ApiKeyAuthApiKeyAuthapi-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
addressesstringrequiredqueryComma-separated list of SS58 addresses to compare (max 30)
Response
Comparison result
Invalid parameters
Account asset approvals
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns asset approval information for a given account, asset, and delegate.
Parameters
accountIdstringrequiredpathSS58-encoded account address
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
assetIdstringrequiredqueryThe asset ID to query approval for
delegatestringrequiredqueryThe delegate address with spending approval
Response
Asset approval information
Invalid parameters
Internal server error
Service unavailable
Account asset balances
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns asset balances for a given account on Asset Hub chains.
Parameters
accountIdstringrequiredpathSS58-encoded account address
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
assetsstringqueryComma-separated list of asset IDs to query
showEmptybooleanqueryWhen true, include assets with zero balance (default: false)
Response
Account asset balances
Invalid parameters
Internal server error
Service unavailable
Account balance info
Authorizations
ApiKeyAuthApiKeyAuthapi-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
accountIdstringrequiredpathSS58-encoded account address
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
tokenstringqueryToken symbol for chains with multiple tokens
denominatedbooleanqueryWhen true, denominate balances using chain decimals
Response
Account balance information
Invalid account or block parameter
Internal server error
Service unavailable
Convert account format
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Converts an account address between different SS58 formats and key types.
Parameters
accountIdstringrequiredpathSS58-encoded account address or hex public key
schemestringqueryCryptographic scheme: ed25519, sr25519, or ecdsa (default: sr25519)
prefixinteger<int32>>= 0querySS58 prefix number (default: 42)
publicKeybooleanqueryIf true, treat input as a public key
Response
Converted account information
Invalid parameters
Internal server error
Service unavailable
Account foreign asset balances
Authorizations
ApiKeyAuthApiKeyAuthapi-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
accountIdstringrequiredpathSS58-encoded account address
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
foreignAssetsArray<string>queryList of multilocation JSON strings to filter by
showEmptybooleanqueryWhen true, include assets with zero balance (default: false)
Response
Foreign asset balances
Invalid account or parameters
Internal server error
Service unavailable
Account pool asset approvals
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns pool asset approval information for a given account, asset, and delegate.
Parameters
accountIdstringrequiredpathSS58-encoded account address
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
assetIdstringrequiredqueryThe pool asset ID to query approval for
delegatestringrequiredqueryThe delegate address with spending approval
Response
Pool asset approval information
Invalid parameters
Internal server error
Service unavailable
Account pool asset balances
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns pool asset balances for a given account.
Parameters
accountIdstringrequiredpathSS58-encoded account address
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
assetsstringqueryComma-separated list of pool asset IDs to query
showEmptybooleanqueryWhen true, include assets with zero balance (default: false)
Response
Pool asset balances
Invalid parameters
Internal server error
Service unavailable
Account proxy info
Authorizations
ApiKeyAuthApiKeyAuthapi-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
accountIdstringrequiredpathSS58-encoded account address
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Proxy information
Invalid parameters
Internal server error
Service unavailable
Account staking info
Authorizations
ApiKeyAuthApiKeyAuthapi-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
accountIdstringrequiredpathSS58-encoded stash account address
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
includeClaimedRewardsbooleanqueryWhen true, include claimed rewards in the response
Response
Staking information
Invalid parameters
Internal server error
Service unavailable
Account staking payouts
Authorizations
ApiKeyAuthApiKeyAuthapi-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
accountIdstringrequiredpathSS58-encoded stash account address
atstringqueryBlock hash or number to query at
depthstringqueryNumber of eras to query (default: 1)
erastringqueryThe era to query at (default: active_era - 1)
unclaimedOnlybooleanqueryOnly show unclaimed rewards (default: true)
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Staking payout information
Invalid parameters
Internal server error
Service unavailable
Validate account address
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Validates an SS58-encoded account address and returns details about its format.
Parameters
accountIdstringrequiredpathSS58-encoded account address to validate
atstringqueryBlock hash or number (accepted for API consistency)
Response
Validation result
Account vesting info
Authorizations
ApiKeyAuthApiKeyAuthapi-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
accountIdstringrequiredpathSS58-encoded account address
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
includeClaimablebooleanqueryWhen true, calculate vested amounts
Response
Vesting information
Invalid parameters
Internal server error
Service unavailable
pallets
Runtime pallet metadata, storage, constants, events, errors
Liquidity pools
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns all liquidity pools from the AssetConversion pallet.
Parameters
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Liquidity pools
Internal server error
Service unavailable
Next available pool ID
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the next available pool asset ID from the AssetConversion pallet.
Parameters
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Next available ID
Internal server error
Service unavailable
Asset info
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns details for a specific asset including supply, admin, and metadata.
Parameters
assetIdstringrequiredpathAsset ID
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Asset information
Asset not found
Internal server error
Service unavailable
Foreign assets
Authorizations
ApiKeyAuthApiKeyAuthapi-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
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Foreign assets list
Not supported on this chain
Internal server error
Service unavailable
Nomination pools info
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns global nomination pools statistics and configuration.
Parameters
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Nomination pools information
Not supported on this chain
Internal server error
Service unavailable
Nomination pool details
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns details for a specific nomination pool.
Parameters
poolIdstringrequiredpathPool ID
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Pool details
Pool not found
Internal server error
Service unavailable
On-going referenda
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns all currently active referenda from the Referenda pallet.
Parameters
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Active referenda
Internal server error
Service unavailable
Pool asset info
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns details for a specific pool asset including supply, admin, and metadata.
Parameters
assetIdstringrequiredpathPool asset ID
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Pool asset information
Pool asset not found
Internal server error
Service unavailable
Staking progress
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns staking progress including era, session info, and validator counts.
Parameters
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Staking progress information
Internal server error
Service unavailable
Staking validators
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the list of active validators and their info.
Parameters
atstringqueryBlock hash or number to query at
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Validator information
Internal server error
Service unavailable
Pallet constants
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns all constants defined in a pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
atstringqueryBlock hash or number to query at
onlyIdsbooleanqueryOnly return constant names
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Pallet constants
Invalid pallet
Internal server error
Service unavailable
Pallet constant value
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the value and metadata of a specific constant in a pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
constantItemIdstringrequiredpathName of the constant
atstringqueryBlock hash or number to query at
metadatabooleanqueryInclude metadata
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Constant value
Invalid parameters
Constant not found
Internal server error
Service unavailable
Pallet dispatchables
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the dispatchable calls defined in a pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
atstringqueryBlock hash or number to query at
onlyIdsbooleanqueryOnly return dispatchable names
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Pallet dispatchables
Invalid pallet
Internal server error
Service unavailable
Pallet dispatchable details
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns a single dispatchable call defined in a pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
dispatchableIdstringrequiredpathName of the dispatchable
atstringqueryBlock hash or number to query at
metadatabooleanqueryInclude metadata
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Dispatchable details
Dispatchable not found
Internal server error
Service unavailable
Pallet errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns all errors defined in a pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
atstringqueryBlock hash or number to query at
onlyIdsbooleanqueryOnly return error names
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Pallet errors
Invalid pallet
Internal server error
Service unavailable
Pallet error details
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns metadata for a specific error in a pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
errorItemIdstringrequiredpathName of the error
atstringqueryBlock hash or number to query at
metadatabooleanqueryInclude metadata
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Error details
Error not found
Internal server error
Service unavailable
Get pallet events
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns all events defined in a pallet.
Parameters
palletIdstringrequiredpathPallet name or index
atstringqueryBlock identifier (number or hash)
onlyIdsbooleanqueryOnly return event names
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Pallet events
Invalid request
Pallet not found
Internal server error
Service unavailable
Get pallet event item
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns metadata for a specific event in a pallet.
Parameters
palletIdstringrequiredpathPallet name or index
eventItemIdstringrequiredpathEvent name
atstringqueryBlock identifier (number or hash)
metadatabooleanqueryInclude full event metadata
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Event item details
Invalid request
Pallet or event not found
Internal server error
Service unavailable
Pallet storage items
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the list of storage items for a given pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
atstringqueryBlock hash or number to query at
onlyIdsbooleanqueryOnly return storage item names
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Pallet storage items
Invalid pallet or parameters
Internal server error
Service unavailable
Pallet storage item value
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the value of a specific storage item in a pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
storageItemIdstringrequiredpathName of the storage item
atstringqueryBlock hash or number to query at
keys[]Array<string>queryStorage key arguments
metadatabooleanqueryInclude metadata for the storage item
useRcBlockbooleanqueryTreat 'at' as relay chain block identifier
Response
Storage item value
Invalid parameters
Storage item not found
Internal server error
Service unavailable
runtime
Runtime specification, metadata, and code
Runtime Wasm code
Authorizations
ApiKeyAuthApiKeyAuthapi-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
atstringqueryBlock hash or number to query at
Response
Runtime code
Invalid block parameter
Internal server error
Service unavailable
Runtime metadata
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the decoded runtime metadata in JSON format.
Parameters
atstringqueryBlock hash or number to query at
Response
Runtime metadata
Invalid block parameter
Internal server error
Service unavailable
Available metadata versions
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the available metadata versions at a given block.
Parameters
atstringqueryBlock hash or number to query at
Response
List of available metadata versions
Invalid block parameter
Internal server error
Service unavailable
Runtime metadata by version
Authorizations
ApiKeyAuthApiKeyAuthapi-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
versionstringrequiredpathMetadata version (e.g., 'v14', 'v15')
atstringqueryBlock hash or number to query at
Response
Runtime metadata at specified version
Invalid version format or block parameter
Internal server error
Service unavailable
Runtime specification
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the runtime specification including version, APIs, and chain properties.
Parameters
atstringqueryBlock hash or number to query at
Response
Runtime specification
Invalid block parameter
Internal server error
Service unavailable
transaction
Transaction submission, fee estimation, and construction material
Submit transaction
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Submit a signed extrinsic to the transaction pool.
Body
Signed extrinsic with 'tx' field containing hex-encoded transaction
Response
Transaction hash
Invalid transaction
Internal server error
Service unavailable
Dry run transaction
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Dry run a transaction to check validity without submitting.
Body
Transaction with 'tx', 'senderAddress', and optional 'at' fields
Response
Dry run result
Invalid transaction
Internal server error
Service unavailable
Estimate transaction fee
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Estimate the fee for a transaction.
Body
Transaction with 'tx' field containing hex-encoded transaction
Response
Fee estimate
Invalid transaction
Internal server error
Service unavailable
Transaction construction material
Authorizations
ApiKeyAuthApiKeyAuthapi-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
atstringqueryBlock hash or number to query at
noMetabooleanqueryDEPRECATED: If true, metadata is not included
metadatastringqueryMetadata format: 'json' or 'scale'
Response
Transaction material
Invalid parameters
Internal server error
Service unavailable
Transaction material with versioned metadata
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns transaction construction material with metadata at a specific version.
Parameters
metadataVersionstringrequiredpathMetadata version (e.g., 'v14', 'v15')
atstringqueryBlock hash or number to query at
noMetabooleanqueryDEPRECATED: If true, metadata is not included
metadatastringqueryMetadata format: 'json' or 'scale'
Response
Transaction material with versioned metadata
Invalid parameters
Internal server error
Service unavailable
Generate metadata blob
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Generates a metadata blob for transaction signing with the CheckMetadataHash extension.
Body
Request with 'tx' field and optional 'at' block
Response
Metadata blob
Invalid parameters
Internal server error
Service unavailable
Parse transaction
Authorizations
ApiKeyAuthApiKeyAuthapi-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
Transaction with 'tx' field containing hex-encoded extrinsic
Request body for transaction parsing.
txstringHex-encoded extrinsic with optional 0x prefix.
Response
Parsed transaction
Invalid transaction
Internal server error
coretime
Coretime system information
Get coretime info
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns coretime chain status information including the last committed timeslice.
Parameters
atstringqueryBlock identifier (number or hash)
Response
Coretime info
Invalid block identifier
Internal server error
Service unavailable
Get coretime leases
Authorizations
ApiKeyAuthApiKeyAuthapi-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
atstringqueryBlock identifier (number or hash)
Response
Coretime leases
Invalid block identifier
Internal server error
Service unavailable
Get coretime overview
Authorizations
ApiKeyAuthApiKeyAuthapi-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
atstringqueryBlock identifier (number or hash)
Response
Coretime overview
Invalid block identifier
Internal server error
Service unavailable
Get coretime regions
Authorizations
ApiKeyAuthApiKeyAuthapi-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
atstringqueryBlock identifier (number or hash)
Response
Coretime regions
Invalid block identifier
Internal server error
Service unavailable
Get coretime potential renewals
Authorizations
ApiKeyAuthApiKeyAuthapi-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
atstringqueryBlock identifier (number or hash)
Response
Coretime renewals
Invalid block identifier
Internal server error
Service unavailable
Get coretime reservations
Authorizations
ApiKeyAuthApiKeyAuthapi-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
atstringqueryBlock identifier (number or hash)
Response
Coretime reservations
Invalid block identifier
Internal server error
Service unavailable
paras
Parachain inclusion data
Parachain inclusion data
Authorizations
ApiKeyAuthApiKeyAuthapi-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
numberstringrequiredpathParachain block number
depthstringquerySearch depth for relay chain blocks (max 100, default 10, must be divisible by 5)
Response
Parachain inclusion information
Invalid parameters
Internal server error
Service unavailable
ahm
Asset Hub Migration information
Asset Hub Migration info
Authorizations
ApiKeyAuthApiKeyAuthapi-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
AHM migration boundaries
No migration data available
capabilities
API capabilities and chain pallets
API capabilities
Authorizations
ApiKeyAuthApiKeyAuthapi-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
atstringqueryBlock hash or number to query at
Response
Chain capabilities
Invalid block parameter
Internal server error
Service unavailable
rc
Relay chain endpoints (available on parachains only)
RC get balance info
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns balance information for a given account on the relay chain.
Parameters
accountIdstringrequiredpathSS58-encoded account address
atstringqueryBlock identifier (number or hash)
tokenstringqueryToken symbol (defaults to native token)
denominatedbooleanqueryDenominate balances using chain decimals
Response
Balance information
Invalid account address
Internal server error
Relay chain not configured
RC get proxy info
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns proxy information for a given account on the relay chain.
Parameters
accountIdstringrequiredpathSS58-encoded account address
atstringqueryBlock identifier (number or hash)
Response
Proxy information
Invalid account address
Internal server error
Relay chain not configured
RC get staking info
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns staking information for a given stash account on the relay chain.
Parameters
accountIdstringrequiredpathSS58-encoded stash account address
atstringqueryBlock identifier (number or hash)
includeClaimedRewardsbooleanqueryWhen true, include claimed rewards in the response
Response
Staking information
Invalid account address
Internal server error
Relay chain not configured
RC get staking payouts
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns staking payout information for a given account on the relay chain.
Parameters
accountIdstringrequiredpathSS58-encoded account address
atstringqueryBlock identifier (number or hash)
depthinteger<int32>>= 0queryNumber of eras to query (default: 1)
erainteger<int32>>= 0queryThe era to query at (default: active_era - 1)
unclaimedOnlybooleanqueryOnly show unclaimed rewards (default: true)
Response
Staking payouts
Invalid account address
Internal server error
Relay chain not configured
RC get vesting info
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns vesting information for a given account on the relay chain.
Parameters
accountIdstringrequiredpathSS58-encoded account address
atstringqueryBlock identifier (number or hash)
Response
Vesting information
Invalid account address
Internal server error
Relay chain not configured
RC get blocks by range
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns relay chain blocks within a specified range (max 500 blocks).
Parameters
rangestringqueryBlock range (e.g., '100-200')
eventDocsbooleanqueryInclude event documentation
extrinsicDocsbooleanqueryInclude extrinsic documentation
noFeesbooleanquerySkip fee calculation
decodedXcmMsgsbooleanqueryDecode and include XCM messages
paraIdinteger<int32>>= 0queryFilter XCM messages by parachain ID
Response
Relay chain blocks
Invalid range or missing parameter
Internal server error
Relay chain not configured
RC get head block
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the latest block on the relay chain.
Parameters
finalizedbooleanqueryWhen true returns finalized head (default: true)
eventDocsbooleanqueryInclude event documentation
extrinsicDocsbooleanqueryInclude extrinsic documentation
noFeesbooleanquerySkip fee calculation
decodedXcmMsgsbooleanqueryDecode and include XCM messages
paraIdinteger<int32>>= 0queryFilter XCM messages by parachain ID
Response
Relay chain head block
Internal server error
Relay chain not configured
RC get head block header
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the header of the latest relay chain block.
Parameters
finalizedbooleanqueryWhen true returns finalized head (default: true)
Response
Relay chain head block header
Internal server error
Relay chain not configured
RC get block by ID
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns relay chain block information for a given block identifier.
Parameters
blockIdstringrequiredpathBlock height number or block hash
eventDocsbooleanqueryInclude event documentation
extrinsicDocsbooleanqueryInclude extrinsic documentation
noFeesbooleanquerySkip fee calculation
decodedXcmMsgsbooleanqueryInclude decoded XCM messages
paraIdinteger<int32>>= 0queryFilter XCM messages by parachain ID
Response
Relay chain block information
Invalid block identifier
Internal server error
Relay chain not configured
RC get raw extrinsics
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns raw hex-encoded extrinsics for a relay chain block without decoding.
Parameters
blockIdstringrequiredpathBlock height number or block hash
Response
Raw extrinsics
Invalid block identifier
Internal server error
Relay chain not configured
RC get extrinsic by index
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns a specific extrinsic from a relay chain block by its index.
Parameters
blockIdstringrequiredpathBlock height number or block hash
extrinsicIndexstringrequiredpathIndex of the extrinsic in the block
eventDocsbooleanqueryInclude event documentation
extrinsicDocsbooleanqueryInclude extrinsic documentation
noFeesbooleanquerySkip fee calculation
Response
Extrinsic details
Invalid block ID or extrinsic index
Internal server error
Relay chain not configured
RC get block header
Authorizations
ApiKeyAuthApiKeyAuthapi-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
blockIdstringrequiredpathBlock height number or block hash
Response
Relay chain block header
Invalid block identifier
Internal server error
Relay chain not configured
RC get parachain inclusions
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns parachain inclusion information for a given relay chain block.
Parameters
blockIdstringrequiredpathBlock height number or block hash
paraIdinteger<int32>>= 0queryFilter by parachain ID
Response
Parachain inclusions
Invalid block identifier
Internal server error
Relay chain not configured
RC get node network
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the relay chain node's network information.
Response
Relay chain node network info
Internal server error
Relay chain not configured
RC get transaction pool
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the relay chain's transaction pool with optional fee information.
Parameters
includeFeebooleanqueryInclude fee information for each transaction (default: false)
Response
Relay chain transaction pool
Internal server error
Relay chain not configured
RC get node version
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the relay chain node's version information.
Response
Relay chain node version
Internal server error
Relay chain not configured
RC on-going referenda
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns all currently active referenda from the relay chain's Referenda pallet.
Parameters
atstringqueryBlock hash or number to query at
Response
Active referenda from relay chain
Internal server error
Service unavailable
RC staking progress
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns staking progress from the relay chain.
Parameters
atstringqueryBlock hash or number to query at
Response
Relay chain staking progress
Internal server error
Service unavailable
RC staking validators
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the list of active validators from the relay chain.
Parameters
atstringqueryBlock hash or number to query at
Response
Relay chain validator information
Internal server error
Service unavailable
RC pallet constants
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns all constants defined in a relay chain pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
atstringqueryBlock hash or number to query at
onlyIdsbooleanqueryOnly return constant names
Response
Relay chain pallet constants
Invalid pallet
Internal server error
Service unavailable
RC pallet constant value
Authorizations
ApiKeyAuthApiKeyAuthapi-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
palletIdstringrequiredpathName or index of the pallet
constantItemIdstringrequiredpathName of the constant
atstringqueryBlock hash or number to query at
metadatabooleanqueryInclude metadata
Response
Relay chain constant value
Constant not found
Internal server error
Service unavailable
RC pallet dispatchables
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the dispatchable calls defined in a relay chain pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
atstringqueryBlock hash or number to query at
onlyIdsbooleanqueryOnly return dispatchable names
Response
Relay chain pallet dispatchables
Invalid pallet
Internal server error
Service unavailable
RC pallet dispatchable details
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns a single dispatchable call from a relay chain pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
dispatchableIdstringrequiredpathName of the dispatchable
atstringqueryBlock hash or number to query at
metadatabooleanqueryInclude metadata
Response
Relay chain dispatchable details
Dispatchable not found
Internal server error
Service unavailable
RC pallet errors
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns all errors defined in a relay chain pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
atstringqueryBlock hash or number to query at
onlyIdsbooleanqueryOnly return error names
Response
Relay chain pallet errors
Invalid pallet
Internal server error
Service unavailable
RC pallet error details
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns metadata for a specific error in a relay chain pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
errorItemIdstringrequiredpathName of the error
atstringqueryBlock hash or number to query at
metadatabooleanqueryInclude metadata
Response
Relay chain error details
Error not found
Internal server error
Service unavailable
RC pallet events
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns all events defined in a relay chain pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
atstringqueryBlock hash or number to query at
onlyIdsbooleanqueryOnly return event names
Response
Relay chain pallet events
Invalid pallet
Internal server error
Service unavailable
RC pallet event details
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns metadata for a specific event in a relay chain pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
eventItemIdstringrequiredpathEvent name
atstringqueryBlock hash or number to query at
metadatabooleanqueryInclude full event metadata
Response
Relay chain event details
Pallet or event not found
Internal server error
Service unavailable
RC pallet storage items
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the list of storage items for a relay chain pallet.
Parameters
palletIdstringrequiredpathName or index of the pallet
atstringqueryBlock hash or number to query at
onlyIdsbooleanqueryOnly return storage item names
Response
Relay chain pallet storage items
Invalid pallet or parameters
Internal server error
Service unavailable
RC pallet storage item value
Authorizations
ApiKeyAuthApiKeyAuthapi-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
palletIdstringrequiredpathName or index of the pallet
storageItemIdstringrequiredpathName of the storage item
atstringqueryBlock hash or number to query at
keys[]Array<string>queryStorage key arguments
metadatabooleanqueryInclude metadata for the storage item
Response
Relay chain storage item value
Invalid parameters
Storage item not found
Internal server error
Service unavailable
RC get runtime code
Authorizations
ApiKeyAuthApiKeyAuthapi-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
atstringqueryBlock identifier (number or hash)
Response
Relay chain runtime code
Internal server error
Relay chain not configured
RC get runtime metadata
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the decoded runtime metadata of the relay chain in JSON format.
Parameters
atstringqueryBlock identifier (number or hash)
Response
Relay chain runtime metadata
Internal server error
Relay chain not configured
RC get metadata versions
Authorizations
ApiKeyAuthApiKeyAuthapi-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
atstringqueryBlock identifier (number or hash)
Response
Available metadata versions
Internal server error
Relay chain not configured
RC get metadata by version
Authorizations
ApiKeyAuthApiKeyAuthapi-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
versionstringrequiredpathMetadata version in 'vX' format (e.g., v14, v15)
atstringqueryBlock identifier (number or hash)
Response
Relay chain metadata at specified version
Invalid version format
Internal server error
Relay chain not configured
RC get runtime spec
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns the runtime spec of the relay chain at a given block.
Parameters
atstringqueryBlock identifier (number or hash)
Response
Relay chain runtime spec
Internal server error
Relay chain not configured
Submit transaction (relay chain)
Authorizations
ApiKeyAuthApiKeyAuthapi-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
Signed extrinsic with 'tx' field containing hex-encoded transaction
Response
Transaction hash
Invalid transaction
Internal server error
Relay chain not configured
RC dry run transaction
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Dry run a transaction on the relay chain.
Body
Transaction with 'tx', 'senderAddress', and optional 'at' fields
Response
Dry run result
Invalid transaction
Internal server error
Service unavailable
RC fee estimate
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Estimate the fee for a relay chain transaction.
Body
Transaction with 'tx' field
Response
Fee estimate
Invalid transaction
Internal server error
Service unavailable
RC transaction material
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns relay chain network information for transaction construction.
Parameters
atstringqueryBlock hash or number to query at
noMetabooleanqueryDEPRECATED: If true, metadata is not included
metadatastringqueryMetadata format: 'json' or 'scale'
Response
Relay chain transaction material
Internal server error
Service unavailable
RC transaction material versioned
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Returns relay chain transaction material with metadata at a specific version.
Parameters
metadataVersionstringrequiredpathMetadata version (e.g., 'v14', 'v15')
atstringqueryBlock hash or number to query at
noMetabooleanqueryDEPRECATED: If true, metadata is not included
metadatastringqueryMetadata format: 'json' or 'scale'
Response
Relay chain transaction material with versioned metadata
Internal server error
Service unavailable
RC metadata blob
Authorizations
ApiKeyAuthApiKeyAuthapi-key string
NOWNodes API key passed in the api-key header.
Generates a metadata blob from the relay chain for transaction signing.
Body
Request with 'tx' field and optional 'at' block
Response
Metadata blob
Internal server error
Service unavailable
Parse transaction (relay chain)
Authorizations
ApiKeyAuthApiKeyAuthapi-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
Transaction with 'tx' field containing hex-encoded extrinsic
Request body for transaction parsing.
txstringHex-encoded extrinsic with optional 0x prefix.
Response
Parsed transaction
Invalid transaction or relay chain not configured
Internal server error
Relay chain unavailable