Flare Node JSON-RPC API

v1.0.0

Base URLs

https://dot-assethub.nownodes.io

https://dotassethub-playbook.nownodes.io

https://dot.nownodes.io

https://dot-playbook.nownodes.io

JSON-RPC method for getting pending extrinsics

Authentication

ApiKeyAuthapiKey

API Key: api-key in header

api-keyAuthapiKey

API Key: api-key in header

Asset Hub / JSON-RPC

author_pendingExtrinsics

Get pending extrinsics from transaction pool

POST

https://dot-assethub.nownodes.io/

Returns all pending extrinsics, potentially grouped by sender.

The author_pendingExtrinsics method retrieves all transactions that are currently in the transaction pool (mempool) waiting to be included in a block.

This method is useful for:

Monitoring transaction pool status
Debugging transaction propagation issues
Building transaction explorers
Analyzing network congestion

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringauthor_pendingExtrinsicsrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

Successful response with pending extrinsics

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get pending extrinsics from transaction pool

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "author_pendingExtrinsics",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "author_pendingExtrinsics",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "author_pendingExtrinsics",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "author_pendingExtrinsics",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    "0x2804020000d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d0000a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000",
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000",
    "0x31028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a4800000000000000000000000000000000000000"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid request",
    "data": "Method not found"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error processing request"
  }
}

author_submitAndWatchExtrinsic

Submit and watch extrinsic

POST

https://dot-assethub.nownodes.io/

Submit a fully-formed extrinsic and watch for its lifecycle events.

The author_submitAndWatchExtrinsic method submits a signed extrinsic to the transaction pool and returns a subscription ID that can be used to track the extrinsic's progress through various stages until it is finalized or fails.

This method provides real-time updates about the extrinsic's status including:

When it enters the transaction pool
When it is included in a block
Finalization status
Any errors that occur

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringauthor_submitAndWatchExtrinsicrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing the hex-encoded extrinsic

Response

200OK

Extrinsic submitted successfully, subscription created

400Bad Request

Invalid extrinsic or request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Submit and watch extrinsic

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "author_submitAndWatchExtrinsic",
    "id": 1,
    "params": [
      "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "author_submitAndWatchExtrinsic",
      "id": 1,
      "params": [
        "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "author_submitAndWatchExtrinsic",
  "id": 1,
  "params": [
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "author_submitAndWatchExtrinsic",
  "id": 1,
  "params": [
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1234567890abcdef"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid extrinsic format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Failed to submit extrinsic"
  }
}

author_submitExtrinsic

Submit a fully-formed extrinsic

POST

https://dot-assethub.nownodes.io/

Submit a fully-formed extrinsic for inclusion in a block.

The author_submitExtrinsic method submits a signed extrinsic to the transaction pool. Unlike author_submitAndWatchExtrinsic, this method does not provide real-time updates about the extrinsic's status - it simply returns the extrinsic hash upon successful submission.

This method is suitable for applications that don't require immediate status updates and prefer a fire-and-forget approach to transaction submission.

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringauthor_submitExtrinsicrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing the hex-encoded extrinsic

Response

200OK

Extrinsic submitted successfully

400Bad Request

Invalid extrinsic or request

500Internal Server Error

Internal server error or pool rejection

Authorization

ApiKeyAuthapiKey in header

Submit a fully-formed extrinsic

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "author_submitExtrinsic",
    "id": 1,
    "params": [
      "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "author_submitExtrinsic",
      "id": 1,
      "params": [
        "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "author_submitExtrinsic",
  "id": 1,
  "params": [
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "author_submitExtrinsic",
  "id": 1,
  "params": [
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid extrinsic format: bad signature"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Pool error: Invalid transaction"
  }
}

chain_getBlockHash

Get block hash by block number

POST

https://dot-assethub.nownodes.io/

Get the hash of a specific block by its block number.

The chain_getBlockHash method returns the hash of the block header for the specified block number. If no block number is provided, it returns the hash of the latest finalized block.

This method is essential for:

Navigating the blockchain by block height
Verifying block existence and integrity
Building block explorers
Cross-referencing blocks across different queries

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringchain_getBlockHashrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<integer | string>required

Array containing optional block number

Show child attributes

One of

Block number (height) to query

integer

Block number as hex string

string

Response

200OK

Block hash retrieved successfully

400Bad Request

Invalid block number or request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get block hash by block number

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "chain_getBlockHash",
    "id": 1,
    "params": [
      12345678
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "chain_getBlockHash",
      "id": 1,
      "params": [
        12345678
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chain_getBlockHash",
  "id": 1,
  "params": [
    12345678
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "chain_getBlockHash",
  "id": 1,
  "params": [
    12345678
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Block number out of range"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving block hash"
  }
}

chain_getBlock

Get block by hash

POST

https://dot-assethub.nownodes.io/

Get a block by its hash.

The chain_getBlock method returns the full block data including the block header and all contained extrinsics (transactions). If no block hash is provided, it returns the latest finalized block.

This method provides complete information about a block including:

Block header with metadata
All extrinsics (transactions) in the block
Block production details
Parent-child relationships

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringchain_getBlockrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing optional block hash

Response

200OK

Block data retrieved successfully

400Bad Request

Invalid block hash or request

404Not Found

Block not found

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get block by hash

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "chain_getBlock",
    "id": 1,
    "params": [
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "chain_getBlock",
      "id": 1,
      "params": [
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chain_getBlock",
  "id": 1,
  "params": [
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "chain_getBlock",
  "id": 1,
  "params": [
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "block": {
      "extrinsics": [
        "0x2804020000d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d0000a0db2df800",
        "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000"
      ],
      "header": {
        "digest": {
          "logs": [
            "0x0642414245340201000000ef55a50f00000000",
            "0x0542414245010100c0e62f4f9b43e90e0c1b7c8d6e35d"
          ]
        },
        "extrinsicsRoot": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
        "number": "0xbc614e",
        "parentHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "stateRoot": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      }
    },
    "justifications": null
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid block hash format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": null
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving block data"
  }
}

chain_getFinalizedHead

Get latest finalized block hash

POST

https://dot-assethub.nownodes.io/

Get the hash of the most recent finalized block.

The chain_getFinalizedHead method returns the block hash of the latest block that has been finalized by the GRANDPA finality gadget. Finalized blocks are irreversible and cannot be reorganized, providing the highest level of security for applications.

This method is crucial for:

Determining safe block height for transactions
Building applications that require finality guarantees
Monitoring chain progression and stability
Ensuring data consistency across services

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringchain_getFinalizedHeadrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

Finalized block hash retrieved successfully

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get latest finalized block hash

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "chain_getFinalizedHead",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "chain_getFinalizedHead",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chain_getFinalizedHead",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "chain_getFinalizedHead",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving finalized head"
  }
}

chain_getHeader

Get Block Header

POST

https://dot-assethub.nownodes.io/

Returns the header of the most recent (best) block in the Polkadot blockchain.

This method is part of the Polkadot JSON-RPC 2.0 specification for chain-related operations. The header contains critical information about the block including hashes, roots, and consensus data.

Body

application/json

jsonrpcstring2.0required

The JSON-RPC protocol version. Must be exactly "2.0".

methodstringchain_getHeaderrequired

The JSON-RPC method to call. For this endpoint, must be "chain_getHeader".

paramsArray<any>required

Parameters for the method. For chain_getHeader, this should be an empty array as it retrieves the latest block header without additional parameters.

idinteger<int32>required

Request identifier that will be returned in the response. Used to match requests with responses when making multiple concurrent calls.

Response

200OK

Successful response containing the block header information.

The header represents the most recent block in the best chain and contains cryptographic commitments to the block's contents and state.

400Bad Request

Bad Request - Invalid JSON-RPC request Possible reasons:

Invalid JSON syntax
Missing required fields
Invalid method name
Invalid parameters

500Internal Server Error

Internal Server Error The node encountered an internal error while processing the request.

503Service Unavailable

Service Unavailable The node is currently unavailable, possibly due to maintenance or synchronization.

Authorization

ApiKeyAuthapiKey in header

Get Block Header

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "chain_getHeader",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "chain_getHeader",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chain_getHeader",
  "params": [],
  "id": 1
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "chain_getHeader",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "parentHash": "0x8f9c2b45286b9d241e43299a980aec6674aacc000fb3682d178f0116a0e09c0a",
    "number": "0x1b67a92",
    "stateRoot": "0x5df4b77648285c0b4ee27fdf52e4566c48990b5357058b5fcc492bff2e8aa87e",
    "extrinsicsRoot": "0xbee43c93d0459704b769eac77fd999099aa9a443501df7057df0f8761fef1472",
    "digest": {
      "logs": [
        "0x0642414245b501036700000068608511000000005e76194dbd931c0eec4b706d3e362725dda289c581a61189cf3fe246596a87717ce5ec5146bf1ff0952733eeaf992548990b7e4bbdc3a4a73eae788f5cf862083bf9f2f1ce9119558aa04ba7c98acd9e6b4713252868a661912bf5b098ae9003",
        "0x044245454684036a4f28650461c9c3bfadc940a61e35a243c8a016acd160bb21e3b573392c6e83",
        "0x05424142450101bab5e08f59e82f4f25d55dcf31dda08b2f54264404f386ddc4b273b5a48ac64294e0d59fc5dacdab63a8ef295844da8e82dfc9de35c9f0f9bbf2efe21e9eaf81"
      ]
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid request"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Server unavailable"
  }
}

payment_queryInfo

Query transaction fee information

POST

https://dot-assethub.nownodes.io/

Retrieve the transaction fee information for an extrinsic.

The payment_queryInfo method estimates the transaction fees (including weight fees, length fees, and tips) for a given extrinsic without actually submitting it to the chain. This allows applications to display accurate fee estimates to users before they sign and submit transactions.

This method is essential for:

Wallet applications showing fee estimates
DApps calculating transaction costs
Users verifying transaction affordability
Batch transaction cost optimization

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringpayment_queryInforequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing the hex-encoded extrinsic

Response

200OK

Fee information retrieved successfully

400Bad Request

Invalid extrinsic or request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Query transaction fee information

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "payment_queryInfo",
    "id": 1,
    "params": [
      "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "payment_queryInfo",
      "id": 1,
      "params": [
        "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "payment_queryInfo",
  "id": 1,
  "params": [
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "payment_queryInfo",
  "id": 1,
  "params": [
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "partialFee": "1000000000",
    "weight": {
      "refTime": "1000000000",
      "proofSize": "10000"
    },
    "class": "Normal",
    "paysFee": "Yes"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid extrinsic format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error calculating transaction fees"
  }
}

state_getMetadata

Get runtime metadata

POST

https://dot-assethub.nownodes.io/

Returns the runtime metadata as a hex-encoded string.

The state_getMetadata method provides the complete runtime metadata for the chain. This metadata describes all the types, storage entries, extrinsics, and events available in the runtime. It's essential for building type-safe applications and understanding the chain's capabilities.

This method is crucial for:

Generating type definitions for applications
Understanding available storage items and extrinsics
Building dynamic DApp interfaces
Runtime version compatibility checking

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getMetadatarequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Optional parameters array. Can be empty or contain an optional block hash for historical metadata.

Response

200OK

Runtime metadata retrieved successfully

400Bad Request

Invalid request parameters

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get runtime metadata

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getMetadata",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getMetadata",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getMetadata",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getMetadata",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x6d6574610e0000001c00000000000000020000000000000003000000000000000400000000000000"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid block hash format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving metadata"
  }
}

state_getReadProof

Get read proof for storage keys

POST

https://dot-assethub.nownodes.io/

Returns proof of storage entries at a specific block.

The state_getReadProof method generates a Merkle proof for the specified storage keys at a given block. This proof can be used to verify the existence and values of storage entries without needing to trust the node providing the data.

This method is essential for:

Light client verification
Cross-chain bridge operations
Trustless data verification
State proof generation

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getReadProofrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<Array<string> | string>required

Array containing storage keys and optional block hash.

Show child attributes

One of

Array<string>

Optional block hash to generate proof at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Read proof generated successfully

400Bad Request

Invalid storage keys or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get read proof for storage keys

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getReadProof",
    "id": 1,
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
      ],
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getReadProof",
      "id": 1,
      "params": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
        ],
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getReadProof",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getReadProof",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "at": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
    "proof": [
      "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid storage key format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error generating read proof"
  }
}

state_getRuntimeVersion

Get runtime version

POST

https://dot-assethub.nownodes.io/

Returns the version information of the runtime.

The state_getRuntimeVersion method provides detailed version information about the current runtime, including spec version, transaction version, and supported APIs. This information is crucial for compatibility checking and ensuring clients interact correctly with the chain.

This method is essential for:

Client compatibility verification
Runtime upgrade detection
Transaction version validation
Network protocol compatibility

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getRuntimeVersionrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Optional parameters array. Can be empty or contain an optional block hash for historical runtime version.

Response

200OK

Runtime version information retrieved successfully

400Bad Request

Invalid block hash or request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get runtime version

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getRuntimeVersion",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getRuntimeVersion",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getRuntimeVersion",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getRuntimeVersion",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "specName": "polkadot",
    "implName": "parity-polkadot",
    "authoringVersion": 1,
    "specVersion": 1002000,
    "implVersion": 0,
    "transactionVersion": 20,
    "stateVersion": 1,
    "apis": [
      [
        "0xdf6acb689907609b",
        4
      ],
      [
        "0x37e397fc7c91f5e4",
        2
      ]
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid block hash format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving runtime version"
  }
}

state_getStorageHash

Get storage entry hash

POST

https://dot-assethub.nownodes.io/

Returns the hash of a storage entry.

The state_getStorageHash method retrieves the hash of a specific storage entry at an optional block. This is useful for verifying storage contents without retrieving the full value, or for checking if a storage entry has changed.

This method is useful for:

Efficient storage change detection
Light client verification
Cache validation
Storage synchronization

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getStorageHashrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string>required

Array containing storage key and optional block hash.

Show child attributes

One of

Storage key in hex format

string

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage hash retrieved successfully

400Bad Request

Invalid storage key or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get storage entry hash

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getStorageHash",
    "id": 1,
    "params": [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getStorageHash",
      "id": 1,
      "params": [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getStorageHash",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getStorageHash",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid storage key format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving storage hash"
  }
}

state_getStorageSize

Get storage entry size

POST

https://dot-assethub.nownodes.io/

Returns the size of a storage entry in bytes.

The state_getStorageSize method retrieves the byte size of a specific storage entry at an optional block. This is useful for estimating storage costs, monitoring storage growth, and optimizing data structures.

This method is useful for:

Storage cost estimation
Data structure optimization
Storage growth monitoring
Resource planning

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getStorageSizerequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string>required

Array containing storage key and optional block hash.

Show child attributes

One of

Storage key in hex format

string

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage size retrieved successfully

400Bad Request

Invalid storage key or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get storage entry size

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getStorageSize",
    "id": 1,
    "params": [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getStorageSize",
      "id": 1,
      "params": [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getStorageSize",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getStorageSize",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x20"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid storage key format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving storage size"
  }
}

state_getStorage

Get storage entry value

POST

https://dot-assethub.nownodes.io/

Returns the value of a storage entry.

The state_getStorage method retrieves the actual value of a specific storage entry at an optional block. This is the primary method for reading chain state data including account balances, staking information, and other on-chain data.

This method is essential for:

Reading account balances and information
Querying staking and governance data
Accessing smart contract state
Building blockchain explorers

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getStoragerequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string>required

Array containing storage key and optional block hash.

Show child attributes

One of

Storage key in hex format

string

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage value retrieved successfully

400Bad Request

Invalid storage key or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get storage entry value

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getStorage",
    "id": 1,
    "params": [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getStorage",
      "id": 1,
      "params": [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getStorage",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getStorage",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0000000000000000000000000000000000000000000000000000000000000000"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid storage key format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving storage value"
  }
}

state_queryStorageAt

Query storage at specific block

POST

https://dot-assethub.nownodes.io/

Returns storage entries for multiple keys at a specific block.

The state_queryStorageAt method retrieves the values of multiple storage keys at an optional block hash. This is useful for batch queries and fetching related storage entries efficiently in a single request.

This method is essential for:

Batch storage queries
Fetching related data efficiently
Building complex data views
Optimizing application performance

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_queryStorageAtrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<Array<string> | string>required

Array containing storage keys and optional block hash.

Show child attributes

One of

Array<string>

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage values retrieved successfully

400Bad Request

Invalid storage keys or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Query storage at specific block

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_queryStorageAt",
    "id": 1,
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
      ],
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_queryStorageAt",
      "id": 1,
      "params": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
        ],
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_queryStorageAt",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_queryStorageAt",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "block": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "changes": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x0000000000000000000000000000000000000000000000000000000000000000"
        ],
        [
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4",
          null
        ]
      ]
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid storage key format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error querying storage"
  }
}

state_queryStorage

Query storage changes over a range of blocks

POST

https://dot-assethub.nownodes.io/

Returns storage entries for multiple keys over a range of blocks.

The state_queryStorage method retrieves the historical changes of storage keys between two blocks. This is essential for tracking state changes over time, building historical data views, and analyzing storage evolution.

This method is essential for:

Historical data analysis
State change tracking
Building time-series data
Audit and compliance reporting

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_queryStoragerequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<Array<string> | string | string>required

Array containing storage keys, start block hash, and optional end block hash.

Show child attributes

One of

Array<string>

Start block hash for the query range

string

Optional end block hash for the query range. If omitted, uses the latest finalized block.

string

Response

200OK

Storage changes retrieved successfully

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Query storage changes over a range of blocks

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_queryStorage",
    "id": 1,
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
      ],
      "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_queryStorage",
      "id": 1,
      "params": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
        ],
        "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_queryStorage",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_queryStorage",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "block": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "changes": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x0000000000000000000000000000000000000000000000000000000000000000"
        ],
        [
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4",
          null
        ]
      ]
    },
    {
      "block": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "changes": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x0100000000000000000000000000000000000000000000000000000000000000"
        ],
        [
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4",
          "0x0200000000000000000000000000000000000000000000000000000000000000"
        ]
      ]
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid block hash format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error querying storage history"
  }
}

system_chain

Get chain name

POST

https://dot-assethub.nownodes.io/

Returns the chain name.

The system_chain method retrieves the human-readable name of the chain the node is connected to. This helps identify the network and ensure applications are interacting with the correct blockchain.

This method is useful for:

Network identification
Multi-chain applications
User interface display
Configuration validation

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringsystem_chainrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

Chain name retrieved successfully

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get chain name

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "system_chain",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "system_chain",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "system_chain",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "system_chain",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "Polkadot"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving chain name"
  }
}

system_properties

Get system properties

POST

https://dot-assethub.nownodes.io/

Returns custom properties of the chain.

The system_properties method retrieves a collection of chain-specific properties that define the network's configuration and characteristics. These properties are essential for applications to properly interact with the chain.

This method is essential for:

Chain configuration discovery
Token decimal and SS58 format configuration
Network-specific feature detection
Wallet and application setup

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringsystem_propertiesrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

System properties retrieved successfully

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get system properties

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "system_properties",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "system_properties",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "system_properties",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "system_properties",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "ss58Format": 0,
    "tokenDecimals": [
      10
    ],
    "tokenSymbol": [
      "DOT"
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving system properties"
  }
}

Node / JSON-RPC

author_pendingExtrinsics

Get pending extrinsics from transaction pool

POST

https://dot-assethub.nownodes.io/

Returns all pending extrinsics, potentially grouped by sender.

The author_pendingExtrinsics method retrieves all transactions that are currently in the transaction pool (mempool) waiting to be included in a block.

This method is useful for:

Monitoring transaction pool status
Debugging transaction propagation issues
Building transaction explorers
Analyzing network congestion

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringauthor_pendingExtrinsicsrequired

The method to be invoked

idstringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

Successful response with pending extrinsics

400Bad Request

Invalid request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get pending extrinsics from transaction pool

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "author_pendingExtrinsics",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "author_pendingExtrinsics",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "author_pendingExtrinsics",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "author_pendingExtrinsics",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    "0x2804020000d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d0000a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000",
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000",
    "0x31028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a4800000000000000000000000000000000000000"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid request",
    "data": "Method not found"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error processing request"
  }
}

author_submitAndWatchExtrinsic

Submit and watch extrinsic

POST

https://dot-assethub.nownodes.io/

Submit a fully-formed extrinsic and watch for its lifecycle events.

This method provides real-time updates about the extrinsic's status including:

When it enters the transaction pool
When it is included in a block
Finalization status
Any errors that occur

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringauthor_submitAndWatchExtrinsicrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing the hex-encoded extrinsic

Response

200OK

Extrinsic submitted successfully, subscription created

400Bad Request

Invalid extrinsic or request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Submit and watch extrinsic

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "author_submitAndWatchExtrinsic",
    "id": 1,
    "params": [
      "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "author_submitAndWatchExtrinsic",
      "id": 1,
      "params": [
        "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "author_submitAndWatchExtrinsic",
  "id": 1,
  "params": [
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "author_submitAndWatchExtrinsic",
  "id": 1,
  "params": [
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1234567890abcdef"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid extrinsic format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Failed to submit extrinsic"
  }
}

author_submitExtrinsic

Submit a fully-formed extrinsic

POST

https://dot-assethub.nownodes.io/

Submit a fully-formed extrinsic for inclusion in a block.

This method is suitable for applications that don't require immediate status updates and prefer a fire-and-forget approach to transaction submission.

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringauthor_submitExtrinsicrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing the hex-encoded extrinsic

Response

200OK

Extrinsic submitted successfully

400Bad Request

Invalid extrinsic or request

500Internal Server Error

Internal server error or pool rejection

Authorization

ApiKeyAuthapiKey in header

Submit a fully-formed extrinsic

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "author_submitExtrinsic",
    "id": 1,
    "params": [
      "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "author_submitExtrinsic",
      "id": 1,
      "params": [
        "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "author_submitExtrinsic",
  "id": 1,
  "params": [
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "author_submitExtrinsic",
  "id": 1,
  "params": [
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid extrinsic format: bad signature"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Pool error: Invalid transaction"
  }
}

chain_getBlockHash

Get block hash by block number

POST

https://dot-assethub.nownodes.io/

Get the hash of a specific block by its block number.

The chain_getBlockHash method returns the hash of the block header for the specified block number. If no block number is provided, it returns the hash of the latest finalized block.

This method is essential for:

Navigating the blockchain by block height
Verifying block existence and integrity
Building block explorers
Cross-referencing blocks across different queries

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringchain_getBlockHashrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<integer | string>required

Array containing optional block number

Show child attributes

One of

Block number (height) to query

integer

Block number as hex string

string

Response

200OK

Block hash retrieved successfully

400Bad Request

Invalid block number or request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get block hash by block number

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "chain_getBlockHash",
    "id": 1,
    "params": [
      "0xbc614e"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "chain_getBlockHash",
      "id": 1,
      "params": [
        "0xbc614e"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chain_getBlockHash",
  "id": 1,
  "params": [
    "0xbc614e"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "chain_getBlockHash",
  "id": 1,
  "params": [
    "0xbc614e"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Block number out of range"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving block hash"
  }
}

chain_getBlock

Get block by hash

POST

https://dot-assethub.nownodes.io/

Get a block by its hash.

The chain_getBlock method returns the full block data including the block header and all contained extrinsics (transactions). If no block hash is provided, it returns the latest finalized block.

This method provides complete information about a block including:

Block header with metadata
All extrinsics (transactions) in the block
Block production details
Parent-child relationships

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringchain_getBlockrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing optional block hash

Response

200OK

Block data retrieved successfully

400Bad Request

Invalid block hash or request

404Not Found

Block not found

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get block by hash

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "chain_getBlock",
    "id": 1,
    "params": [
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "chain_getBlock",
      "id": 1,
      "params": [
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chain_getBlock",
  "id": 1,
  "params": [
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "chain_getBlock",
  "id": 1,
  "params": [
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "block": {
      "extrinsics": [
        "0x2804020000d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d0000a0db2df800",
        "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000"
      ],
      "header": {
        "digest": {
          "logs": [
            "0x0642414245340201000000ef55a50f00000000",
            "0x0542414245010100c0e62f4f9b43e90e0c1b7c8d6e35d"
          ]
        },
        "extrinsicsRoot": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
        "number": "0xbc614e",
        "parentHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "stateRoot": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      }
    },
    "justifications": null
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid block hash format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": null
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving block data"
  }
}

chain_getFinalizedHead

Get latest finalized block hash

POST

https://dot-assethub.nownodes.io/

Get the hash of the most recent finalized block.

This method is crucial for:

Determining safe block height for transactions
Building applications that require finality guarantees
Monitoring chain progression and stability
Ensuring data consistency across services

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringchain_getFinalizedHeadrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

Finalized block hash retrieved successfully

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get latest finalized block hash

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "chain_getFinalizedHead",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "chain_getFinalizedHead",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chain_getFinalizedHead",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "chain_getFinalizedHead",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving finalized head"
  }
}

chain_getHeader

Get Block Header

POST

https://dot-assethub.nownodes.io/

Returns the header of the most recent (best) block in the Polkadot blockchain.

This method is part of the Polkadot JSON-RPC 2.0 specification for chain-related operations. The header contains critical information about the block including hashes, roots, and consensus data.

Body

application/json

jsonrpcstring2.0required

The JSON-RPC protocol version. Must be exactly "2.0".

methodstringchain_getHeaderrequired

The JSON-RPC method to call. For this endpoint, must be "chain_getHeader".

paramsArray<any>required

Parameters for the method. For chain_getHeader, this should be an empty array as it retrieves the latest block header without additional parameters.

idinteger<int32>required

Request identifier that will be returned in the response. Used to match requests with responses when making multiple concurrent calls.

Response

200OK

Successful response containing the block header information.

The header represents the most recent block in the best chain and contains cryptographic commitments to the block's contents and state.

400Bad Request

Bad Request - Invalid JSON-RPC request Possible reasons:

Invalid JSON syntax
Missing required fields
Invalid method name
Invalid parameters

500Internal Server Error

Internal Server Error The node encountered an internal error while processing the request.

503Service Unavailable

Service Unavailable The node is currently unavailable, possibly due to maintenance or synchronization.

Authorization

ApiKeyAuthapiKey in header

Get Block Header

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "chain_getHeader",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "chain_getHeader",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "chain_getHeader",
  "params": [],
  "id": 1
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "chain_getHeader",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "parentHash": "0x8f9c2b45286b9d241e43299a980aec6674aacc000fb3682d178f0116a0e09c0a",
    "number": "0x1b67a92",
    "stateRoot": "0x5df4b77648285c0b4ee27fdf52e4566c48990b5357058b5fcc492bff2e8aa87e",
    "extrinsicsRoot": "0xbee43c93d0459704b769eac77fd999099aa9a443501df7057df0f8761fef1472",
    "digest": {
      "logs": [
        "0x0642414245b501036700000068608511000000005e76194dbd931c0eec4b706d3e362725dda289c581a61189cf3fe246596a87717ce5ec5146bf1ff0952733eeaf992548990b7e4bbdc3a4a73eae788f5cf862083bf9f2f1ce9119558aa04ba7c98acd9e6b4713252868a661912bf5b098ae9003",
        "0x044245454684036a4f28650461c9c3bfadc940a61e35a243c8a016acd160bb21e3b573392c6e83",
        "0x05424142450101bab5e08f59e82f4f25d55dcf31dda08b2f54264404f386ddc4b273b5a48ac64294e0d59fc5dacdab63a8ef295844da8e82dfc9de35c9f0f9bbf2efe21e9eaf81"
      ]
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid request"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Server unavailable"
  }
}

payment_queryInfo

Query transaction fee information

POST

https://dot-assethub.nownodes.io/

Retrieve the transaction fee information for an extrinsic.

This method is essential for:

Wallet applications showing fee estimates
DApps calculating transaction costs
Users verifying transaction affordability
Batch transaction cost optimization

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringpayment_queryInforequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing the hex-encoded extrinsic

Response

200OK

Fee information retrieved successfully

400Bad Request

Invalid extrinsic or request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Query transaction fee information

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "payment_queryInfo",
    "id": 1,
    "params": [
      "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "payment_queryInfo",
      "id": 1,
      "params": [
        "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "payment_queryInfo",
  "id": 1,
  "params": [
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "payment_queryInfo",
  "id": 1,
  "params": [
    "0x2d028400d43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d00a0db2df800ff8eaf04151687736326c9fea17e25fc5287613693c912909cb226aa4794f26a480000000000000000000000000000000"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "partialFee": "1000000000",
    "weight": {
      "refTime": "1000000000",
      "proofSize": "10000"
    },
    "class": "Normal",
    "paysFee": "Yes"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid extrinsic format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error calculating transaction fees"
  }
}

state_getMetadata

Get runtime metadata

POST

https://dot-assethub.nownodes.io/

Returns the runtime metadata as a hex-encoded string.

This method is crucial for:

Generating type definitions for applications
Understanding available storage items and extrinsics
Building dynamic DApp interfaces
Runtime version compatibility checking

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getMetadatarequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Optional parameters array. Can be empty or contain an optional block hash for historical metadata.

Response

200OK

Runtime metadata retrieved successfully

400Bad Request

Invalid request parameters

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get runtime metadata

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getMetadata",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getMetadata",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getMetadata",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getMetadata",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x6d6574610e0000001c00000000000000020000000000000003000000000000000400000000000000"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid block hash format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving metadata"
  }
}

state_getReadProof

Get read proof for storage keys

POST

https://dot-assethub.nownodes.io/

Returns proof of storage entries at a specific block.

This method is essential for:

Light client verification
Cross-chain bridge operations
Trustless data verification
State proof generation

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getReadProofrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<Array<string> | string>required

Array containing storage keys and optional block hash.

Show child attributes

One of

Array<string>

Optional block hash to generate proof at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Read proof generated successfully

400Bad Request

Invalid storage keys or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get read proof for storage keys

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getReadProof",
    "id": 1,
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
      ],
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getReadProof",
      "id": 1,
      "params": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
        ],
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getReadProof",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getReadProof",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "at": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
    "proof": [
      "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid storage key format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error generating read proof"
  }
}

state_getRuntimeVersion

Get runtime version

POST

https://dot-assethub.nownodes.io/

Returns the version information of the runtime.

This method is essential for:

Client compatibility verification
Runtime upgrade detection
Transaction version validation
Network protocol compatibility

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getRuntimeVersionrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Optional parameters array. Can be empty or contain an optional block hash for historical runtime version.

Response

200OK

Runtime version information retrieved successfully

400Bad Request

Invalid block hash or request

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get runtime version

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getRuntimeVersion",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getRuntimeVersion",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getRuntimeVersion",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getRuntimeVersion",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "specName": "polkadot",
    "implName": "parity-polkadot",
    "authoringVersion": 1,
    "specVersion": 1002000,
    "implVersion": 0,
    "transactionVersion": 20,
    "stateVersion": 1,
    "apis": [
      [
        "0xdf6acb689907609b",
        4
      ],
      [
        "0x37e397fc7c91f5e4",
        2
      ]
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid block hash format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving runtime version"
  }
}

state_getStorageHash

Get storage entry hash

POST

https://dot-assethub.nownodes.io/

Returns the hash of a storage entry.

This method is useful for:

Efficient storage change detection
Light client verification
Cache validation
Storage synchronization

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getStorageHashrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string>required

Array containing storage key and optional block hash.

Show child attributes

One of

Storage key in hex format

string

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage hash retrieved successfully

400Bad Request

Invalid storage key or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get storage entry hash

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getStorageHash",
    "id": 1,
    "params": [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getStorageHash",
      "id": 1,
      "params": [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getStorageHash",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getStorageHash",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid storage key format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving storage hash"
  }
}

state_getStorageSize

Get storage entry size

POST

https://dot-assethub.nownodes.io/

Returns the size of a storage entry in bytes.

This method is useful for:

Storage cost estimation
Data structure optimization
Storage growth monitoring
Resource planning

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getStorageSizerequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string>required

Array containing storage key and optional block hash.

Show child attributes

One of

Storage key in hex format

string

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage size retrieved successfully

400Bad Request

Invalid storage key or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get storage entry size

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getStorageSize",
    "id": 1,
    "params": [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getStorageSize",
      "id": 1,
      "params": [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getStorageSize",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getStorageSize",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x20"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid storage key format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving storage size"
  }
}

state_getStorage

Get storage entry value

POST

https://dot-assethub.nownodes.io/

Returns the value of a storage entry.

This method is essential for:

Reading account balances and information
Querying staking and governance data
Accessing smart contract state
Building blockchain explorers

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getStoragerequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string>required

Array containing storage key and optional block hash.

Show child attributes

One of

Storage key in hex format

string

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage value retrieved successfully

400Bad Request

Invalid storage key or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get storage entry value

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getStorage",
    "id": 1,
    "params": [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_getStorage",
      "id": 1,
      "params": [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_getStorage",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_getStorage",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0000000000000000000000000000000000000000000000000000000000000000"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid storage key format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving storage value"
  }
}

state_queryStorageAt

Query storage at specific block

POST

https://dot-assethub.nownodes.io/

Returns storage entries for multiple keys at a specific block.

This method is essential for:

Batch storage queries
Fetching related data efficiently
Building complex data views
Optimizing application performance

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_queryStorageAtrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<Array<string> | string>required

Array containing storage keys and optional block hash.

Show child attributes

One of

Array<string>

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage values retrieved successfully

400Bad Request

Invalid storage keys or block hash

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Query storage at specific block

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_queryStorageAt",
    "id": 1,
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
      ],
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_queryStorageAt",
      "id": 1,
      "params": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
        ],
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_queryStorageAt",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_queryStorageAt",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "block": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "changes": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x0000000000000000000000000000000000000000000000000000000000000000"
        ],
        [
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4",
          null
        ]
      ]
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid storage key format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error querying storage"
  }
}

state_queryStorage

Query storage changes over a range of blocks

POST

https://dot-assethub.nownodes.io/

Returns storage entries for multiple keys over a range of blocks.

This method is essential for:

Historical data analysis
State change tracking
Building time-series data
Audit and compliance reporting

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_queryStoragerequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<Array<string> | string | string>required

Array containing storage keys, start block hash, and optional end block hash.

Show child attributes

One of

Array<string>

Start block hash for the query range

string

Optional end block hash for the query range. If omitted, uses the latest finalized block.

string

Response

200OK

Storage changes retrieved successfully

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Query storage changes over a range of blocks

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_queryStorage",
    "id": 1,
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
      ],
      "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_queryStorage",
      "id": 1,
      "params": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
        ],
        "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_queryStorage",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_queryStorage",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "block": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "changes": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x0000000000000000000000000000000000000000000000000000000000000000"
        ],
        [
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4",
          null
        ]
      ]
    },
    {
      "block": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "changes": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x0100000000000000000000000000000000000000000000000000000000000000"
        ],
        [
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4",
          "0x0200000000000000000000000000000000000000000000000000000000000000"
        ]
      ]
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid block hash format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error querying storage history"
  }
}

system_chain

Get chain name

POST

https://dot-assethub.nownodes.io/

Returns the chain name.

The system_chain method retrieves the human-readable name of the chain the node is connected to. This helps identify the network and ensure applications are interacting with the correct blockchain.

This method is useful for:

Network identification
Multi-chain applications
User interface display
Configuration validation

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringsystem_chainrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

Chain name retrieved successfully

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get chain name

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "system_chain",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "system_chain",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "system_chain",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "system_chain",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "Polkadot"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving chain name"
  }
}

system_properties

Get system properties

POST

https://dot-assethub.nownodes.io/

Returns custom properties of the chain.

This method is essential for:

Chain configuration discovery
Token decimal and SS58 format configuration
Network-specific feature detection
Wallet and application setup

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringsystem_propertiesrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array for this method

Response

200OK

System properties retrieved successfully

500Internal Server Error

Internal server error

Authorization

ApiKeyAuthapiKey in header

Get system properties

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "system_properties",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "system_properties",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "system_properties",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "system_properties",
  "id": 1,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "ss58Format": 0,
    "tokenDecimals": [
      10
    ],
    "tokenSymbol": [
      "DOT"
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error retrieving system properties"
  }
}

system_health

Get Node Health Status

POST

https://dot-assethub.nownodes.io/

Returns the current health status of the Polkadot node. This includes the number of connected peers, whether the node is syncing with the network, and whether it should have active peer connections. This method is commonly used for monitoring node availability and readiness.

Body

application/json

jsonrpcstring

JSON-RPC protocol version. Polkadot uses version "2.0".

methodstring

The name of the RPC method to call.

idinteger

Unique identifier for the request. Used to match responses with requests.

paramsArray<any>

Parameters for the method. This method does not require any parameters.

Response

200OK

Successful response with node health information.

Authorization

ApiKeyAuthapiKey in header

Get Node Health Status

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "system_health",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "system_health",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "system_health",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "system_health",
  "id": 1,
  "params": []
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "peers": 9,
    "isSyncing": false,
    "shouldHavePeers": true
  }
}

system_syncState

Get Node Synchronization State

POST

https://dot-assethub.nownodes.io/

Returns the current synchronization state of the Polkadot node. This includes the block number where synchronization started, the current block the node has synced to, and the highest known block in the network. This method is useful for monitoring sync progress and determining if a node is fully synchronized.

Body

application/json

jsonrpcstring

JSON-RPC protocol version. Polkadot uses version "2.0".

methodstring

The name of the RPC method to call.

idinteger

Unique identifier for the request. Used to match responses with requests.

paramsArray<any>

Parameters for the method. This method does not require any parameters.

Response

200OK

Successful response with node synchronization state information.

Authorization

ApiKeyAuthapiKey in header

Get Node Synchronization State

curl -X POST 'https://dot-assethub.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "system_syncState",
    "id": 1,
    "params": []
  }'

const response = await fetch('https://dot-assethub.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "system_syncState",
      "id": 1,
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "system_syncState",
  "id": 1,
  "params": []
}

response = requests.post('https://dot-assethub.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "system_syncState",
  "id": 1,
  "params": []
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "startingBlock": 30541267,
    "currentBlock": 30586359,
    "highestBlock": 30586359
  }
}

Asset Hub / PLAYBOOK

health

Health check

GET

https://dot-assethub.nownodes.io/v1/health

Returns the health status of the API server.

Response

202Accepted

API is healthy

Authorization

api-keyAuthapiKey in header

Health check

curl -X GET 'https://dot-assethub.nownodes.io/v1/health'

const response = await fetch('https://dot-assethub.nownodes.io/v1/health', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/health')
data = response.json()

202

{
  "connected_chains": 0,
  "status": "string",
  "uptime": 0
}

node

Connected node information

Node network info

GET

https://dot-assethub.nownodes.io/v1/node/network

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

Authorization

api-keyAuthapiKey in header

Node network info

curl -X GET 'https://dot-assethub.nownodes.io/v1/node/network'

const response = await fetch('https://dot-assethub.nownodes.io/v1/node/network', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/node/network')
data = response.json()

200

{}

Transaction pool

GET

https://dot-assethub.nownodes.io/v1/node/transaction-pool

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

Authorization

api-keyAuthapiKey in header

Transaction pool

curl -X GET 'https://dot-assethub.nownodes.io/v1/node/transaction-pool'

const response = await fetch('https://dot-assethub.nownodes.io/v1/node/transaction-pool', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/node/transaction-pool')
data = response.json()

200

{
  "pool": [
    {
      "encodedExtrinsic": "string",
      "hash": "string",
      "partialFee": "string",
      "priority": "string",
      "tip": "string"
    }
  ]
}

Node version

GET

https://dot-assethub.nownodes.io/v1/node/version

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

Authorization

api-keyAuthapiKey in header

Node version

curl -X GET 'https://dot-assethub.nownodes.io/v1/node/version'

const response = await fetch('https://dot-assethub.nownodes.io/v1/node/version', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/node/version')
data = response.json()

200

{
  "chain": "string",
  "clientImplName": "string",
  "clientVersion": "string"
}

version

API version

GET

https://dot-assethub.nownodes.io/v1/version

Returns the current version of the Polkadot REST API.

Response

200OK

API version

Authorization

api-keyAuthapiKey in header

API version

curl -X GET 'https://dot-assethub.nownodes.io/v1/version'

const response = await fetch('https://dot-assethub.nownodes.io/v1/version', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/version')
data = response.json()

200

{
  "version": "string"
}

blocks

Block queries and extrinsic data

Get blocks by range

GET

https://dot-assethub.nownodes.io/v1/blocks

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

Authorization

api-keyAuthapiKey in header

Get blocks by range

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks')
data = response.json()

200

[
  {}
]

Get latest block

GET

https://dot-assethub.nownodes.io/v1/blocks/head

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

Authorization

api-keyAuthapiKey in header

Get latest block

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/head'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/head', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/head')
data = response.json()

200

{}

Get head block header

GET

https://dot-assethub.nownodes.io/v1/blocks/head/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

Authorization

api-keyAuthapiKey in header

Get head block header

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/head/header'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/head/header', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/head/header')
data = response.json()

200

{}

Get block by ID

GET

https://dot-assethub.nownodes.io/v1/blocks/{blockId}

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

Authorization

api-keyAuthapiKey in header

Get block by ID

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/{blockId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/{blockId}')
data = response.json()

200

{}

Get raw extrinsics

GET

https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics-raw

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

Authorization

api-keyAuthapiKey in header

Get raw extrinsics

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics-raw'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics-raw', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics-raw')
data = response.json()

200

{}

Get extrinsic by index

GET

https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics/{extrinsicIndex}

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

Authorization

api-keyAuthapiKey in header

Get extrinsic by index

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics/{extrinsicIndex}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics/{extrinsicIndex}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics/{extrinsicIndex}')
data = response.json()

200

{}

Get block header by ID

GET

https://dot-assethub.nownodes.io/v1/blocks/{blockId}/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

Authorization

api-keyAuthapiKey in header

Get block header by ID

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/{blockId}/header'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/header', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/header')
data = response.json()

200

{}

Get parachain inclusions

GET

https://dot-assethub.nownodes.io/v1/blocks/{blockId}/para-inclusions

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

Authorization

api-keyAuthapiKey in header

Get parachain inclusions

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/{blockId}/para-inclusions'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/para-inclusions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/para-inclusions')
data = response.json()

200

{}

accounts

Account balance, staking, and proxy information

Compare account addresses

GET

https://dot-assethub.nownodes.io/v1/accounts/compare

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

Authorization

api-keyAuthapiKey in header

Compare account addresses

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/compare'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/compare', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/compare')
data = response.json()

200

{
  "addresses": [
    {
      "network": "string",
      "publicKey": "string",
      "ss58Format": "string",
      "ss58Prefix": 0
    }
  ],
  "areEqual": true
}

Account asset approvals

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-approvals

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

Authorization

api-keyAuthapiKey in header

Account asset approvals

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-approvals'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-approvals', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-approvals')
data = response.json()

200

{
  "ahTimestamp": "string",
  "amount": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "deposit": "string",
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}

Account asset balances

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-balances

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

Authorization

api-keyAuthapiKey in header

Account asset balances

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-balances'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-balances', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-balances')
data = response.json()

200

{
  "ahTimestamp": "string",
  "assets": [
    {
      "assetId": "string",
      "balance": "string",
      "isFrozen": true,
      "isSufficient": true
    }
  ],
  "at": {
    "hash": "string",
    "height": "string"
  },
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}

Account balance info

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/balance-info

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

Authorization

api-keyAuthapiKey in header

Account balance info

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/balance-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/balance-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/balance-info')
data = response.json()

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "feeFrozen": "string",
  "free": "string",
  "frozen": "string",
  "locks": [
    {
      "amount": "string",
      "id": "string",
      "reasons": "string"
    }
  ],
  "miscFrozen": "string",
  "nonce": "string",
  "rcBlockHash": "string",
  "rcBlockNumber": "string",
  "reserved": "string",
  "tokenSymbol": "string",
  "transferable": "string"
}

Convert account format

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/convert

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

Authorization

api-keyAuthapiKey in header

Convert account format

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/convert'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/convert', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/convert')
data = response.json()

200

{
  "accountId": "string",
  "address": "string",
  "network": "string",
  "publicKey": true,
  "scheme": "string",
  "ss58Prefix": 0
}

Account foreign asset balances

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/foreign-asset-balances

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

Authorization

api-keyAuthapiKey in header

Account foreign asset balances

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/foreign-asset-balances'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/foreign-asset-balances', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/foreign-asset-balances')
data = response.json()

200

{}

Account pool asset approvals

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-approvals

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

Authorization

api-keyAuthapiKey in header

Account pool asset approvals

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-approvals'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-approvals', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-approvals')
data = response.json()

200

{
  "ahTimestamp": "string",
  "amount": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "deposit": "string",
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}

Account pool asset balances

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-balances

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

Authorization

api-keyAuthapiKey in header

Account pool asset balances

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-balances'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-balances', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-balances')
data = response.json()

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "poolAssets": [
    {
      "assetId": "string",
      "balance": "string",
      "isFrozen": true,
      "isSufficient": true
    }
  ],
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}

Account proxy info

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/proxy-info

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

Authorization

api-keyAuthapiKey in header

Account proxy info

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/proxy-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/proxy-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/proxy-info')
data = response.json()

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "delegatedAccounts": [
    {
      "delay": "string",
      "delegate": "string",
      "proxyType": "string"
    }
  ],
  "depositHeld": "string",
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}

Account staking info

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-info

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

Authorization

api-keyAuthapiKey in header

Account staking info

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-info')
data = response.json()

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "controller": "string",
  "nominations": {
    "submittedIn": "string",
    "suppressed": true,
    "targets": [
      "string"
    ]
  },
  "numSlashingSpans": "string",
  "rcBlockHash": "string",
  "rcBlockNumber": "string",
  "rewardDestination": {
    "staked": null
  },
  "staking": {
    "active": "string",
    "claimedRewards": [
      {
        "era": "string",
        "status": "string"
      }
    ],
    "stash": "string",
    "total": "string",
    "unlocking": [
      {
        "era": "string",
        "value": "string"
      }
    ]
  }
}

Account staking payouts

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-payouts

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

Authorization

api-keyAuthapiKey in header

Account staking payouts

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-payouts'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-payouts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-payouts')
data = response.json()

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "erasPayouts": [
    {
      "era": "string",
      "payouts": [
        {
          "claimed": true,
          "nominatorExposure": "string",
          "nominatorStakingPayout": "string",
          "totalValidatorExposure": "string",
          "totalValidatorRewardPoints": "string",
          "validatorCommission": "string",
          "validatorId": "string"
        }
      ],
      "totalEraPayout": "string",
      "totalEraRewardPoints": "string"
    }
  ],
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}

Validate account address

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/validate

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

Authorization

api-keyAuthapiKey in header

Validate account address

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/validate'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/validate', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/validate')
data = response.json()

200

{
  "accountId": "string",
  "isValid": true,
  "network": "string",
  "ss58Prefix": "string"
}

Account vesting info

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/vesting-info

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

Authorization

api-keyAuthapiKey in header

Account vesting info

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/vesting-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/vesting-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/vesting-info')
data = response.json()

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "rcBlockHash": "string",
  "rcBlockNumber": "string",
  "vesting": [
    {
      "locked": "string",
      "perBlock": "string",
      "startingBlock": "string"
    }
  ]
}

pallets

Runtime pallet metadata, storage, constants, events, errors

Liquidity pools

GET

https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/liquidity-pools

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

Authorization

api-keyAuthapiKey in header

Liquidity pools

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/liquidity-pools'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/liquidity-pools', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/liquidity-pools')
data = response.json()

200

{}

Next available pool ID

GET

https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/next-available-id

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

Authorization

api-keyAuthapiKey in header

Next available pool ID

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/next-available-id'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/next-available-id', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/next-available-id')
data = response.json()

200

{}

Asset info

GET

https://dot-assethub.nownodes.io/v1/pallets/assets/{assetId}/asset-info

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

Authorization

api-keyAuthapiKey in header

Asset info

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/assets/{assetId}/asset-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/assets/{assetId}/asset-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/assets/{assetId}/asset-info')
data = response.json()

200

{}

Foreign assets

GET

https://dot-assethub.nownodes.io/v1/pallets/foreign-assets

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

Authorization

api-keyAuthapiKey in header

Foreign assets

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/foreign-assets'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/foreign-assets', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/foreign-assets')
data = response.json()

200

{}

Nomination pools info

GET

https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/info

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

Authorization

api-keyAuthapiKey in header

Nomination pools info

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/info')
data = response.json()

200

{}

Nomination pool details

GET

https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/{poolId}

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

Authorization

api-keyAuthapiKey in header

Nomination pool details

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/{poolId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/{poolId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/{poolId}')
data = response.json()

200

{}

On-going referenda

GET

https://dot-assethub.nownodes.io/v1/pallets/on-going-referenda

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

Authorization

api-keyAuthapiKey in header

On-going referenda

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/on-going-referenda'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/on-going-referenda', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/on-going-referenda')
data = response.json()

200

{}

Pool asset info

GET

https://dot-assethub.nownodes.io/v1/pallets/pool-assets/{assetId}/asset-info

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

Authorization

api-keyAuthapiKey in header

Pool asset info

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/pool-assets/{assetId}/asset-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/pool-assets/{assetId}/asset-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/pool-assets/{assetId}/asset-info')
data = response.json()

200

{}

Staking progress

GET

https://dot-assethub.nownodes.io/v1/pallets/staking/progress

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

Authorization

api-keyAuthapiKey in header

Staking progress

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/staking/progress'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/staking/progress', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/staking/progress')
data = response.json()

200

{}

Staking validators

GET

https://dot-assethub.nownodes.io/v1/pallets/staking/validators

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

Authorization

api-keyAuthapiKey in header

Staking validators

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/staking/validators'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/staking/validators', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/staking/validators')
data = response.json()

200

{}

Pallet constants

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts

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

Authorization

api-keyAuthapiKey in header

Pallet constants

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts')
data = response.json()

200

{}

Pallet constant value

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts/{constantItemId}

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

Authorization

api-keyAuthapiKey in header

Pallet constant value

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts/{constantItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts/{constantItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts/{constantItemId}')
data = response.json()

200

{}

Pallet dispatchables

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables

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

Authorization

api-keyAuthapiKey in header

Pallet dispatchables

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables')
data = response.json()

200

{}

Pallet dispatchable details

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables/{dispatchableId}

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

Authorization

api-keyAuthapiKey in header

Pallet dispatchable details

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables/{dispatchableId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables/{dispatchableId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables/{dispatchableId}')
data = response.json()

200

{}

Pallet errors

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors

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

Authorization

api-keyAuthapiKey in header

Pallet errors

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors')
data = response.json()

200

{}

Pallet error details

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors/{errorItemId}

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

Authorization

api-keyAuthapiKey in header

Pallet error details

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors/{errorItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors/{errorItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors/{errorItemId}')
data = response.json()

200

{}

Get pallet events

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events

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

Authorization

api-keyAuthapiKey in header

Get pallet events

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events')
data = response.json()

200

{}

Get pallet event item

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events/{eventItemId}

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

Authorization

api-keyAuthapiKey in header

Get pallet event item

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events/{eventItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events/{eventItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events/{eventItemId}')
data = response.json()

200

{}

Pallet storage items

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage

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

Authorization

api-keyAuthapiKey in header

Pallet storage items

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage')
data = response.json()

200

{}

Pallet storage item value

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage/{storageItemId}

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

Authorization

api-keyAuthapiKey in header

Pallet storage item value

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage/{storageItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage/{storageItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage/{storageItemId}')
data = response.json()

200

{}

runtime

Runtime specification, metadata, and code

Runtime Wasm code

GET

https://dot-assethub.nownodes.io/v1/runtime/code

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

Authorization

api-keyAuthapiKey in header

Runtime Wasm code

curl -X GET 'https://dot-assethub.nownodes.io/v1/runtime/code'

const response = await fetch('https://dot-assethub.nownodes.io/v1/runtime/code', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/runtime/code')
data = response.json()

200

{}

Runtime metadata

GET

https://dot-assethub.nownodes.io/v1/runtime/metadata

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

Authorization

api-keyAuthapiKey in header

Runtime metadata

curl -X GET 'https://dot-assethub.nownodes.io/v1/runtime/metadata'

const response = await fetch('https://dot-assethub.nownodes.io/v1/runtime/metadata', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/runtime/metadata')
data = response.json()

200

{}

Available metadata versions

GET

https://dot-assethub.nownodes.io/v1/runtime/metadata/versions

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

Authorization

api-keyAuthapiKey in header

Available metadata versions

curl -X GET 'https://dot-assethub.nownodes.io/v1/runtime/metadata/versions'

const response = await fetch('https://dot-assethub.nownodes.io/v1/runtime/metadata/versions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/runtime/metadata/versions')
data = response.json()

200

[
  "string"
]

Runtime metadata by version

GET

https://dot-assethub.nownodes.io/v1/runtime/metadata/{version}

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

Authorization

api-keyAuthapiKey in header

Runtime metadata by version

curl -X GET 'https://dot-assethub.nownodes.io/v1/runtime/metadata/{version}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/runtime/metadata/{version}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/runtime/metadata/{version}')
data = response.json()

200

{}

Runtime specification

GET

https://dot-assethub.nownodes.io/v1/runtime/spec

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

Authorization

api-keyAuthapiKey in header

Runtime specification

curl -X GET 'https://dot-assethub.nownodes.io/v1/runtime/spec'

const response = await fetch('https://dot-assethub.nownodes.io/v1/runtime/spec', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/runtime/spec')
data = response.json()

200

{}

transaction

Transaction submission, fee estimation, and construction material

Submit transaction

POST

https://dot-assethub.nownodes.io/v1/transaction

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

Authorization

api-keyAuthapiKey in header

Submit transaction

curl -X POST 'https://dot-assethub.nownodes.io/v1/transaction' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/transaction', json=payload)
data = response.json()

Request Body

{}

200

{}

Dry run transaction

POST

https://dot-assethub.nownodes.io/v1/transaction/dry-run

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

Authorization

api-keyAuthapiKey in header

Dry run transaction

curl -X POST 'https://dot-assethub.nownodes.io/v1/transaction/dry-run' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction/dry-run', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/transaction/dry-run', json=payload)
data = response.json()

Request Body

{}

200

{}

Estimate transaction fee

POST

https://dot-assethub.nownodes.io/v1/transaction/fee-estimate

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

Authorization

api-keyAuthapiKey in header

Estimate transaction fee

curl -X POST 'https://dot-assethub.nownodes.io/v1/transaction/fee-estimate' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction/fee-estimate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/transaction/fee-estimate', json=payload)
data = response.json()

Request Body

{}

200

{
  "class": "string",
  "partialFee": "string",
  "weight": {
    "proofSize": "string",
    "refTime": "string"
  }
}

Transaction construction material

GET

https://dot-assethub.nownodes.io/v1/transaction/material

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

Authorization

api-keyAuthapiKey in header

Transaction construction material

curl -X GET 'https://dot-assethub.nownodes.io/v1/transaction/material'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction/material', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/transaction/material')
data = response.json()

200

{}

Transaction material with versioned metadata

GET

https://dot-assethub.nownodes.io/v1/transaction/material/{metadataVersion}

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

Authorization

api-keyAuthapiKey in header

Transaction material with versioned metadata

curl -X GET 'https://dot-assethub.nownodes.io/v1/transaction/material/{metadataVersion}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction/material/{metadataVersion}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/transaction/material/{metadataVersion}')
data = response.json()

200

{}

Generate metadata blob

POST

https://dot-assethub.nownodes.io/v1/transaction/metadata-blob

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

Authorization

api-keyAuthapiKey in header

Generate metadata blob

curl -X POST 'https://dot-assethub.nownodes.io/v1/transaction/metadata-blob' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction/metadata-blob', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/transaction/metadata-blob', json=payload)
data = response.json()

Request Body

{}

200

{}

Parse transaction

POST

https://dot-assethub.nownodes.io/v1/transaction/parse

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

Authorization

api-keyAuthapiKey in header

Parse transaction

curl -X POST 'https://dot-assethub.nownodes.io/v1/transaction/parse' \
  -H 'Content-Type: application/json' \
  -d '{
    "tx": "0x4902840004316d995f..."
  }'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction/parse', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "tx": "0x4902840004316d995f..."
    }),
});

const data = await response.json();

import requests

payload = {
  "tx": "0x4902840004316d995f..."
}

response = requests.post('https://dot-assethub.nownodes.io/v1/transaction/parse', json=payload)
data = response.json()

Request Body

{
  "tx": "0x4902840004316d995f..."
}

{
  "args": {},
  "era": {},
  "hash": "0x1234567890abcdef...",
  "isSigned": true,
  "method": {
    "method": "transferAllowDeath",
    "pallet": "balances"
  },
  "nonce": "42",
  "signature": {
    "signature": "0xa24152685f52e4726466e80247d965bb3d349637fc8a1ea6f7cc1451ddec98b5...",
    "signer": {
      "id": "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"
    }
  },
  "tip": "0"
}

{
  "cause": "string",
  "code": 400,
  "error": "Failed to parse transaction.",
  "stack": "string",
  "transaction": "string"
}

coretime

Coretime system information

Get coretime info

GET

https://dot-assethub.nownodes.io/v1/coretime/info

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

Authorization

api-keyAuthapiKey in header

Get coretime info

curl -X GET 'https://dot-assethub.nownodes.io/v1/coretime/info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/coretime/info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/coretime/info')
data = response.json()

200

{}

Get coretime leases

GET

https://dot-assethub.nownodes.io/v1/coretime/leases

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

Authorization

api-keyAuthapiKey in header

Get coretime leases

curl -X GET 'https://dot-assethub.nownodes.io/v1/coretime/leases'

const response = await fetch('https://dot-assethub.nownodes.io/v1/coretime/leases', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/coretime/leases')
data = response.json()

200

{}

Get coretime overview

GET

https://dot-assethub.nownodes.io/v1/coretime/overview

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

Authorization

api-keyAuthapiKey in header

Get coretime overview

curl -X GET 'https://dot-assethub.nownodes.io/v1/coretime/overview'

const response = await fetch('https://dot-assethub.nownodes.io/v1/coretime/overview', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/coretime/overview')
data = response.json()

200

{}

Get coretime regions

GET

https://dot-assethub.nownodes.io/v1/coretime/regions

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

Authorization

api-keyAuthapiKey in header

Get coretime regions

curl -X GET 'https://dot-assethub.nownodes.io/v1/coretime/regions'

const response = await fetch('https://dot-assethub.nownodes.io/v1/coretime/regions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/coretime/regions')
data = response.json()

200

{}

Get coretime potential renewals

GET

https://dot-assethub.nownodes.io/v1/coretime/renewals

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

Authorization

api-keyAuthapiKey in header

Get coretime potential renewals

curl -X GET 'https://dot-assethub.nownodes.io/v1/coretime/renewals'

const response = await fetch('https://dot-assethub.nownodes.io/v1/coretime/renewals', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/coretime/renewals')
data = response.json()

200

{}

Get coretime reservations

GET

https://dot-assethub.nownodes.io/v1/coretime/reservations

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

Authorization

api-keyAuthapiKey in header

Get coretime reservations

curl -X GET 'https://dot-assethub.nownodes.io/v1/coretime/reservations'

const response = await fetch('https://dot-assethub.nownodes.io/v1/coretime/reservations', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/coretime/reservations')
data = response.json()

200

{}

paras

Parachain inclusion data

GET

https://dot-assethub.nownodes.io/v1/paras/{number}/inclusion

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

Authorization

api-keyAuthapiKey in header

Parachain inclusion data

curl -X GET 'https://dot-assethub.nownodes.io/v1/paras/{number}/inclusion'

const response = await fetch('https://dot-assethub.nownodes.io/v1/paras/{number}/inclusion', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/paras/{number}/inclusion')
data = response.json()

200

{}

ahm

Asset Hub Migration information

Asset Hub Migration info

GET

https://dot-assethub.nownodes.io/v1/ahm-info

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

Authorization

api-keyAuthapiKey in header

Asset Hub Migration info

curl -X GET 'https://dot-assethub.nownodes.io/v1/ahm-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/ahm-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/ahm-info')
data = response.json()

200

{}

capabilities

API capabilities and chain pallets

API capabilities

GET

https://dot-assethub.nownodes.io/v1/capabilities

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

Authorization

api-keyAuthapiKey in header

API capabilities

curl -X GET 'https://dot-assethub.nownodes.io/v1/capabilities'

const response = await fetch('https://dot-assethub.nownodes.io/v1/capabilities', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/capabilities')
data = response.json()

200

{
  "chain": "string",
  "pallets": [
    "string"
  ]
}

rc

Relay chain endpoints (available on parachains only)

RC get balance info

GET

https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/balance-info

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

Authorization

api-keyAuthapiKey in header

RC get balance info

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/balance-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/balance-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/balance-info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "feeFrozen": "string",
  "free": "string",
  "frozen": "string",
  "locks": [
    {
      "amount": "string",
      "id": "string",
      "reasons": "string"
    }
  ],
  "miscFrozen": "string",
  "nonce": "string",
  "reserved": "string",
  "tokenSymbol": "string",
  "transferable": "string"
}

RC get proxy info

GET

https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/proxy-info

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

Authorization

api-keyAuthapiKey in header

RC get proxy info

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/proxy-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/proxy-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/proxy-info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "delegatedAccounts": [
    {
      "delay": "string",
      "delegate": "string",
      "proxyType": "string"
    }
  ],
  "depositHeld": "string"
}

RC get staking info

GET

https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-info

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

Authorization

api-keyAuthapiKey in header

RC get staking info

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "controller": "string",
  "nominations": {
    "submittedIn": "string",
    "suppressed": true,
    "targets": [
      "string"
    ]
  },
  "numSlashingSpans": "string",
  "rewardDestination": {
    "staked": null
  },
  "staking": {
    "active": "string",
    "claimedRewards": [
      {
        "era": "string",
        "status": "string"
      }
    ],
    "stash": "string",
    "total": "string",
    "unlocking": [
      {
        "era": "string",
        "value": "string"
      }
    ]
  }
}

RC get staking payouts

GET

https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-payouts

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

Authorization

api-keyAuthapiKey in header

RC get staking payouts

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-payouts'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-payouts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-payouts')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "erasPayouts": [
    {
      "era": "string",
      "payouts": [
        {
          "claimed": true,
          "nominatorExposure": "string",
          "nominatorStakingPayout": "string",
          "totalValidatorExposure": "string",
          "totalValidatorRewardPoints": "string",
          "validatorCommission": "string",
          "validatorId": "string"
        }
      ],
      "totalEraPayout": "string",
      "totalEraRewardPoints": "string"
    }
  ]
}

RC get vesting info

GET

https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/vesting-info

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

Authorization

api-keyAuthapiKey in header

RC get vesting info

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/vesting-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/vesting-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/vesting-info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "vesting": [
    {
      "locked": "string",
      "perBlock": "string",
      "startingBlock": "string"
    }
  ]
}

RC get blocks by range

GET

https://dot-assethub.nownodes.io/v1/rc/blocks

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

Authorization

api-keyAuthapiKey in header

RC get blocks by range

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks')
data = response.json()

200

{}

RC get head block

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/head

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

Authorization

api-keyAuthapiKey in header

RC get head block

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/head'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/head', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/head')
data = response.json()

200

{}

RC get head block header

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/head/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

Authorization

api-keyAuthapiKey in header

RC get head block header

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/head/header'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/head/header', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/head/header')
data = response.json()

200

{}

RC get block by ID

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}

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

Authorization

api-keyAuthapiKey in header

RC get block by ID

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}')
data = response.json()

200

{}

RC get raw extrinsics

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics-raw

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

Authorization

api-keyAuthapiKey in header

RC get raw extrinsics

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics-raw'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics-raw', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics-raw')
data = response.json()

200

{}

RC get extrinsic by index

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics/{extrinsicIndex}

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

Authorization

api-keyAuthapiKey in header

RC get extrinsic by index

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics/{extrinsicIndex}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics/{extrinsicIndex}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics/{extrinsicIndex}')
data = response.json()

200

{}

RC get block header

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/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

Authorization

api-keyAuthapiKey in header

RC get block header

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/header'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/header', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/header')
data = response.json()

200

{}

RC get parachain inclusions

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/para-inclusions

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

Authorization

api-keyAuthapiKey in header

RC get parachain inclusions

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/para-inclusions'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/para-inclusions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/para-inclusions')
data = response.json()

200

{}

RC get node network

GET

https://dot-assethub.nownodes.io/v1/rc/node/network

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

Authorization

api-keyAuthapiKey in header

RC get node network

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/node/network'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/node/network', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/node/network')
data = response.json()

200

{}

RC get transaction pool

GET

https://dot-assethub.nownodes.io/v1/rc/node/transaction-pool

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

Authorization

api-keyAuthapiKey in header

RC get transaction pool

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/node/transaction-pool'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/node/transaction-pool', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/node/transaction-pool')
data = response.json()

200

{
  "pool": [
    {
      "encodedExtrinsic": "string",
      "hash": "string",
      "partialFee": "string",
      "priority": "string",
      "tip": "string"
    }
  ]
}

RC get node version

GET

https://dot-assethub.nownodes.io/v1/rc/node/version

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

Authorization

api-keyAuthapiKey in header

RC get node version

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/node/version'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/node/version', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/node/version')
data = response.json()

200

{
  "chain": "string",
  "clientImplName": "string",
  "clientVersion": "string"
}

RC on-going referenda

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/on-going-referenda

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

Authorization

api-keyAuthapiKey in header

RC on-going referenda

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/on-going-referenda'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/on-going-referenda', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/on-going-referenda')
data = response.json()

200

{}

RC staking progress

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/staking/progress

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

Authorization

api-keyAuthapiKey in header

RC staking progress

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/staking/progress'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/staking/progress', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/staking/progress')
data = response.json()

200

{}

RC staking validators

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/staking/validators

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

Authorization

api-keyAuthapiKey in header

RC staking validators

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/staking/validators'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/staking/validators', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/staking/validators')
data = response.json()

200

{}

RC pallet constants

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts

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

Authorization

api-keyAuthapiKey in header

RC pallet constants

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts')
data = response.json()

200

{}

RC pallet constant value

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}

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

Authorization

api-keyAuthapiKey in header

RC pallet constant value

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}')
data = response.json()

200

{}

RC pallet dispatchables

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables

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

Authorization

api-keyAuthapiKey in header

RC pallet dispatchables

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables')
data = response.json()

200

{}

RC pallet dispatchable details

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}

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

Authorization

api-keyAuthapiKey in header

RC pallet dispatchable details

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}')
data = response.json()

200

{}

RC pallet errors

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors

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

Authorization

api-keyAuthapiKey in header

RC pallet errors

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors')
data = response.json()

200

{}

RC pallet error details

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}

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

Authorization

api-keyAuthapiKey in header

RC pallet error details

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}')
data = response.json()

200

{}

RC pallet events

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events

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

Authorization

api-keyAuthapiKey in header

RC pallet events

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events')
data = response.json()

200

{}

RC pallet event details

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}

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

Authorization

api-keyAuthapiKey in header

RC pallet event details

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}')
data = response.json()

200

{}

RC pallet storage items

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage

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

Authorization

api-keyAuthapiKey in header

RC pallet storage items

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage')
data = response.json()

200

{}

RC pallet storage item value

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}

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

Authorization

api-keyAuthapiKey in header

RC pallet storage item value

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}')
data = response.json()

200

{}

RC get runtime code

GET

https://dot-assethub.nownodes.io/v1/rc/runtime/code

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

Authorization

api-keyAuthapiKey in header

RC get runtime code

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/runtime/code'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/runtime/code', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/runtime/code')
data = response.json()

200

{}

RC get runtime metadata

GET

https://dot-assethub.nownodes.io/v1/rc/runtime/metadata

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

Authorization

api-keyAuthapiKey in header

RC get runtime metadata

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/runtime/metadata'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/runtime/metadata', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/runtime/metadata')
data = response.json()

200

{}

RC get metadata versions

GET

https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/versions

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

Authorization

api-keyAuthapiKey in header

RC get metadata versions

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/versions'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/versions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/versions')
data = response.json()

200

{}

RC get metadata by version

GET

https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/{version}

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

Authorization

api-keyAuthapiKey in header

RC get metadata by version

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/{version}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/{version}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/{version}')
data = response.json()

200

{}

RC get runtime spec

GET

https://dot-assethub.nownodes.io/v1/rc/runtime/spec

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

Authorization

api-keyAuthapiKey in header

RC get runtime spec

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/runtime/spec'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/runtime/spec', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/runtime/spec')
data = response.json()

200

{}

Submit transaction (relay chain)

POST

https://dot-assethub.nownodes.io/v1/rc/transaction

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

Authorization

api-keyAuthapiKey in header

Submit transaction (relay chain)

curl -X POST 'https://dot-assethub.nownodes.io/v1/rc/transaction' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/rc/transaction', json=payload)
data = response.json()

Request Body

{}

200

{}

RC dry run transaction

POST

https://dot-assethub.nownodes.io/v1/rc/transaction/dry-run

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

Authorization

api-keyAuthapiKey in header

RC dry run transaction

curl -X POST 'https://dot-assethub.nownodes.io/v1/rc/transaction/dry-run' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction/dry-run', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/rc/transaction/dry-run', json=payload)
data = response.json()

Request Body

{}

200

{}

RC fee estimate

POST

https://dot-assethub.nownodes.io/v1/rc/transaction/fee-estimate

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

Authorization

api-keyAuthapiKey in header

RC fee estimate

curl -X POST 'https://dot-assethub.nownodes.io/v1/rc/transaction/fee-estimate' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction/fee-estimate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/rc/transaction/fee-estimate', json=payload)
data = response.json()

Request Body

{}

200

{
  "class": "string",
  "partialFee": "string",
  "weight": {
    "proofSize": "string",
    "refTime": "string"
  }
}

RC transaction material

GET

https://dot-assethub.nownodes.io/v1/rc/transaction/material

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

Authorization

api-keyAuthapiKey in header

RC transaction material

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/transaction/material'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction/material', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/transaction/material')
data = response.json()

200

{}

RC transaction material versioned

GET

https://dot-assethub.nownodes.io/v1/rc/transaction/material/{metadataVersion}

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

Authorization

api-keyAuthapiKey in header

RC transaction material versioned

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/transaction/material/{metadataVersion}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction/material/{metadataVersion}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/transaction/material/{metadataVersion}')
data = response.json()

200

{}

RC metadata blob

POST

https://dot-assethub.nownodes.io/v1/rc/transaction/metadata-blob

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

Authorization

api-keyAuthapiKey in header

RC metadata blob

curl -X POST 'https://dot-assethub.nownodes.io/v1/rc/transaction/metadata-blob' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction/metadata-blob', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/rc/transaction/metadata-blob', json=payload)
data = response.json()

Request Body

{}

200

{}

Parse transaction (relay chain)

POST

https://dot-assethub.nownodes.io/v1/rc/transaction/parse

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

Authorization

api-keyAuthapiKey in header

Parse transaction (relay chain)

curl -X POST 'https://dot-assethub.nownodes.io/v1/rc/transaction/parse' \
  -H 'Content-Type: application/json' \
  -d '{
    "tx": "0x4902840004316d995f..."
  }'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction/parse', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "tx": "0x4902840004316d995f..."
    }),
});

const data = await response.json();

import requests

payload = {
  "tx": "0x4902840004316d995f..."
}

response = requests.post('https://dot-assethub.nownodes.io/v1/rc/transaction/parse', json=payload)
data = response.json()

Request Body

{
  "tx": "0x4902840004316d995f..."
}

{
  "args": {},
  "era": {},
  "hash": "0x1234567890abcdef...",
  "isSigned": true,
  "method": {
    "method": "transferAllowDeath",
    "pallet": "balances"
  },
  "nonce": "42",
  "signature": {
    "signature": "0xa24152685f52e4726466e80247d965bb3d349637fc8a1ea6f7cc1451ddec98b5...",
    "signer": {
      "id": "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"
    }
  },
  "tip": "0"
}

{
  "cause": "string",
  "code": 400,
  "error": "Failed to parse transaction.",
  "stack": "string",
  "transaction": "string"
}

Node / PLAYBOOK

health

Health check

GET

https://dot-assethub.nownodes.io/v1/health

Returns the health status of the API server.

Response

202Accepted

API is healthy

Authorization

api-keyAuthapiKey in header

Health check

curl -X GET 'https://dot-assethub.nownodes.io/v1/health'

const response = await fetch('https://dot-assethub.nownodes.io/v1/health', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/health')
data = response.json()

202

{
  "connected_chains": 0,
  "status": "string",
  "uptime": 0
}

node

Connected node information

Node network info

GET

https://dot-assethub.nownodes.io/v1/node/network

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

Authorization

api-keyAuthapiKey in header

Node network info

curl -X GET 'https://dot-assethub.nownodes.io/v1/node/network'

const response = await fetch('https://dot-assethub.nownodes.io/v1/node/network', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/node/network')
data = response.json()

200

{}

Transaction pool

GET

https://dot-assethub.nownodes.io/v1/node/transaction-pool

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

Authorization

api-keyAuthapiKey in header

Transaction pool

curl -X GET 'https://dot-assethub.nownodes.io/v1/node/transaction-pool'

const response = await fetch('https://dot-assethub.nownodes.io/v1/node/transaction-pool', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/node/transaction-pool')
data = response.json()

200

{
  "pool": [
    {
      "encodedExtrinsic": "string",
      "hash": "string",
      "partialFee": "string",
      "priority": "string",
      "tip": "string"
    }
  ]
}

Node version

GET

https://dot-assethub.nownodes.io/v1/node/version

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

Authorization

api-keyAuthapiKey in header

Node version

curl -X GET 'https://dot-assethub.nownodes.io/v1/node/version'

const response = await fetch('https://dot-assethub.nownodes.io/v1/node/version', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/node/version')
data = response.json()

200

{
  "chain": "string",
  "clientImplName": "string",
  "clientVersion": "string"
}

version

API version

GET

https://dot-assethub.nownodes.io/v1/version

Returns the current version of the Polkadot REST API.

Response

200OK

API version

Authorization

api-keyAuthapiKey in header

API version

curl -X GET 'https://dot-assethub.nownodes.io/v1/version'

const response = await fetch('https://dot-assethub.nownodes.io/v1/version', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/version')
data = response.json()

200

{
  "version": "string"
}

blocks

Block queries and extrinsic data

Get blocks by range

GET

https://dot-assethub.nownodes.io/v1/blocks

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

Authorization

api-keyAuthapiKey in header

Get blocks by range

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks')
data = response.json()

200

[
  {}
]

Get latest block

GET

https://dot-assethub.nownodes.io/v1/blocks/head

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

Authorization

api-keyAuthapiKey in header

Get latest block

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/head'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/head', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/head')
data = response.json()

200

{}

Get head block header

GET

https://dot-assethub.nownodes.io/v1/blocks/head/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

Authorization

api-keyAuthapiKey in header

Get head block header

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/head/header'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/head/header', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/head/header')
data = response.json()

200

{}

Get block by ID

GET

https://dot-assethub.nownodes.io/v1/blocks/{blockId}

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

Authorization

api-keyAuthapiKey in header

Get block by ID

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/{blockId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/{blockId}')
data = response.json()

200

{}

Get raw extrinsics

GET

https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics-raw

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

Authorization

api-keyAuthapiKey in header

Get raw extrinsics

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics-raw'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics-raw', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics-raw')
data = response.json()

200

{}

Get extrinsic by index

GET

https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics/{extrinsicIndex}

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

Authorization

api-keyAuthapiKey in header

Get extrinsic by index

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics/{extrinsicIndex}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics/{extrinsicIndex}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/extrinsics/{extrinsicIndex}')
data = response.json()

200

{}

Get block header by ID

GET

https://dot-assethub.nownodes.io/v1/blocks/{blockId}/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

Authorization

api-keyAuthapiKey in header

Get block header by ID

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/{blockId}/header'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/header', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/header')
data = response.json()

200

{}

Get parachain inclusions

GET

https://dot-assethub.nownodes.io/v1/blocks/{blockId}/para-inclusions

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

Authorization

api-keyAuthapiKey in header

Get parachain inclusions

curl -X GET 'https://dot-assethub.nownodes.io/v1/blocks/{blockId}/para-inclusions'

const response = await fetch('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/para-inclusions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/blocks/{blockId}/para-inclusions')
data = response.json()

200

{}

accounts

Account balance, staking, and proxy information

Compare account addresses

GET

https://dot-assethub.nownodes.io/v1/accounts/compare

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

Authorization

api-keyAuthapiKey in header

Compare account addresses

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/compare'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/compare', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/compare')
data = response.json()

200

{
  "addresses": [
    {
      "network": "string",
      "publicKey": "string",
      "ss58Format": "string",
      "ss58Prefix": 0
    }
  ],
  "areEqual": true
}

Account asset approvals

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-approvals

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

Authorization

api-keyAuthapiKey in header

Account asset approvals

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-approvals'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-approvals', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-approvals')
data = response.json()

200

{
  "ahTimestamp": "string",
  "amount": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "deposit": "string",
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}

Account asset balances

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-balances

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

Authorization

api-keyAuthapiKey in header

Account asset balances

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-balances'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-balances', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/asset-balances')
data = response.json()

200

{
  "ahTimestamp": "string",
  "assets": [
    {
      "assetId": "string",
      "balance": "string",
      "isFrozen": true,
      "isSufficient": true
    }
  ],
  "at": {
    "hash": "string",
    "height": "string"
  },
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}

Account balance info

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/balance-info

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

Authorization

api-keyAuthapiKey in header

Account balance info

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/balance-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/balance-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/balance-info')
data = response.json()

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "feeFrozen": "string",
  "free": "string",
  "frozen": "string",
  "locks": [
    {
      "amount": "string",
      "id": "string",
      "reasons": "string"
    }
  ],
  "miscFrozen": "string",
  "nonce": "string",
  "rcBlockHash": "string",
  "rcBlockNumber": "string",
  "reserved": "string",
  "tokenSymbol": "string",
  "transferable": "string"
}

Convert account format

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/convert

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

Authorization

api-keyAuthapiKey in header

Convert account format

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/convert'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/convert', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/convert')
data = response.json()

200

{
  "accountId": "string",
  "address": "string",
  "network": "string",
  "publicKey": true,
  "scheme": "string",
  "ss58Prefix": 0
}

Account foreign asset balances

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/foreign-asset-balances

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

Authorization

api-keyAuthapiKey in header

Account foreign asset balances

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/foreign-asset-balances'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/foreign-asset-balances', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/foreign-asset-balances')
data = response.json()

200

{}

Account pool asset approvals

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-approvals

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

Authorization

api-keyAuthapiKey in header

Account pool asset approvals

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-approvals'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-approvals', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-approvals')
data = response.json()

200

{
  "ahTimestamp": "string",
  "amount": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "deposit": "string",
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}

Account pool asset balances

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-balances

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

Authorization

api-keyAuthapiKey in header

Account pool asset balances

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-balances'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-balances', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-balances')
data = response.json()

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "poolAssets": [
    {
      "assetId": "string",
      "balance": "string",
      "isFrozen": true,
      "isSufficient": true
    }
  ],
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}

Account proxy info

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/proxy-info

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

Authorization

api-keyAuthapiKey in header

Account proxy info

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/proxy-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/proxy-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/proxy-info')
data = response.json()

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "delegatedAccounts": [
    {
      "delay": "string",
      "delegate": "string",
      "proxyType": "string"
    }
  ],
  "depositHeld": "string",
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}

Account staking info

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-info

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

Authorization

api-keyAuthapiKey in header

Account staking info

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-info')
data = response.json()

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "controller": "string",
  "nominations": {
    "submittedIn": "string",
    "suppressed": true,
    "targets": [
      "string"
    ]
  },
  "numSlashingSpans": "string",
  "rcBlockHash": "string",
  "rcBlockNumber": "string",
  "rewardDestination": {
    "staked": null
  },
  "staking": {
    "active": "string",
    "claimedRewards": [
      {
        "era": "string",
        "status": "string"
      }
    ],
    "stash": "string",
    "total": "string",
    "unlocking": [
      {
        "era": "string",
        "value": "string"
      }
    ]
  }
}

Account staking payouts

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-payouts

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

Authorization

api-keyAuthapiKey in header

Account staking payouts

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-payouts'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-payouts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/staking-payouts')
data = response.json()

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "erasPayouts": [
    {
      "era": "string",
      "payouts": [
        {
          "claimed": true,
          "nominatorExposure": "string",
          "nominatorStakingPayout": "string",
          "totalValidatorExposure": "string",
          "totalValidatorRewardPoints": "string",
          "validatorCommission": "string",
          "validatorId": "string"
        }
      ],
      "totalEraPayout": "string",
      "totalEraRewardPoints": "string"
    }
  ],
  "rcBlockHash": "string",
  "rcBlockNumber": "string"
}

Validate account address

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/validate

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

Authorization

api-keyAuthapiKey in header

Validate account address

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/validate'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/validate', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/validate')
data = response.json()

200

{
  "accountId": "string",
  "isValid": true,
  "network": "string",
  "ss58Prefix": "string"
}

Account vesting info

GET

https://dot-assethub.nownodes.io/v1/accounts/{accountId}/vesting-info

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

Authorization

api-keyAuthapiKey in header

Account vesting info

curl -X GET 'https://dot-assethub.nownodes.io/v1/accounts/{accountId}/vesting-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/vesting-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/accounts/{accountId}/vesting-info')
data = response.json()

200

{
  "ahTimestamp": "string",
  "at": {
    "hash": "string",
    "height": "string"
  },
  "rcBlockHash": "string",
  "rcBlockNumber": "string",
  "vesting": [
    {
      "locked": "string",
      "perBlock": "string",
      "startingBlock": "string"
    }
  ]
}

pallets

Runtime pallet metadata, storage, constants, events, errors

Liquidity pools

GET

https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/liquidity-pools

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

Authorization

api-keyAuthapiKey in header

Liquidity pools

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/liquidity-pools'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/liquidity-pools', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/liquidity-pools')
data = response.json()

200

{}

Next available pool ID

GET

https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/next-available-id

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

Authorization

api-keyAuthapiKey in header

Next available pool ID

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/next-available-id'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/next-available-id', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/asset-conversion/next-available-id')
data = response.json()

200

{}

Asset info

GET

https://dot-assethub.nownodes.io/v1/pallets/assets/{assetId}/asset-info

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

Authorization

api-keyAuthapiKey in header

Asset info

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/assets/{assetId}/asset-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/assets/{assetId}/asset-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/assets/{assetId}/asset-info')
data = response.json()

200

{}

Foreign assets

GET

https://dot-assethub.nownodes.io/v1/pallets/foreign-assets

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

Authorization

api-keyAuthapiKey in header

Foreign assets

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/foreign-assets'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/foreign-assets', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/foreign-assets')
data = response.json()

200

{}

Nomination pools info

GET

https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/info

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

Authorization

api-keyAuthapiKey in header

Nomination pools info

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/info')
data = response.json()

200

{}

Nomination pool details

GET

https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/{poolId}

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

Authorization

api-keyAuthapiKey in header

Nomination pool details

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/{poolId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/{poolId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/nomination-pools/{poolId}')
data = response.json()

200

{}

On-going referenda

GET

https://dot-assethub.nownodes.io/v1/pallets/on-going-referenda

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

Authorization

api-keyAuthapiKey in header

On-going referenda

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/on-going-referenda'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/on-going-referenda', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/on-going-referenda')
data = response.json()

200

{}

Pool asset info

GET

https://dot-assethub.nownodes.io/v1/pallets/pool-assets/{assetId}/asset-info

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

Authorization

api-keyAuthapiKey in header

Pool asset info

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/pool-assets/{assetId}/asset-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/pool-assets/{assetId}/asset-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/pool-assets/{assetId}/asset-info')
data = response.json()

200

{}

Staking progress

GET

https://dot-assethub.nownodes.io/v1/pallets/staking/progress

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

Authorization

api-keyAuthapiKey in header

Staking progress

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/staking/progress'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/staking/progress', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/staking/progress')
data = response.json()

200

{}

Staking validators

GET

https://dot-assethub.nownodes.io/v1/pallets/staking/validators

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

Authorization

api-keyAuthapiKey in header

Staking validators

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/staking/validators'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/staking/validators', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/staking/validators')
data = response.json()

200

{}

Pallet constants

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts

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

Authorization

api-keyAuthapiKey in header

Pallet constants

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts')
data = response.json()

200

{}

Pallet constant value

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts/{constantItemId}

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

Authorization

api-keyAuthapiKey in header

Pallet constant value

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts/{constantItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts/{constantItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/consts/{constantItemId}')
data = response.json()

200

{}

Pallet dispatchables

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables

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

Authorization

api-keyAuthapiKey in header

Pallet dispatchables

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables')
data = response.json()

200

{}

Pallet dispatchable details

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables/{dispatchableId}

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

Authorization

api-keyAuthapiKey in header

Pallet dispatchable details

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables/{dispatchableId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables/{dispatchableId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables/{dispatchableId}')
data = response.json()

200

{}

Pallet errors

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors

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

Authorization

api-keyAuthapiKey in header

Pallet errors

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors')
data = response.json()

200

{}

Pallet error details

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors/{errorItemId}

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

Authorization

api-keyAuthapiKey in header

Pallet error details

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors/{errorItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors/{errorItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/errors/{errorItemId}')
data = response.json()

200

{}

Get pallet events

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events

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

Authorization

api-keyAuthapiKey in header

Get pallet events

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events')
data = response.json()

200

{}

Get pallet event item

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events/{eventItemId}

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

Authorization

api-keyAuthapiKey in header

Get pallet event item

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events/{eventItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events/{eventItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/events/{eventItemId}')
data = response.json()

200

{}

Pallet storage items

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage

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

Authorization

api-keyAuthapiKey in header

Pallet storage items

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage')
data = response.json()

200

{}

Pallet storage item value

GET

https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage/{storageItemId}

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

Authorization

api-keyAuthapiKey in header

Pallet storage item value

curl -X GET 'https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage/{storageItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage/{storageItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/pallets/{palletId}/storage/{storageItemId}')
data = response.json()

200

{}

runtime

Runtime specification, metadata, and code

Runtime Wasm code

GET

https://dot-assethub.nownodes.io/v1/runtime/code

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

Authorization

api-keyAuthapiKey in header

Runtime Wasm code

curl -X GET 'https://dot-assethub.nownodes.io/v1/runtime/code'

const response = await fetch('https://dot-assethub.nownodes.io/v1/runtime/code', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/runtime/code')
data = response.json()

200

{}

Runtime metadata

GET

https://dot-assethub.nownodes.io/v1/runtime/metadata

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

Authorization

api-keyAuthapiKey in header

Runtime metadata

curl -X GET 'https://dot-assethub.nownodes.io/v1/runtime/metadata'

const response = await fetch('https://dot-assethub.nownodes.io/v1/runtime/metadata', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/runtime/metadata')
data = response.json()

200

{}

Available metadata versions

GET

https://dot-assethub.nownodes.io/v1/runtime/metadata/versions

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

Authorization

api-keyAuthapiKey in header

Available metadata versions

curl -X GET 'https://dot-assethub.nownodes.io/v1/runtime/metadata/versions'

const response = await fetch('https://dot-assethub.nownodes.io/v1/runtime/metadata/versions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/runtime/metadata/versions')
data = response.json()

200

[
  "string"
]

Runtime metadata by version

GET

https://dot-assethub.nownodes.io/v1/runtime/metadata/{version}

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

Authorization

api-keyAuthapiKey in header

Runtime metadata by version

curl -X GET 'https://dot-assethub.nownodes.io/v1/runtime/metadata/{version}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/runtime/metadata/{version}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/runtime/metadata/{version}')
data = response.json()

200

{}

Runtime specification

GET

https://dot-assethub.nownodes.io/v1/runtime/spec

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

Authorization

api-keyAuthapiKey in header

Runtime specification

curl -X GET 'https://dot-assethub.nownodes.io/v1/runtime/spec'

const response = await fetch('https://dot-assethub.nownodes.io/v1/runtime/spec', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/runtime/spec')
data = response.json()

200

{}

transaction

Transaction submission, fee estimation, and construction material

Submit transaction

POST

https://dot-assethub.nownodes.io/v1/transaction

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

Authorization

api-keyAuthapiKey in header

Submit transaction

curl -X POST 'https://dot-assethub.nownodes.io/v1/transaction' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/transaction', json=payload)
data = response.json()

Request Body

{}

200

{}

Dry run transaction

POST

https://dot-assethub.nownodes.io/v1/transaction/dry-run

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

Authorization

api-keyAuthapiKey in header

Dry run transaction

curl -X POST 'https://dot-assethub.nownodes.io/v1/transaction/dry-run' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction/dry-run', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/transaction/dry-run', json=payload)
data = response.json()

Request Body

{}

200

{}

Estimate transaction fee

POST

https://dot-assethub.nownodes.io/v1/transaction/fee-estimate

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

Authorization

api-keyAuthapiKey in header

Estimate transaction fee

curl -X POST 'https://dot-assethub.nownodes.io/v1/transaction/fee-estimate' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction/fee-estimate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/transaction/fee-estimate', json=payload)
data = response.json()

Request Body

{}

200

{
  "class": "string",
  "partialFee": "string",
  "weight": {
    "proofSize": "string",
    "refTime": "string"
  }
}

Transaction construction material

GET

https://dot-assethub.nownodes.io/v1/transaction/material

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

Authorization

api-keyAuthapiKey in header

Transaction construction material

curl -X GET 'https://dot-assethub.nownodes.io/v1/transaction/material'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction/material', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/transaction/material')
data = response.json()

200

{}

Transaction material with versioned metadata

GET

https://dot-assethub.nownodes.io/v1/transaction/material/{metadataVersion}

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

Authorization

api-keyAuthapiKey in header

Transaction material with versioned metadata

curl -X GET 'https://dot-assethub.nownodes.io/v1/transaction/material/{metadataVersion}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction/material/{metadataVersion}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/transaction/material/{metadataVersion}')
data = response.json()

200

{}

Generate metadata blob

POST

https://dot-assethub.nownodes.io/v1/transaction/metadata-blob

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

Authorization

api-keyAuthapiKey in header

Generate metadata blob

curl -X POST 'https://dot-assethub.nownodes.io/v1/transaction/metadata-blob' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction/metadata-blob', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/transaction/metadata-blob', json=payload)
data = response.json()

Request Body

{}

200

{}

Parse transaction

POST

https://dot-assethub.nownodes.io/v1/transaction/parse

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

Authorization

api-keyAuthapiKey in header

Parse transaction

curl -X POST 'https://dot-assethub.nownodes.io/v1/transaction/parse' \
  -H 'Content-Type: application/json' \
  -d '{
    "tx": "0x4902840004316d995f..."
  }'

const response = await fetch('https://dot-assethub.nownodes.io/v1/transaction/parse', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "tx": "0x4902840004316d995f..."
    }),
});

const data = await response.json();

import requests

payload = {
  "tx": "0x4902840004316d995f..."
}

response = requests.post('https://dot-assethub.nownodes.io/v1/transaction/parse', json=payload)
data = response.json()

Request Body

{
  "tx": "0x4902840004316d995f..."
}

{
  "args": {},
  "era": {},
  "hash": "0x1234567890abcdef...",
  "isSigned": true,
  "method": {
    "method": "transferAllowDeath",
    "pallet": "balances"
  },
  "nonce": "42",
  "signature": {
    "signature": "0xa24152685f52e4726466e80247d965bb3d349637fc8a1ea6f7cc1451ddec98b5...",
    "signer": {
      "id": "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"
    }
  },
  "tip": "0"
}

{
  "cause": "string",
  "code": 400,
  "error": "Failed to parse transaction.",
  "stack": "string",
  "transaction": "string"
}

coretime

Coretime system information

Get coretime info

GET

https://dot-assethub.nownodes.io/v1/coretime/info

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

Authorization

api-keyAuthapiKey in header

Get coretime info

curl -X GET 'https://dot-assethub.nownodes.io/v1/coretime/info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/coretime/info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/coretime/info')
data = response.json()

200

{}

Get coretime leases

GET

https://dot-assethub.nownodes.io/v1/coretime/leases

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

Authorization

api-keyAuthapiKey in header

Get coretime leases

curl -X GET 'https://dot-assethub.nownodes.io/v1/coretime/leases'

const response = await fetch('https://dot-assethub.nownodes.io/v1/coretime/leases', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/coretime/leases')
data = response.json()

200

{}

Get coretime overview

GET

https://dot-assethub.nownodes.io/v1/coretime/overview

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

Authorization

api-keyAuthapiKey in header

Get coretime overview

curl -X GET 'https://dot-assethub.nownodes.io/v1/coretime/overview'

const response = await fetch('https://dot-assethub.nownodes.io/v1/coretime/overview', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/coretime/overview')
data = response.json()

200

{}

Get coretime regions

GET

https://dot-assethub.nownodes.io/v1/coretime/regions

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

Authorization

api-keyAuthapiKey in header

Get coretime regions

curl -X GET 'https://dot-assethub.nownodes.io/v1/coretime/regions'

const response = await fetch('https://dot-assethub.nownodes.io/v1/coretime/regions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/coretime/regions')
data = response.json()

200

{}

Get coretime potential renewals

GET

https://dot-assethub.nownodes.io/v1/coretime/renewals

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

Authorization

api-keyAuthapiKey in header

Get coretime potential renewals

curl -X GET 'https://dot-assethub.nownodes.io/v1/coretime/renewals'

const response = await fetch('https://dot-assethub.nownodes.io/v1/coretime/renewals', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/coretime/renewals')
data = response.json()

200

{}

Get coretime reservations

GET

https://dot-assethub.nownodes.io/v1/coretime/reservations

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

Authorization

api-keyAuthapiKey in header

Get coretime reservations

curl -X GET 'https://dot-assethub.nownodes.io/v1/coretime/reservations'

const response = await fetch('https://dot-assethub.nownodes.io/v1/coretime/reservations', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/coretime/reservations')
data = response.json()

200

{}

paras

Parachain inclusion data

GET

https://dot-assethub.nownodes.io/v1/paras/{number}/inclusion

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

Authorization

api-keyAuthapiKey in header

Parachain inclusion data

curl -X GET 'https://dot-assethub.nownodes.io/v1/paras/{number}/inclusion'

const response = await fetch('https://dot-assethub.nownodes.io/v1/paras/{number}/inclusion', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/paras/{number}/inclusion')
data = response.json()

200

{}

ahm

Asset Hub Migration information

Asset Hub Migration info

GET

https://dot-assethub.nownodes.io/v1/ahm-info

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

Authorization

api-keyAuthapiKey in header

Asset Hub Migration info

curl -X GET 'https://dot-assethub.nownodes.io/v1/ahm-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/ahm-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/ahm-info')
data = response.json()

200

{}

capabilities

API capabilities and chain pallets

API capabilities

GET

https://dot-assethub.nownodes.io/v1/capabilities

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

Authorization

api-keyAuthapiKey in header

API capabilities

curl -X GET 'https://dot-assethub.nownodes.io/v1/capabilities'

const response = await fetch('https://dot-assethub.nownodes.io/v1/capabilities', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/capabilities')
data = response.json()

200

{
  "chain": "string",
  "pallets": [
    "string"
  ]
}

rc

Relay chain endpoints (available on parachains only)

RC get balance info

GET

https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/balance-info

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

Authorization

api-keyAuthapiKey in header

RC get balance info

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/balance-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/balance-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/balance-info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "feeFrozen": "string",
  "free": "string",
  "frozen": "string",
  "locks": [
    {
      "amount": "string",
      "id": "string",
      "reasons": "string"
    }
  ],
  "miscFrozen": "string",
  "nonce": "string",
  "reserved": "string",
  "tokenSymbol": "string",
  "transferable": "string"
}

RC get proxy info

GET

https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/proxy-info

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

Authorization

api-keyAuthapiKey in header

RC get proxy info

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/proxy-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/proxy-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/proxy-info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "delegatedAccounts": [
    {
      "delay": "string",
      "delegate": "string",
      "proxyType": "string"
    }
  ],
  "depositHeld": "string"
}

RC get staking info

GET

https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-info

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

Authorization

api-keyAuthapiKey in header

RC get staking info

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "controller": "string",
  "nominations": {
    "submittedIn": "string",
    "suppressed": true,
    "targets": [
      "string"
    ]
  },
  "numSlashingSpans": "string",
  "rewardDestination": {
    "staked": null
  },
  "staking": {
    "active": "string",
    "claimedRewards": [
      {
        "era": "string",
        "status": "string"
      }
    ],
    "stash": "string",
    "total": "string",
    "unlocking": [
      {
        "era": "string",
        "value": "string"
      }
    ]
  }
}

RC get staking payouts

GET

https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-payouts

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

Authorization

api-keyAuthapiKey in header

RC get staking payouts

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-payouts'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-payouts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-payouts')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "erasPayouts": [
    {
      "era": "string",
      "payouts": [
        {
          "claimed": true,
          "nominatorExposure": "string",
          "nominatorStakingPayout": "string",
          "totalValidatorExposure": "string",
          "totalValidatorRewardPoints": "string",
          "validatorCommission": "string",
          "validatorId": "string"
        }
      ],
      "totalEraPayout": "string",
      "totalEraRewardPoints": "string"
    }
  ]
}

RC get vesting info

GET

https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/vesting-info

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

Authorization

api-keyAuthapiKey in header

RC get vesting info

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/vesting-info'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/vesting-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/accounts/{accountId}/vesting-info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "vesting": [
    {
      "locked": "string",
      "perBlock": "string",
      "startingBlock": "string"
    }
  ]
}

RC get blocks by range

GET

https://dot-assethub.nownodes.io/v1/rc/blocks

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

Authorization

api-keyAuthapiKey in header

RC get blocks by range

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks')
data = response.json()

200

{}

RC get head block

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/head

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

Authorization

api-keyAuthapiKey in header

RC get head block

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/head'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/head', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/head')
data = response.json()

200

{}

RC get head block header

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/head/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

Authorization

api-keyAuthapiKey in header

RC get head block header

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/head/header'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/head/header', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/head/header')
data = response.json()

200

{}

RC get block by ID

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}

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

Authorization

api-keyAuthapiKey in header

RC get block by ID

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}')
data = response.json()

200

{}

RC get raw extrinsics

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics-raw

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

Authorization

api-keyAuthapiKey in header

RC get raw extrinsics

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics-raw'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics-raw', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics-raw')
data = response.json()

200

{}

RC get extrinsic by index

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics/{extrinsicIndex}

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

Authorization

api-keyAuthapiKey in header

RC get extrinsic by index

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics/{extrinsicIndex}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics/{extrinsicIndex}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics/{extrinsicIndex}')
data = response.json()

200

{}

RC get block header

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/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

Authorization

api-keyAuthapiKey in header

RC get block header

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/header'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/header', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/header')
data = response.json()

200

{}

RC get parachain inclusions

GET

https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/para-inclusions

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

Authorization

api-keyAuthapiKey in header

RC get parachain inclusions

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/para-inclusions'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/para-inclusions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/blocks/{blockId}/para-inclusions')
data = response.json()

200

{}

RC get node network

GET

https://dot-assethub.nownodes.io/v1/rc/node/network

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

Authorization

api-keyAuthapiKey in header

RC get node network

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/node/network'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/node/network', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/node/network')
data = response.json()

200

{}

RC get transaction pool

GET

https://dot-assethub.nownodes.io/v1/rc/node/transaction-pool

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

Authorization

api-keyAuthapiKey in header

RC get transaction pool

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/node/transaction-pool'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/node/transaction-pool', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/node/transaction-pool')
data = response.json()

200

{
  "pool": [
    {
      "encodedExtrinsic": "string",
      "hash": "string",
      "partialFee": "string",
      "priority": "string",
      "tip": "string"
    }
  ]
}

RC get node version

GET

https://dot-assethub.nownodes.io/v1/rc/node/version

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

Authorization

api-keyAuthapiKey in header

RC get node version

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/node/version'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/node/version', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/node/version')
data = response.json()

200

{
  "chain": "string",
  "clientImplName": "string",
  "clientVersion": "string"
}

RC on-going referenda

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/on-going-referenda

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

Authorization

api-keyAuthapiKey in header

RC on-going referenda

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/on-going-referenda'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/on-going-referenda', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/on-going-referenda')
data = response.json()

200

{}

RC staking progress

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/staking/progress

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

Authorization

api-keyAuthapiKey in header

RC staking progress

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/staking/progress'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/staking/progress', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/staking/progress')
data = response.json()

200

{}

RC staking validators

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/staking/validators

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

Authorization

api-keyAuthapiKey in header

RC staking validators

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/staking/validators'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/staking/validators', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/staking/validators')
data = response.json()

200

{}

RC pallet constants

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts

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

Authorization

api-keyAuthapiKey in header

RC pallet constants

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts')
data = response.json()

200

{}

RC pallet constant value

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}

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

Authorization

api-keyAuthapiKey in header

RC pallet constant value

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}')
data = response.json()

200

{}

RC pallet dispatchables

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables

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

Authorization

api-keyAuthapiKey in header

RC pallet dispatchables

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables')
data = response.json()

200

{}

RC pallet dispatchable details

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}

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

Authorization

api-keyAuthapiKey in header

RC pallet dispatchable details

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}')
data = response.json()

200

{}

RC pallet errors

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors

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

Authorization

api-keyAuthapiKey in header

RC pallet errors

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors')
data = response.json()

200

{}

RC pallet error details

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}

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

Authorization

api-keyAuthapiKey in header

RC pallet error details

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}')
data = response.json()

200

{}

RC pallet events

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events

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

Authorization

api-keyAuthapiKey in header

RC pallet events

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events')
data = response.json()

200

{}

RC pallet event details

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}

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

Authorization

api-keyAuthapiKey in header

RC pallet event details

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}')
data = response.json()

200

{}

RC pallet storage items

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage

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

Authorization

api-keyAuthapiKey in header

RC pallet storage items

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage')
data = response.json()

200

{}

RC pallet storage item value

GET

https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}

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

Authorization

api-keyAuthapiKey in header

RC pallet storage item value

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}')
data = response.json()

200

{}

RC get runtime code

GET

https://dot-assethub.nownodes.io/v1/rc/runtime/code

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

Authorization

api-keyAuthapiKey in header

RC get runtime code

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/runtime/code'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/runtime/code', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/runtime/code')
data = response.json()

200

{}

RC get runtime metadata

GET

https://dot-assethub.nownodes.io/v1/rc/runtime/metadata

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

Authorization

api-keyAuthapiKey in header

RC get runtime metadata

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/runtime/metadata'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/runtime/metadata', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/runtime/metadata')
data = response.json()

200

{}

RC get metadata versions

GET

https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/versions

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

Authorization

api-keyAuthapiKey in header

RC get metadata versions

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/versions'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/versions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/versions')
data = response.json()

200

{}

RC get metadata by version

GET

https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/{version}

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

Authorization

api-keyAuthapiKey in header

RC get metadata by version

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/{version}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/{version}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/runtime/metadata/{version}')
data = response.json()

200

{}

RC get runtime spec

GET

https://dot-assethub.nownodes.io/v1/rc/runtime/spec

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

Authorization

api-keyAuthapiKey in header

RC get runtime spec

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/runtime/spec'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/runtime/spec', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/runtime/spec')
data = response.json()

200

{}

Submit transaction (relay chain)

POST

https://dot-assethub.nownodes.io/v1/rc/transaction

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

Authorization

api-keyAuthapiKey in header

Submit transaction (relay chain)

curl -X POST 'https://dot-assethub.nownodes.io/v1/rc/transaction' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/rc/transaction', json=payload)
data = response.json()

Request Body

{}

200

{}

RC dry run transaction

POST

https://dot-assethub.nownodes.io/v1/rc/transaction/dry-run

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

Authorization

api-keyAuthapiKey in header

RC dry run transaction

curl -X POST 'https://dot-assethub.nownodes.io/v1/rc/transaction/dry-run' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction/dry-run', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/rc/transaction/dry-run', json=payload)
data = response.json()

Request Body

{}

200

{}

RC fee estimate

POST

https://dot-assethub.nownodes.io/v1/rc/transaction/fee-estimate

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

Authorization

api-keyAuthapiKey in header

RC fee estimate

curl -X POST 'https://dot-assethub.nownodes.io/v1/rc/transaction/fee-estimate' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction/fee-estimate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/rc/transaction/fee-estimate', json=payload)
data = response.json()

Request Body

{}

200

{
  "class": "string",
  "partialFee": "string",
  "weight": {
    "proofSize": "string",
    "refTime": "string"
  }
}

RC transaction material

GET

https://dot-assethub.nownodes.io/v1/rc/transaction/material

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

Authorization

api-keyAuthapiKey in header

RC transaction material

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/transaction/material'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction/material', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/transaction/material')
data = response.json()

200

{}

RC transaction material versioned

GET

https://dot-assethub.nownodes.io/v1/rc/transaction/material/{metadataVersion}

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

Authorization

api-keyAuthapiKey in header

RC transaction material versioned

curl -X GET 'https://dot-assethub.nownodes.io/v1/rc/transaction/material/{metadataVersion}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction/material/{metadataVersion}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://dot-assethub.nownodes.io/v1/rc/transaction/material/{metadataVersion}')
data = response.json()

200

{}

RC metadata blob

POST

https://dot-assethub.nownodes.io/v1/rc/transaction/metadata-blob

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

Authorization

api-keyAuthapiKey in header

RC metadata blob

curl -X POST 'https://dot-assethub.nownodes.io/v1/rc/transaction/metadata-blob' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction/metadata-blob', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://dot-assethub.nownodes.io/v1/rc/transaction/metadata-blob', json=payload)
data = response.json()

Request Body

{}

200

{}

Parse transaction (relay chain)

POST

https://dot-assethub.nownodes.io/v1/rc/transaction/parse

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

Authorization

api-keyAuthapiKey in header

Parse transaction (relay chain)

curl -X POST 'https://dot-assethub.nownodes.io/v1/rc/transaction/parse' \
  -H 'Content-Type: application/json' \
  -d '{
    "tx": "0x4902840004316d995f..."
  }'

const response = await fetch('https://dot-assethub.nownodes.io/v1/rc/transaction/parse', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "tx": "0x4902840004316d995f..."
    }),
});

const data = await response.json();

import requests

payload = {
  "tx": "0x4902840004316d995f..."
}

response = requests.post('https://dot-assethub.nownodes.io/v1/rc/transaction/parse', json=payload)
data = response.json()

Request Body

{
  "tx": "0x4902840004316d995f..."
}

{
  "args": {},
  "era": {},
  "hash": "0x1234567890abcdef...",
  "isSigned": true,
  "method": {
    "method": "transferAllowDeath",
    "pallet": "balances"
  },
  "nonce": "42",
  "signature": {
    "signature": "0xa24152685f52e4726466e80247d965bb3d349637fc8a1ea6f7cc1451ddec98b5...",
    "signer": {
      "id": "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"
    }
  },
  "tip": "0"
}

{
  "cause": "string",
  "code": 400,
  "error": "Failed to parse transaction.",
  "stack": "string",
  "transaction": "string"
}

Documentation

Authentication

Asset Hub / JSON-RPC

author_pendingExtrinsics

Body

Response

Authorization

author_submitAndWatchExtrinsic

Body

Response

Authorization

author_submitExtrinsic

Body

Response

Authorization

chain_getBlockHash

Body

Response

Authorization

chain_getBlock

Body

Response

Authorization

chain_getFinalizedHead

Body

Response

Authorization

chain_getHeader

Body

Response

Authorization

payment_queryInfo

Body

Response

Authorization

state_getMetadata

Body

Response

Authorization

state_getReadProof

Body

Response

Authorization

state_getRuntimeVersion

Body

Response

Authorization

state_getStorageHash

Body

Response

Authorization

state_getStorageSize

Body

Response

Authorization

state_getStorage

Body

Response

Authorization

state_queryStorageAt

Body

Response

Authorization

state_queryStorage

Body

Response

Authorization

system_chain

Body

Response

Authorization

system_properties

Body

Response

Authorization

Node / JSON-RPC

author_pendingExtrinsics

Body

Response

Authorization