Kusama RPC API - Author Methods

v1.0.0

Base URLs

https://ksm-assethub.nownodes.ioKusama RPC

https://ksmassethub-playbook.nownodes.io

https://ksm.nownodes.ioKusama RPC

https://ksm-playbook.nownodes.io

API for interacting with Kusama via JSON-RPC. Contains author category methods for submitting and monitoring extrinsics.

Authentication

api-keyAuthapiKey

API Key: API_key in header

ASSETHUB

author

Submit a fully formatted extrinsic

POST

https://ksm-assethub.nownodes.io/author_submitExtrinsic

Sends a fully formatted extrinsic to the chain for processing.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing the encoded extrinsic

Response

200OK

Extrinsic submission result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Submit a fully formatted extrinsic

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_submitExtrinsic",
  "params": [
    "0x...extrinsic"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_submitExtrinsic",
  "params": [
    "0x...extrinsic"
  ]
}

200

{
  "jsonrpc": "2.0",
  "error": {
    "code": 1002,
    "message": "Verification Error: invalid signature"
  },
  "id": "test"
}

Submit and subscribe to an extrinsic until unsubscribed

POST

https://ksm-assethub.nownodes.io/author_submitAndWatchExtrinsic

Submits an extrinsic and allows monitoring its status until it is finalized or unsubscribed.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing the encoded extrinsic

Response

200OK

Extrinsic submission and watch result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Submit and subscribe to an extrinsic until unsubscribed

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_submitAndWatchExtrinsic",
  "params": [
    "0x290284ffdc3488a..."
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_submitAndWatchExtrinsic",
  "params": [
    "0x290284ffdc3488a..."
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "extrinsicHash": "0x123456789abcdef...7890",
    "status": {
      "Finalized": "0xabc123blockhash..."
    }
  },
  "id": "test"
}

Retrieve all pending extrinsics

POST

https://ksm-assethub.nownodes.io/author_pendingExtrinsics

Returns a list of all pending extrinsics, optionally grouped by sender.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

No parameters required

Response

200OK

List of pending extrinsics

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve all pending extrinsics

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "result": [
    "0x5d028400bc47b8533..."
  ],
  "id": "test"
}

chain

Get the hash of the last finalized block

POST

https://ksm-assethub.nownodes.io/chain_getFinalizedHead

Returns the hash of the block that was finalized on the chain.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

Method parameters (empty array)

Response

200OK

Hash of the last finalized block

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get the hash of the last finalized block

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "result": "0xb0e62ed11652d7562cb63598140c5eb7ac4f2086f0970334ce8472d403c66e1f",
  "id": "test"
}

Get block by hash

POST

https://ksm-assethub.nownodes.io/chain_getBlock

Returns full information of a block, including header, extrinsics, and digest.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing block hash to retrieve

Response

200OK

Full block details

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block by hash

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getBlock",
  "params": [
    "0x451c44b3009ba7a7a005f38c2cae2be4c2be56535f99f8dfac08995872666a44"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "block": {
      "header": {
        "parentHash": "0xd1b678077a900e1b03747ba5ade6c47960fe7ead346c8722289dbc3d9f1c9dc9",
        "number": "0x160303a",
        "stateRoot": "0x53e1c568f798214ff4406c8db027e4e05a1bc30c486ed391ebd0263ce74f3dc2",
        "extrinsicsRoot": "0xa4afa163cf63cc5851f7af044db5d25bc0229aa44645aadb1d98f9ec87f5ce63",
        "digest": {
          "logs": []
        }
      },
      "extrinsics": []
    },
    "justifications": null
  },
  "id": "test"
}

Get block hash by block number

POST

https://ksm-assethub.nownodes.io/chain_getBlockHash

Returns the block hash using the block number in the chain.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<integer>required

Array containing block number

Response

200OK

Block hash by block number

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block hash by block number

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getBlockHash",
  "params": [
    20440517
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getBlockHash",
  "params": [
    20440517
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0x1e2dc73f800f496f8fc2e1ab3e8b8037267546cf24198b0c6e5a7b87e8b38320",
  "id": "test"
}

payment

Retrieve fee information for an encoded extrinsic

POST

https://ksm-assethub.nownodes.io/payment_queryInfo

Returns detailed fee information (weight, partial fee, etc.) for a given encoded extrinsic.

Body

application/json

JSON-RPC request containing encoded extrinsic

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing encoded extrinsic(s) to query fee info for

Response

200OK

Fee information for the extrinsic

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve fee information for an encoded extrinsic

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "payment_queryInfo",
  "params": [
    "0x290284ffdc3488a..."
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "payment_queryInfo",
  "params": [
    "0x290284ffdc3488a..."
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "weight": 12345678,
    "partialFee": "1000000000000"
  },
  "id": "test"
}

state

Retrieve storage for a given key

POST

https://ksm-assethub.nownodes.io/state_getStorage

Returns the value stored under a specific key at the latest block or a given block.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing storage keys

Response

200OK

Returns the value stored at the specified key

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve storage for a given key

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorage",
  "params": [
    "StorageKey"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorage",
  "params": [
    "StorageKey"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0xf08af92e88010000",
  "id": "test"
}

Get the runtime version

POST

https://ksm-assethub.nownodes.io/state_getRuntimeVersion

Returns version information about the runtime, including spec version, implementation version, and transaction version.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

No parameters required

Response

200OK

Runtime version information

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get the runtime version

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "result": {
    "specName": "kusama",
    "implName": "parity-kusama",
    "authoringVersion": 2,
    "specVersion": 1002000,
    "implVersion": 0,
    "transactionVersion": 25,
    "stateVersion": 1
  },
  "id": "test"
}

Retrieve runtime metadata

POST

https://ksm-assethub.nownodes.io/state_getMetadata

Returns the runtime metadata, which includes information about modules, calls, storage, and events.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

No parameters required

Response

200OK

Runtime metadata in hex format

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve runtime metadata

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "result": "0x6e74696d653e000500485472616e73616374696f6e5061796d656e74...",
  "id": "test"
}

Returns proof of storage entries at a specific block state

POST

https://ksm-assethub.nownodes.io/state_getReadProof

Provides a cryptographic proof for the existence and content of storage entries at a given block.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

List of storage keys for which to generate proof

Response

200OK

Proof of storage entries

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Returns proof of storage entries at a specific block state

curl -X POST 'https://ksm-assethub.nownodes.io/state_getReadProof' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "state_getReadProof",
    "params": [
      "keys: Vec<StorageKey>"
    ]
  }'

const response = await fetch('https://ksm-assethub.nownodes.io/state_getReadProof', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "test",
      "method": "state_getReadProof",
      "params": [
        "keys: Vec<StorageKey>"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getReadProof",
  "params": [
    "keys: Vec<StorageKey>"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getReadProof",
  "params": [
    "keys: Vec<StorageKey>"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "at": "0xabc123blockhash...",
    "proof": [
      "0xproofdata1...",
      "0xproofdata2..."
    ]
  },
  "id": "test"
}

Retrieves the storage hash

POST

https://ksm-assethub.nownodes.io/state_getStorageHash

Returns the hash of the storage value stored under a specific key.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

idstringrequired

methodstringrequired

paramsArray<any>required

Storage key(s) to compute hash

Response

200OK

Storage hash result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieves the storage hash

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorageHash",
  "params": [
    "StorageKey"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorageHash",
  "params": [
    "StorageKey"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0xabc123def4567890...",
  "id": "test"
}

Retrieves the storage size

POST

https://ksm-assethub.nownodes.io/state_getStorageSize

Returns the size in bytes of the storage value under a specific key.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

idstringrequired

methodstringrequired

paramsArray<any>required

Storage key(s) to measure

Response

200OK

Storage size result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieves the storage size

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorageSize",
  "params": [
    "StorageKey"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorageSize",
  "params": [
    "StorageKey"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0x0000000000000032",
  "id": "test"
}

Query historical storage entries

POST

https://ksm-assethub.nownodes.io/state_queryStorage

Returns the storage changes between two blocks for a set of keys.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

idstringrequired

methodstringrequired

paramsArray<any>required

List of storage keys and block range

Response

200OK

Query storage result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Query historical storage entries

curl -X POST 'https://ksm-assethub.nownodes.io/state_queryStorage' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "state_queryStorage",
    "params": [
      "StorageKeys",
      "fromBlock",
      "toBlock"
    ]
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_queryStorage",
  "params": [
    "StorageKeys",
    "fromBlock",
    "toBlock"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_queryStorage",
  "params": [
    "StorageKeys",
    "fromBlock",
    "toBlock"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "block": "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4",
    "changes": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7",
        "0x0000000000000000000000000000000000000000000000000000000000000000"
      ]
    ]
  },
  "id": "test"
}

Query storage entries at a specific block

POST

https://ksm-assethub.nownodes.io/state_queryStorageAt

Returns the storage values for given keys at a specified block hash.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

idstringrequired

methodstringrequired

paramsArray<any>required

List of storage keys and block hash

Response

200OK

Storage entries at block

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Query storage entries at a specific block

curl -X POST 'https://ksm-assethub.nownodes.io/state_queryStorageAt' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "state_queryStorageAt",
    "params": [
      "StorageKeys",
      "fromBlock"
    ]
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_queryStorageAt",
  "params": [
    "StorageKeys",
    "fromBlock"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_queryStorageAt",
  "params": [
    "StorageKeys",
    "fromBlock"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7",
      "0x0000000000000000000000000000000000000000000000000000000000000000"
    ]
  ],
  "id": "test"
}

system

Retrieve the name of the chain

POST

https://ksm-assethub.nownodes.io/system_chain

Returns the network name (e.g., Kusama, Polkadot) the node is connected to.

Body

application/json

JSON-RPC request to get chain name

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

Should be empty for this method

Response

200OK

Chain name

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve the name of the chain

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "result": "Kusama",
  "id": "test"
}

Retrieve custom properties from chain spec

POST

https://ksm-assethub.nownodes.io/system_properties

Returns chain-specific properties such as token symbol, decimals, and address format.

Body

application/json

JSON-RPC request to get system properties

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

Should be empty for this method

Response

200OK

System properties of the chain

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve custom properties from chain spec

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "result": {
    "ss58Format": 2,
    "tokenDecimals": 12,
    "tokenSymbol": "KSM"
  },
  "id": "test"
}

health

Health check

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/health'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/node/network'

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

const data = await response.json();

import requests

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

200

{}

Transaction pool

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/node/transaction-pool'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/node/version'

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

const data = await response.json();

import requests

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

200

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

Get information about the Substrate node's activity in the peer-to-peer network.

GET

https://ksm-assethub.nownodes.io/node/network

Returns network related information of the node.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information about the Substrate node's activity in the peer-to-peer network.

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

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

const data = await response.json();

import requests

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

200

{
  "nodeRoles": "Full",
  "numPeers": "string",
  "isSyncing": true,
  "shouldHavePeers": true,
  "localPeerId": "string",
  "localListenAddresses": [
    "string"
  ],
  "peersInfo": [
    {
      "peerId": "string",
      "roles": "string",
      "protocolVersion": "string",
      "bestHash": "string",
      "bestNumber": "string"
    }
  ]
}

Get pending extrinsics from the Substrate node.

GET

https://ksm-assethub.nownodes.io/node/transaction-pool

Returns the extrinsics that the node knows of that have not been included in a block.

Parameters

includeFeebooleanfalsequery

Boolean representing whether or not to include tips, partialFee, and priority in each extrinsic.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get pending extrinsics from the Substrate node.

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

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

const data = await response.json();

import requests

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

200

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

Get information about the Substrates node's implementation and versioning.

GET

https://ksm-assethub.nownodes.io/node/version

Returns versioning information of the node.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information about the Substrates node's implementation and versioning.

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

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

const data = await response.json();

import requests

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

200

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

version

API version

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/version'

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

const data = await response.json();

import requests

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

200

{
  "version": "string"
}

blocks

Block queries and extrinsic data

Get blocks by range

GET

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

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

const data = await response.json();

import requests

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

200

[
  {}
]

Get latest block

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get head block header

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get block by ID

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get raw extrinsics

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get extrinsic by index

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get block header by ID

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get parachain inclusions

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get a range of blocks by their height.

GET

https://ksm-assethub.nownodes.io/blocks

Given a range query parameter return an array of all the blocks within that range.

Parameters

rangestringrequiredquery

A range of integers. There is a max limit of 500 blocks per request.

eventDocsbooleanfalsequery

When set to true, every event will have an extra docs property with a string of the events documentation.

extrinsicDocsbooleanfalsequery

When set to true, every extrinsic will have an extra docs property with a string of the extrinsics documentation.

noFeesbooleanfalsequery

When set to true, the fee won't be calculated for the extrinsics.

Response

200OK

successful operation

400Bad Request

invalid Block identifier supplied

Authorization

api-keyAuthapiKey in header

Get a range of blocks by their height.

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

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

const data = await response.json();

import requests

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

[
  {
    "number": "string",
    "hash": "string",
    "parentHash": "string",
    "stateRoot": "string",
    "extrinsicRoot": "string",
    "authorId": "string",
    "logs": [
      {
        "type": "string",
        "index": "string",
        "value": [
          "string"
        ]
      }
    ],
    "onInitialize": {
      "events": [
        {
          "method": "string",
          "data": [
            "string"
          ]
        }
      ]
    },
    "extrinsics": [
      {
        "method": {
          "pallet": "string",
          "method": "string"
        },
        "signature": {
          "signature": "string",
          "signer": "string"
        },
        "nonce": "string",
        "args": {},
        "tip": "string",
        "hash": "string",
        "info": {
          "weight": {
            "refTime": "string",
            "proofSize": "string"
          },
          "class": "Normal",
          "partialFee": "string",
          "kind": "string"
        },
        "era": "{\"mortalEra\":[\"64\", \"11\"]}",
        "events": [
          {
            "method": "string",
            "data": [
              "string"
            ]
          }
        ],
        "success": true,
        "paysFee": true
      }
    ],
    "onFinalize": {
      "events": [
        {
          "method": "string",
          "data": [
            "string"
          ]
        }
      ]
    },
    "finalized": true
  }
]

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get a block by its height or hash.

GET

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

Returns a single block. BlockId can either be a block hash or a block height. Replaces /block/{number} from versions < v1.0.0.

Parameters

blockIdstringrequiredpath

Block identifier, as the block height or block hash.

eventDocsbooleanfalsequery

When set to true, every event will have an extra docs property with a string of the events documentation.

extrinsicDocsbooleanfalsequery

When set to true, every extrinsic will have an extra docs property with a string of the extrinsics documentation.

noFeesbooleanfalsequery

When set to true, the fee won't be calculated for the extrinsics.

finalizedKeybooleanquery

When set to false, this will override the chain-config, and omit the finalized key in the response. This can increase performance slightly by avoiding an additional RPC call to the node.

decodedXcmMsgsbooleanfalsequery

When set to true, this will show the decoded XCM messages within the extrinsics of the requested block.

paraIdstringquery

When it is set, this will return only the decoded XCM messages for the specified origin Parachain Id (originParaId). To activate this functionality, ensure that the decodedXcmMsgs parameter is set to true.

Response

200OK

successful operation

400Bad Request

invalid Block identifier supplied

Authorization

api-keyAuthapiKey in header

Get a block by its height or hash.

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

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

const data = await response.json();

import requests

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

{
  "number": "string",
  "hash": "string",
  "parentHash": "string",
  "stateRoot": "string",
  "extrinsicRoot": "string",
  "authorId": "string",
  "logs": [
    {
      "type": "string",
      "index": "string",
      "value": [
        "string"
      ]
    }
  ],
  "onInitialize": {
    "events": [
      {
        "method": "string",
        "data": [
          "string"
        ]
      }
    ]
  },
  "extrinsics": [
    {
      "method": {
        "pallet": "string",
        "method": "string"
      },
      "signature": {
        "signature": "string",
        "signer": "string"
      },
      "nonce": "string",
      "args": {},
      "tip": "string",
      "hash": "string",
      "info": {
        "weight": {
          "refTime": "string",
          "proofSize": "string"
        },
        "class": "Normal",
        "partialFee": "string",
        "kind": "string"
      },
      "era": "{\"mortalEra\":[\"64\", \"11\"]}",
      "events": [
        {
          "method": "string",
          "data": [
            "string"
          ]
        }
      ],
      "success": true,
      "paysFee": true
    }
  ],
  "onFinalize": {
    "events": [
      {
        "method": "string",
        "data": [
          "string"
        ]
      }
    ]
  },
  "finalized": true,
  "decodedXcmMsgs": {
    "horizontalMessages": [
      {
        "originParaId": "string",
        "destinationParaId": "string",
        "data": {}
      }
    ],
    "downwardMessages": [
      {
        "sentAt": "string",
        "msg": "string",
        "data": {}
      }
    ],
    "upwardMessages": [
      {
        "originParaId": "string",
        "data": {}
      }
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

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

GET

https://ksm-assethub.nownodes.io/blocks/{blockId}/header

Returns a single block's header. BlockId can either be a block hash or a block height.

Parameters

blockIdstringrequiredpath

Block identifier, as the block height or block hash.

Response

200OK

successful operation

400Bad Request

invalid Block identifier supplied

Authorization

api-keyAuthapiKey in header

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

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

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

const data = await response.json();

import requests

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

{
  "parentHash": "string",
  "number": "string",
  "stateRoot": "string",
  "extrinsicRoot": "string",
  "digest": {
    "logs": [
      {
        "type": "string",
        "index": "string",
        "value": [
          "string"
        ]
      }
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

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

GET

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

Returns a single extrinsic.

Parameters

blockIdstringrequiredpath

Block identifier, as the block height or block hash.

extrinsicIndexstringrequiredpath

The extrinsic's index within the block's body.

eventDocsbooleanfalsequery

When set to true, every event will have an extra docs property with a string of the events documentation.

extrinsicDocsbooleanfalsequery

When set to true, every extrinsic will have an extra docs property with a string of the extrinsics documentation.

Response

200OK

successful operation

400Bad Request

Requested extrinsicIndex does not exist

Authorization

api-keyAuthapiKey in header

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

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "extrinsic": {
    "method": {
      "pallet": "string",
      "method": "string"
    },
    "signature": {
      "signature": "string",
      "signer": "string"
    },
    "nonce": "string",
    "args": {},
    "tip": "string",
    "hash": "string",
    "info": {
      "weight": {
        "refTime": "string",
        "proofSize": "string"
      },
      "class": "Normal",
      "partialFee": "string",
      "kind": "string"
    },
    "era": "{\"mortalEra\":[\"64\", \"11\"]}",
    "events": [
      {
        "method": "string",
        "data": [
          "string"
        ]
      }
    ],
    "success": true,
    "paysFee": true
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the most recently finalized block.

GET

https://ksm-assethub.nownodes.io/blocks/head

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

Parameters

finalizedbooleantruequery

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

eventDocsbooleanfalsequery

When set to true, every event will have an extra docs property with a string of the events documentation.

extrinsicDocsbooleanfalsequery

When set to true, every extrinsic will have an extra docs property with a string of the extrinsics documentation.

noFeesbooleanfalsequery

When set to true, the fee won't be calculated for the extrinsics.

decodedXcmMsgsbooleanfalsequery

When set to true, this will show the decoded XCM messages within the extrinsics of the requested block.

paraIdstringquery

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get the most recently finalized block.

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

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

const data = await response.json();

import requests

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

200

{
  "number": "string",
  "hash": "string",
  "parentHash": "string",
  "stateRoot": "string",
  "extrinsicRoot": "string",
  "authorId": "string",
  "logs": [
    {
      "type": "string",
      "index": "string",
      "value": [
        "string"
      ]
    }
  ],
  "onInitialize": {
    "events": [
      {
        "method": "string",
        "data": [
          "string"
        ]
      }
    ]
  },
  "extrinsics": [
    {
      "method": {
        "pallet": "string",
        "method": "string"
      },
      "signature": {
        "signature": "string",
        "signer": "string"
      },
      "nonce": "string",
      "args": {},
      "tip": "string",
      "hash": "string",
      "info": {
        "weight": {
          "refTime": "string",
          "proofSize": "string"
        },
        "class": "Normal",
        "partialFee": "string",
        "kind": "string"
      },
      "era": "{\"mortalEra\":[\"64\", \"11\"]}",
      "events": [
        {
          "method": "string",
          "data": [
            "string"
          ]
        }
      ],
      "success": true,
      "paysFee": true
    }
  ],
  "onFinalize": {
    "events": [
      {
        "method": "string",
        "data": [
          "string"
        ]
      }
    ]
  },
  "finalized": true,
  "decodedXcmMsgs": {
    "horizontalMessages": [
      {
        "originParaId": "string",
        "destinationParaId": "string",
        "data": {}
      }
    ],
    "downwardMessages": [
      {
        "sentAt": "string",
        "msg": "string",
        "data": {}
      }
    ],
    "upwardMessages": [
      {
        "originParaId": "string",
        "data": {}
      }
    ]
  }
}

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

GET

https://ksm-assethub.nownodes.io/blocks/head/header

Returns the most recently finalized block's header.

Parameters

finalizedbooleantruequery

Response

200OK

successful operation

400Bad Request

invalid Block identifier supplied

Authorization

api-keyAuthapiKey in header

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

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

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

const data = await response.json();

import requests

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

{
  "parentHash": "string",
  "number": "string",
  "stateRoot": "string",
  "extrinsicRoot": "string",
  "digest": {
    "logs": [
      {
        "type": "string",
        "index": "string",
        "value": [
          "string"
        ]
      }
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get a blocks header & its extrinsics as hex values.

GET

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

Returns a block & its extrinsics as hex values. BlockId can either be a block hash or a block height.

Parameters

blockIdstringrequiredpath

Block identifier, as the block height or block hash.

Response

200OK

successful operation

400Bad Request

invalid Block identifier supplied

Authorization

api-keyAuthapiKey in header

Get a blocks header & its extrinsics as hex values.

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

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

const data = await response.json();

import requests

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

{
  "number": "string",
  "parentHash": "string",
  "stateRoot": "string",
  "extrinsicRoot": "string",
  "digest": {
    "logs": [
      {
        "type": "string",
        "index": "string",
        "value": [
          "string"
        ]
      }
    ]
  },
  "extrinsics": [
    "string"
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

accounts

Account balance, staking, and proxy information

Compare account addresses

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/accounts/compare'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/asset-approvals'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/asset-balances'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/balance-info'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/convert'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/foreign-asset-balances'

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

const data = await response.json();

import requests

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

200

{}

Account pool asset approvals

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-approvals'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-balances'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/proxy-info'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/staking-info'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/staking-payouts'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/validate'

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

const data = await response.json();

import requests

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

200

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

Account vesting info

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/vesting-info'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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"
    }
  ]
}

Get an array of asset-balances for an account.

GET

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

Returns information about an account's asset-balances. This is specific to the assets pallet for parachains. If no assets query parameter is provided, all asset-balances for the given account will be returned.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query asset-balance info for the specified account.

assetsArray<string><Array of unsignedInteger's>query

An array of AssetId's to be queried. If not supplied, defaults to providing all asset balances associated with the accountId will be returned. The array query param format follows Express 4.x API. ex:?assets[]=1&assets[]=2&assets[]=3.

Response

200OK

successfull operation

400Bad Request

Invalid Address

Authorization

api-keyAuthapiKey in header

Get an array of asset-balances for an account.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get foreign asset balances for an account

GET

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

Retrieves all foreign asset holdings (XCM assets from other parachains) for a specific account in AssetHub. Returns an array of foreign assets with their balances, metadata, and verification status.

Parameters

accountIdstringrequiredpath

The SS58-encoded account identifier (32-byte public key) to query foreign asset balances for.

atstringquery

Optional block hash or height to query historical state. If not provided, uses the latest finalized block.

includeZeroBalancesbooleanfalsequery

Include assets with zero balance in the response. Default is false.

verifiedOnlybooleanfalsequery

Return only verified foreign assets (assets that have gone through governance approval). Default is false.

Response

200OK

Successful response containing foreign asset balances for the account

Authorization

api-keyAuthapiKey in header

Get foreign asset balances for an account

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": 1.075488263204322e+76,
    "height": "11988411"
  },
  "foreignAssets": []
}

Get an asset approval for an account.

GET

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

Returns information about an account's asset approval transaction. It is required to pass in a delegate and an assetId as query parameters.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query asset approval info for the specified account.

assetIdstring<unsignedInteger>requiredquery

The assetId associated with the asset-approval.

delegatestring<SS58>requiredquery

The delegate's accountId associated with an asset-approval.

Response

200OK

successfull operation

400Bad Request

Invalid Address

Authorization

api-keyAuthapiKey in header

Get an asset approval for an account.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "amount": "string",
  "deposit": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get balance information for an account.

GET

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

Returns information about an account's balance. Replaces /balance/{address} from versions < v1.0.0.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query balance info for the specified account.

tokenstringquery

Token to query the balance of. If not specified it will query the chains native token (e.g. DOT for Polkadot). Note: this is only relevant for chains that support multiple tokens through the ORML tokens pallet.

denominatedbooleanfalsequery

When set to true it will denominate any balance's given atomic value using the chains given decimal value.

Response

200OK

successful operation

400Bad Request

Invalid Address

404Not Found

account not found

Authorization

api-keyAuthapiKey in header

Get balance information for an account.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Convert a given AccountId to an SS58 address.

GET

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

Returns the SS58 prefix, the network address format, the SS58 address, and the AccountId that was given as input parameter, the scheme that was used and if it is a public key or not (boolean).

Parameters

accountIdstring<AccountId or Hex>requiredpath

AccountId or Public Key (hex).

schemestring<string>sr25519query

The cryptographic scheme to be used in order to convert the AccountId to an SS58 address. It can take one of three values [sr25519, ed25519, ecdsa]. The default scheme that is used is sr25519 (if it is not set in the query parameter).

prefixstring<number>42query

The address prefix which can be one of the values found in the SS58-registry.

publicKeystring<boolean>truequery

Defines if the given value in the path parameter is a Public Key (hex) or not (hence AccountId).

Response

200OK

successfully converted the AccountId and retrieved the address info.

400Bad Request

Invalid AccountId

404Not Found

AccountId not found

Authorization

api-keyAuthapiKey in header

Convert a given AccountId to an SS58 address.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get an array of pool-asset-balances for an account.

GET

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

Returns information about an account's pool-asset-balances. This is specific to the pool assets pallet for parachains. If no assets query parameter is provided, all pool-asset-balances for the given account will be returned.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query pool-asset-balance info for the specified account.

assetsArray<string><Array of unsignedInteger's>query

Response

200OK

successfull operation

400Bad Request

Invalid Address

Authorization

api-keyAuthapiKey in header

Get an array of pool-asset-balances for an account.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get an asset approval for an account.

GET

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

Returns information about an account's asset approval transaction. It is required to pass in a delegate and an assetId as query parameters.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query asset approval info for the specified account.

assetIdstring<unsignedInteger>requiredquery

The assetId associated with the asset-approval.

delegatestring<SS58>requiredquery

The delegate's accountId associated with an asset-approval.

Response

200OK

successfull operation

400Bad Request

Invalid Address

Authorization

api-keyAuthapiKey in header

Get an asset approval for an account.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "amount": "string",
  "deposit": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get proxy account information.

GET

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

Returns information about a proxy account. This will include delegated accounts and deposits held.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query proxy info for the specified account.

Response

200OK

successfull operation

400Bad Request

Invalid Address

Authorization

api-keyAuthapiKey in header

Get proxy account information.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get vesting information for an account.

GET

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

Returns the vesting schedule for an account. Replaces /vesting/{address} from versions < v1.0.0.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query the vesting info for the specified account.

Response

200OK

successful operation

400Bad Request

Invalid Address

404Not Found

account not found

Authorization

api-keyAuthapiKey in header

Get vesting information for an account.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Validate a given address.

GET

https://ksm-assethub.nownodes.io/accounts/{address}/validate

Returns whether the given address is valid ss58 format, the ss58 prefix if the address has one, the network address format, and what the account ID is for this address.

Parameters

addressstring<SS58 or Hex>requiredpath

SS58 or Hex address of the account.

Response

200OK

successfully retrieved address info

Authorization

api-keyAuthapiKey in header

Validate a given address.

curl -X GET 'https://ksm-assethub.nownodes.io/accounts/{address}/validate'

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

const data = await response.json();

import requests

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

200

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

Compares up to 30 SS58 addresses.

GET

https://ksm-assethub.nownodes.io/accounts/compare

Returns if the given addresses are equal or not, along with details of each address. Equality is determined by comparing the accountId/publicKey of each address.

Parameters

addressesArray<string>requiredquery

An array or a comma separated string of SS58 addresses. Provide up to 30 addresses using one of these formats ?addresses=...&addresses=... or ?addresses[]=...&addresses[]=... or ?addresses=...,....

Response

200OK

successfully compared at least two SS58 addresses.

400Bad Request

Invalid Address

Authorization

api-keyAuthapiKey in header

Compares up to 30 SS58 addresses.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

pallets

Runtime pallet metadata, storage, constants, events, errors

Liquidity pools

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/asset-conversion/liquidity-pools'

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

const data = await response.json();

import requests

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

200

{}

Next available pool ID

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/asset-conversion/next-available-id'

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

const data = await response.json();

import requests

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

200

{}

Asset info

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/assets/{assetId}/asset-info'

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

const data = await response.json();

import requests

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

200

{}

Foreign assets

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/foreign-assets'

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

const data = await response.json();

import requests

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

200

{}

Nomination pools info

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/nomination-pools/info'

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

const data = await response.json();

import requests

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

200

{}

Nomination pool details

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/nomination-pools/{poolId}'

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

const data = await response.json();

import requests

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

200

{}

On-going referenda

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/on-going-referenda'

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

const data = await response.json();

import requests

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

200

{}

Pool asset info

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/pool-assets/{assetId}/asset-info'

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

const data = await response.json();

import requests

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

200

{}

Staking progress

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/staking/progress'

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

const data = await response.json();

import requests

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

200

{}

Staking validators

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/staking/validators'

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

const data = await response.json();

import requests

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

200

{}

Pallet constants

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/consts'

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

const data = await response.json();

import requests

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

200

{}

Pallet constant value

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/consts/{constantItemId}'

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

const data = await response.json();

import requests

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

200

{}

Pallet dispatchables

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables'

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

const data = await response.json();

import requests

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

200

{}

Pallet dispatchable details

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables/{dispatchableId}'

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

const data = await response.json();

import requests

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

200

{}

Pallet errors

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/errors'

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

const data = await response.json();

import requests

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

200

{}

Pallet error details

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/errors/{errorItemId}'

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

const data = await response.json();

import requests

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

200

{}

Get pallet events

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/events'

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

const data = await response.json();

import requests

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

200

{}

Get pallet event item

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/events/{eventItemId}'

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

const data = await response.json();

import requests

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

200

{}

Pallet storage items

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/storage'

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

const data = await response.json();

import requests

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

200

{}

Pallet storage item value

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/storage/{storageItemId}'

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

const data = await response.json();

import requests

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

200

{}

Get information and metadata associated with an asset.

GET

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

Returns information associated with an asset which includes the assets AssetDetails and AssetMetadata.

Parameters

assetIdstring<unsignedInteger>requiredpath

The unsignedInteger Id of an asset.

atstring<unsignedInteger or $hex>query

Block at which to retrieve the assetInfo.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information and metadata associated with an asset.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "assetInfo": {
    "owner": "string",
    "issuer": "string",
    "admin": "string",
    "freezer": "string",
    "supply": "string",
    "deposit": "string",
    "minBalance": "string",
    "isSufficient": true,
    "accounts": "string",
    "sufficients": "string",
    "approvals": "string",
    "status": "string"
  },
  "assetMetadata": {
    "deposit": "string",
    "name": "string",
    "symbol": "string",
    "decimals": "string",
    "isFrozen": true
  }
}

Get information related to existing liquidity pools.

GET

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

Returns a list of the existing liquidity pools and its corresponding tokens at a given block height. If no block is specified, it returns the latest list available.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the liquidity pools information.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get information related to existing liquidity pools.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "pools": "[{\"reserves\":[{\"parents\":\"1\",\"interior\":{\"here\": null}},{\"parents\":\"0\",\"interior\":{\"x2\":[{\"palletInstance\": \"50\"},{\"generalIndex\":\"2\"}]}}],\"lpToken\":{\"lpToken\":\"1\"} },{\"lpToken\":{\"lpToken\":\"0\"}}]"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the next available liquidity pool id.

GET

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

Returns the next available liquidity pool's id at a given block height. If no block is specified, it returns the latest list available.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the next liquidity pool's id.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get the next available liquidity pool id.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "id": "4"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get information and metadata associated with foreign assets.

GET

https://ksm-assethub.nownodes.io/pallets/foreign-assets

Returns information associated with every foreign asset which includes the assets AssetDetails and AssetMetadata.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the foreign assets.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information and metadata associated with foreign assets.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "items": [
    {
      "foreignAssetInfo": {
        "owner": "string",
        "issuer": "string",
        "admin": "string",
        "freezer": "string",
        "supply": "string",
        "deposit": "string",
        "minBalance": "string",
        "isSufficient": true,
        "accounts": "string",
        "sufficients": "string",
        "approvals": "string",
        "status": "string"
      },
      "foreignAssetMetadata": {
        "deposit": "string",
        "name": "string",
        "symbol": "string",
        "decimals": "string",
        "isFrozen": true
      }
    }
  ]
}

Get information associated with nomination pools.

GET

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

Returns information and metadata for nomination pools including pool counters and limits.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the nomination pool info.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information associated with nomination pools.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "counterForBondedPools": 0,
  "counterForMetadata": 0,
  "counterForPoolMembers": 0,
  "counterForReversePoolIdLookup": 0,
  "counterForRewardPools": 0,
  "counterForSubPoolsStorage": 0,
  "lastPoolId": 0,
  "maxPoolMembers": 0,
  "maxPoolMembersPerPool": 0,
  "maxPools": 0,
  "minCreateBond": 0,
  "minJoinBond": 0
}

Get information and metadata associated with a nomination pool.

GET

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

Returns information associated with a nomination pool which includes the nomination pools' bondedPool, rewardPool and metadata.

Parameters

poolIdstring<unsignedInteger>requiredpath

The unsignedInteger Id of a nomination pool.

atstring<unsignedInteger or $hex>query

Block at which to retrieve the nomination pool.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information and metadata associated with a nomination pool.

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

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

const data = await response.json();

import requests

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

200

{
  "bondedPool": {
    "points": 0,
    "state": "string",
    "memberCounter": 0,
    "roles": {
      "depositor": "string",
      "root": "string",
      "nominator": "string",
      "stateToggler": "string"
    }
  },
  "rewardPool": {
    "lastRecordedRewardCounter": 0,
    "lastRecordedTotalPayouts": 0,
    "totalRewardsClaimed": 0
  }
}

Get a list of all on-going referenda that have track `root (0)` and `whitelisted (1)`, along with their associated information.

GET

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

Returns information associated with on-going referenda which includes the referendum's enactment, submitted and deciding fields.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the on-going referenda.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get a list of all on-going referenda that have track `root (0)` and `whitelisted (1)`, along with their associated information.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "referenda": [
    {
      "id": "string",
      "decisionDeposit": {
        "who": "string",
        "amount": "string"
      },
      "enactment": "at",
      "submitted": "string",
      "deciding": {
        "since": "string",
        "confirming": "string"
      }
    }
  ]
}

Get a list of constants for a pallet.

GET

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

Returns a list of const item metadata for constant items of the specified palletId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read constant metadata for. Note: the pallet name must match what is specified in the runtime metadata.

onlyIdsbooleanquery

Only return the names (IDs) of the const items instead of every constant's metadata.

atstring<unsignedInteger or $hex>query

Block at which to retrieve a list of the pallet's constant items.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find pallet with palletId

Authorization

api-keyAuthapiKey in header

Get a list of constants for a pallet.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "pallet": "democracy",
  "palletIndex": "14",
  "items": [
    {
      "name": "VotingPeriod",
      "type": "4",
      "value": "0x00270600",
      "docs": "Information concerning any given constant.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control."
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the value of a constant item.

GET

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

Returns the value stored under the constantItemId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read constant metadata for. Note: the pallet name must match what is specified in the runtime metadata.

constantItemIdstringrequiredpath

Id of the const item to query for.

atstring<unsignedInteger or $hex>query

Block at which to query the const item at.

metadatabooleanfalsequery

Include the const items metadata (including documentation) if set to true.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find resource with id

Authorization

api-keyAuthapiKey in header

Get the value of a constant item.

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

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

const data = await response.json();

import requests

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

{
  "pallet": "democracy",
  "palletIndex": "14",
  "errorItem": "EnactmentPeriod",
  "metadata": {
    "name": "VotingPeriod",
    "type": "4",
    "value": "0x00270600",
    "docs": "Information concerning any given constant.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control."
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get a list of dispatchables for a pallet.

GET

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

Returns a list of dispatchable item metadata for distpachable items of the specified palletId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read dispatchable metadata for. Note: the pallet name must match what is specified in the runtime metadata.

onlyIdsbooleanquery

Only return the names (IDs) of the dispatchable items instead of every dispatchable's metadata.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find pallet with palletId

Authorization

api-keyAuthapiKey in header

Get a list of dispatchables for a pallet.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "pallet": "democracy",
  "palletIndex": "14",
  "items": [
    {
      "name": "propose",
      "fields": [
        "string"
      ],
      "index": "0",
      "docs": "Information concerning any given dispatchable.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control.",
      "args": [
        "string"
      ]
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the value of a dispatchable item.

GET

https://ksm-assethub.nownodes.io/pallets/{palletId}/dispatchables/{dispatchableItemId}

Returns the value stored under the dispatchableItemId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read dispatchable metadata for. Note: the pallet name must match what is specified in the runtime metadata.

dispatchableItemIdstringrequiredpath

Id of the dispatchable item to query for.

metadatabooleanfalsequery

Include the dispatchable items metadata (including documentation) if set to true.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find resource with id

Authorization

api-keyAuthapiKey in header

Get the value of a dispatchable item.

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

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

const data = await response.json();

import requests

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

{
  "pallet": "democracy",
  "palletIndex": "14",
  "dispatchableItem": "vote",
  "metadata": {
    "name": "propose",
    "fields": [
      "string"
    ],
    "index": "0",
    "docs": "Information concerning any given dispatchable.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control.",
    "args": [
      "string"
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get a list of errors for a pallet.

GET

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

Returns a list of error item metadata for error items of the specified palletId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read error metadata for. Note: the pallet name must match what is specified in the runtime metadata.

onlyIdsbooleanquery

Only return the names (IDs) of the error items instead of every error's metadata.

atstring<unsignedInteger or $hex>query

Block at which to retrieve a list of the pallet's error items.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find pallet with palletId

Authorization

api-keyAuthapiKey in header

Get a list of errors for a pallet.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "pallet": "democracy",
  "palletIndex": "14",
  "items": [
    {
      "name": "InsufficientFunds",
      "fields": [
        "string"
      ],
      "index": "0",
      "docs": " Information concerning any given error.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control.",
      "args": [
        "string"
      ]
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the value of an error item.

GET

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

Returns the value stored under the errorItemId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read error metadata for. Note: the pallet name must match what is specified in the runtime metadata.

errorItemIdstringrequiredpath

Id of the error item to query for.

atstring<unsignedInteger or $hex>query

Block at which to query the error item at.

metadatabooleanfalsequery

Include the error items metadata (including documentation) if set to true.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find resource with id

Authorization

api-keyAuthapiKey in header

Get the value of an error item.

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

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

const data = await response.json();

import requests

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

{
  "pallet": "democracy",
  "palletIndex": "14",
  "errorItem": "ValueLow",
  "metadata": {
    "name": "InsufficientFunds",
    "fields": [
      "string"
    ],
    "index": "0",
    "docs": " Information concerning any given error.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control.",
    "args": [
      "string"
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get a list of events for a pallet.

GET

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

Returns a list of event item metadata for event items of the specified palletId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read event metadata for. Note: the pallet name must match what is specified in the runtime metadata.

onlyIdsbooleanquery

Only return the names (IDs) of the event items instead of every event's metadata.

atstring<unsignedInteger or $hex>query

Block at which to retrieve a list of the pallet's event items.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find pallet with palletId

Authorization

api-keyAuthapiKey in header

Get a list of events for a pallet.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "pallet": "democracy",
  "palletIndex": "14",
  "items": [
    {
      "name": "Tabled",
      "fields": [
        "string"
      ],
      "index": "0",
      "docs": " Information concerning any given event.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control.",
      "args": [
        "string"
      ]
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the value of an event item.

GET

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

Returns the value stored under the eventItemId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read event metadata for. Note: the pallet name must match what is specified in the runtime metadata.

eventItemIdstringrequiredpath

Id of the event item to query for.

atstring<unsignedInteger or $hex>query

Block at which to query the event item at.

metadatabooleanfalsequery

Include the event items metadata (including documentation) if set to true.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find resource with id

Authorization

api-keyAuthapiKey in header

Get the value of an event item.

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

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

const data = await response.json();

import requests

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

{
  "pallet": "democracy",
  "palletIndex": "14",
  "eventItem": "Proposed",
  "metadata": {
    "name": "Tabled",
    "fields": [
      "string"
    ],
    "index": "0",
    "docs": " Information concerning any given event.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control.",
    "args": [
      "string"
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get a list of storage items for a pallet.

GET

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

Returns a list of storage item metadata for storage items of the specified palletId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to query the storage of. Note: the pallet name must match what is specified in the runtime metadata.

onlyIdsbooleanquery

Only return the names (IDs) of the storage items instead of all of each storage item's metadata.

atstring<unsignedInteger or $hex>query

Block at which to retrieve a list of the pallet's storage items.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find pallet with palletId

Authorization

api-keyAuthapiKey in header

Get a list of storage items for a pallet.

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

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

const data = await response.json();

import requests

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

{
  "pallet": "democracy",
  "palletIndex": "15",
  "items": [
    {
      "name": "ReferendumInfoOf",
      "modifier": "Optional",
      "type": {},
      "fallback": "0x00",
      "docs": " Information concerning any given referendum.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control."
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the value of a storage item.

GET

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

Returns the value stored under the storageItemId. If it is a map, query param key1 is required. If the storage item is double map query params key1 and key2 are required.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to query the storage of. Note: pallet name aligns with pallet name as specified in runtime metadata.

storageItemIdstringrequiredpath

Id of the storage item to query for.

keysArray<string>query

Set of N keys used for querying a storage map. It should be queried using the following format - ?keys[]=key1&keys[]=key2. Order matters, as it will determine the order the keys are passed into the storage calls.

atstring<unsignedInteger or $hex>query

Block at which to query the storage item at.

metadatabooleanfalsequery

Include the storage items metadata (including documentation) if set to true.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find resource with id

Authorization

api-keyAuthapiKey in header

Get the value of a storage item.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "pallet": "democracy",
  "palletIndex": "15",
  "storageItem": "referendumInfoOf",
  "keys": [
    "0x00",
    "0x01"
  ],
  "value": {
    "Ongoing": {
      "end": "1612800",
      "proposalHash": "0x7de70fc8be782076d0b5772be77153d172a5381c72dd56d3385e25f62abf507e",
      "threshold": "Supermajorityapproval",
      "delay": "403200",
      "tally": {
        "ayes": "41925212461400000",
        "nays": "214535586500000",
        "turnout": "34485320658000000"
      }
    }
  },
  "metadata": {
    "name": "ReferendumInfoOf",
    "modifier": "Optional",
    "type": {},
    "fallback": "0x00",
    "docs": " Information concerning any given referendum.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control."
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get information and metadata associated with a pool asset.

GET

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

Returns information associated with a pool asset which includes the assets AssetDetails and AssetMetadata.

Parameters

assetIdstring<unsignedInteger>requiredpath

The unsignedInteger Id of a pool asset.

atstring<unsignedInteger or $hex>query

Block at which to retrieve the assetInfo.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information and metadata associated with a pool asset.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "poolAssetInfo": {
    "owner": "string",
    "issuer": "string",
    "admin": "string",
    "freezer": "string",
    "supply": "string",
    "deposit": "string",
    "minBalance": "string",
    "isSufficient": true,
    "accounts": "string",
    "sufficients": "string",
    "approvals": "string",
    "status": "string"
  },
  "poolAssetMetadata": {
    "deposit": "string",
    "name": "string",
    "symbol": "string",
    "decimals": "string",
    "isFrozen": true
  }
}

Get progress on the general Staking pallet system.

GET

https://ksm-assethub.nownodes.io/pallets/staking/progress

Returns information on the progress of key components of the staking system and estimates of future points of interest. Replaces /staking-info from versions < v1.0.0.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve a staking progress report.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get progress on the general Staking pallet system.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "activeEra": "string",
  "forceEra": "ForceNone",
  "nextActiveEraEstimate": "string",
  "nextSessionEstimate": "string",
  "unappliedSlashes": [
    {
      "validator": "string",
      "own": "string",
      "others": [
        "string"
      ],
      "reporters": [
        "string"
      ],
      "payout": "string"
    }
  ],
  "electionStatus": {
    "status": {},
    "toggleEstimate": "string"
  },
  "idealValidatorCount": "string",
  "validatorSet": [
    "string"
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get all validators (active/waiting) of a specific chain.

GET

https://ksm-assethub.nownodes.io/pallets/staking/validators

Returns a list of all validators addresses and their corresponding status which can be either active or waiting. It will also return a list of active validators that will not be part of the next era for staking. They will be under the key "validatorsToBeChilled". It's important to note, that addresses can be present in both the "validators" key, and "validatorsToBeChilled".

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the list of validators.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get all validators (active/waiting) of a specific chain.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "validators": [
    {
      "address": "string",
      "status": "string"
    }
  ],
  "validatorsToBeChilled": [
    {
      "address": "string",
      "status": "string"
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

runtime

Runtime specification, metadata, and code

Runtime Wasm code

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/runtime/code'

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

const data = await response.json();

import requests

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

200

{}

Runtime metadata

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/runtime/metadata'

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

const data = await response.json();

import requests

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

200

{}

Available metadata versions

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/runtime/metadata/versions'

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

const data = await response.json();

import requests

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

200

[
  "string"
]

Runtime metadata by version

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/runtime/metadata/{version}'

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

const data = await response.json();

import requests

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

200

{}

Runtime specification

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/runtime/spec'

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

const data = await response.json();

import requests

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

200

{}

Get the runtime metadata in decoded, JSON form.

GET

https://ksm-assethub.nownodes.io/runtime/metadata

Returns the runtime metadata as a JSON object. Substrate Reference: - FRAME Support: https://crates.parity.io/frame_support/metadata/index.html - Knowledge Base: https://substrate.dev/docs/en/knowledgebase/runtime/metadata

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the metadata at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get the runtime metadata in decoded, JSON form.

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

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

const data = await response.json();

import requests

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

200

{}

Get the requested version of runtime metadata in decoded, JSON form.

GET

https://ksm-assethub.nownodes.io/runtime/metadata/{metadataVersion}

Returns the requested version of runtime metadata as a JSON object. Substrate Reference: - FRAME Support: https://crates.parity.io/frame_support/metadata/index.html - Knowledge Base: https://substrate.dev/docs/en/knowledgebase/runtime/metadata

Parameters

metadataVersionstringrequiredpath

The version of metadata. The input is expected in a vX format, where X represents the version number (e.g. v14, v15).

atstring<unsignedInteger or $hex>query

Block at which to retrieve the metadata at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get the requested version of runtime metadata in decoded, JSON form.

curl -X GET 'https://ksm-assethub.nownodes.io/runtime/metadata/{metadataVersion}'

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

const data = await response.json();

import requests

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

200

{}

Get the available versions of runtime metadata.

GET

https://ksm-assethub.nownodes.io/runtime/metadata/versions

Returns the available versions of runtime metadata. Substrate Reference: - FRAME Support: https://crates.parity.io/frame_support/metadata/index.html - Knowledge Base: https://substrate.dev/docs/en/knowledgebase/runtime/metadata

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the metadata versions at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get the available versions of runtime metadata.

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

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

const data = await response.json();

import requests

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

200

[
  "string"
]

Get the runtime wasm blob.

GET

https://ksm-assethub.nownodes.io/runtime/code

Returns the runtime Wasm blob in hex format.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the runtime wasm blob at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get the runtime wasm blob.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "code": "string"
}

Get version information of the Substrate runtime.

GET

https://ksm-assethub.nownodes.io/runtime/spec

Returns version information related to the runtime.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve runtime version information at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get version information of the Substrate runtime.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "authoringVersion": "string",
  "chainType": "{\"live\": null}",
  "implVersion": "string",
  "specName": "string",
  "specVersion": "string",
  "transactionVersion": "string",
  "properties": {}
}

transaction

Transaction submission, fee estimation, and construction material

Submit transaction

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/transaction' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-assethub.nownodes.io/v1/transaction', json=payload)
data = response.json()

Request Body

{}

200

{}

Dry run transaction

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/dry-run' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/dry-run', json=payload)
data = response.json()

Request Body

{}

200

{}

Estimate transaction fee

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/fee-estimate' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/transaction/material'

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

const data = await response.json();

import requests

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

200

{}

Transaction material with versioned metadata

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/material/{metadataVersion}'

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

const data = await response.json();

import requests

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

200

{}

Generate metadata blob

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/metadata-blob' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/metadata-blob', json=payload)
data = response.json()

Request Body

{}

200

{}

Parse transaction

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/parse' \
  -H 'Content-Type: application/json' \
  -d '{
    "tx": "0x4902840004316d995f..."
  }'

const response = await fetch('https://ksm-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://ksm-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"
}

Submit a transaction to the node's transaction pool.

POST

https://ksm-assethub.nownodes.io/transaction

Accepts a valid signed extrinsic. Replaces /tx from versions < v1.0.0.

Body

application/json

txstring<hex>

Response

200OK

successful operation

400Bad Request

failed to parse or submit transaction

Authorization

api-keyAuthapiKey in header

Submit a transaction to the node's transaction pool.

curl -X POST 'https://ksm-assethub.nownodes.io/transaction' \
  -H 'Content-Type: application/json' \
  -d '{
    "tx": "string"
  }'

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

const data = await response.json();

import requests

payload = {
  "tx": "string"
}

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

Request Body

{
  "tx": "string"
}

{
  "hash": "string"
}

{
  "code": 0,
  "error": "string",
  "transaction": "string",
  "cause": "string",
  "stack": "string"
}

Dry run an extrinsic.

POST

https://ksm-assethub.nownodes.io/transaction/dry-run

Use the dryRun call to simulate the submission of a transaction without executing it so that you can check for potential errors and validate the expected outcome.

Body

application/json

atstring<unsignedInteger>

txstring<hex>

senderAddressstring<ss58>

Response

200OK

successful operation

400Bad Request

failed to dry-run transaction

Authorization

api-keyAuthapiKey in header

Dry run an extrinsic.

curl -X POST 'https://ksm-assethub.nownodes.io/transaction/dry-run' \
  -H 'Content-Type: application/json' \
  -d '{
    "at": "string",
    "tx": "string",
    "senderAddress": "string"
  }'

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

const data = await response.json();

import requests

payload = {
  "at": "string",
  "tx": "string",
  "senderAddress": "string"
}

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

Request Body

{
  "at": "string",
  "tx": "string",
  "senderAddress": "string"
}

{
  "resultType": "DispatchOutcome",
  "result": {
    "actualWeight": "string",
    "paysFee": "string"
  }
}

{
  "code": 0,
  "error": "string",
  "transaction": "string",
  "cause": "string",
  "stack": "string"
}

Receive a fee estimate for a transaction.

POST

https://ksm-assethub.nownodes.io/transaction/fee-estimate

Send a serialized transaction and receive back a naive fee estimate. Note: partialFee does not include any tips that you may add to increase a transaction's priority. See the reference on compute_fee. Replaces /tx/fee-estimate from versions < v1.0.0. Substrate Reference: - RuntimeDispatchInfo: https://crates.parity.io/pallet_transaction_payment_rpc_runtime_api/struct.RuntimeDispatchInfo.html - query_info: https://crates.parity.io/pallet_transaction_payment/struct.Module.html#method.query_info - compute_fee: https://crates.parity.io/pallet_transaction_payment/struct.Module.html#method.compute_fee

Body

application/json

txstring<hex>

Response

200OK

successful operation

400Bad Request

fee estimation failure

Authorization

api-keyAuthapiKey in header

Receive a fee estimate for a transaction.

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

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

const data = await response.json();

import requests

payload = {
  "tx": "string"
}

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

Request Body

{
  "tx": "string"
}

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

{
  "code": 0,
  "at": {
    "hash": "string"
  },
  "error": "string",
  "transaction": "string",
  "block": "string",
  "cause": "string",
  "stack": "string"
}

Get all the network information needed to construct a transaction offline.

GET

https://ksm-assethub.nownodes.io/transaction/material

Returns the material that is universal to constructing any signed transaction offline. Replaces /tx/artifacts from versions < v1.0.0.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the transaction construction material.

noMetabooleanfalsequery

DEPRECATED! This is no longer supported

metadatastringquery

Specifies the format of the metadata to be returned. Accepted values are 'json', and 'scale'. 'json' being the decoded metadata, and 'scale' being the SCALE encoded metadata. When metadata is not inputted, the metadata field will be absent.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get all the network information needed to construct a transaction offline.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "genesisHash": "string",
  "chainName": "string",
  "specName": "string",
  "specVersion": "string",
  "txVersion": "string",
  "metadata": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get all the network information needed to construct a transaction offline and the version of metadata specified in `metadataVersion`.

GET

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

Returns all the materials necessary for constructing any signed transactions offline.

Parameters

metadataVersionstringrequiredpath

The version of metadata. The input is expected in a vX format, where X represents the version number (e.g. v14, v15). By default, metadata is outputted in 'json' format, unless the metadata query parameter is provided, in which case it can be either in 'json' or 'scale' format.

atstring<unsignedInteger or $hex>query

Block at which to retrieve the transaction construction material.

metadatastringquery

Specifies the format of the metadata to be returned. Accepted values are 'json', and 'scale'. 'json' being the decoded metadata, and 'scale' being the SCALE encoded metadata.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get all the network information needed to construct a transaction offline and the version of metadata specified in `metadataVersion`.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "genesisHash": "string",
  "chainName": "string",
  "specName": "string",
  "specVersion": "string",
  "txVersion": "string",
  "metadata": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

coretime

Coretime system information

Get coretime info

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/coretime/info'

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

const data = await response.json();

import requests

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

200

{}

Get coretime leases

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/coretime/leases'

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

const data = await response.json();

import requests

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

200

{}

Get coretime overview

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/coretime/overview'

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

const data = await response.json();

import requests

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

200

{}

Get coretime regions

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/coretime/regions'

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

const data = await response.json();

import requests

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

200

{}

Get coretime potential renewals

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/coretime/renewals'

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

const data = await response.json();

import requests

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

200

{}

Get coretime reservations

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/coretime/reservations'

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

const data = await response.json();

import requests

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

200

{}

Get all the leases currently registered on coretime chain.

GET

https://ksm-assethub.nownodes.io/coretime/leases

Parameters

blockIdstringquery

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get all the leases currently registered on coretime chain.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "leases": [
    {
      "task": "string",
      "until": "string",
      "core": "string"
    }
  ]
}

Get all the regions currently registered on coretime chain.

GET

https://ksm-assethub.nownodes.io/coretime/regions

Parameters

blockIdstringquery

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get all the regions currently registered on coretime chain.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "regions": [
    {
      "core": "string",
      "begin": "string",
      "end": "string",
      "owner": "string",
      "paid": "string",
      "mask": "string"
    }
  ]
}

Get all the potential renewals currently registered on coretime chain.

GET

https://ksm-assethub.nownodes.io/coretime/renewals

Parameters

blockIdstringquery

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get all the potential renewals currently registered on coretime chain.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "renewals": [
    {
      "completion": "string",
      "core": "string",
      "mask": "string",
      "price": "string",
      "task": "string",
      "when": "string"
    }
  ]
}

Get all the reservations currently registered on coretime chain.

GET

https://ksm-assethub.nownodes.io/coretime/reservations

Parameters

blockIdstringquery

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get all the reservations currently registered on coretime chain.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "reservations": [
    {
      "task": "string",
      "mask": "string"
    }
  ]
}

Get the generic information about coretime, either on coretime chain or relay chain.

GET

https://ksm-assethub.nownodes.io/coretime/info

Parameters

blockIdstringquery

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get the generic information about coretime, either on coretime chain or relay chain.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "configuration": {
    "interludeLength": "string",
    "leadinLength": "string",
    "regionLength": "string",
    "relayBlocksPerTimeslice": "string"
  },
  "currentRegion": {
    "start": "string",
    "end": "string"
  },
  "cores": {
    "total": "string",
    "available": "string",
    "sold": "string",
    "currentCorePrice": "string",
    "selloutPrice": "string",
    "firstCore": "string"
  }
}

Get all the cores information either on coretime chain or relay chain.

GET

https://ksm-assethub.nownodes.io/coretime/overview

Parameters

blockIdstringquery

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get all the cores information either on coretime chain or relay chain.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "cores": [
    {
      "coreId": "string",
      "paraId": "string",
      "workload": {
        "isPool": true,
        "isTask": true,
        "mask": "string",
        "task": "string"
      },
      "workplan": [
        {
          "core": "string",
          "timeslice": "string",
          "info": [
            {
              "isPool": true,
              "isTask": true,
              "mask": "string",
              "task": "string"
            }
          ]
        }
      ],
      "type": {
        "condition": "string",
        "details": "string"
      },
      "regions": [
        {
          "core": "string",
          "begin": "string",
          "end": "string",
          "owner": "string",
          "paid": "string",
          "mask": "string"
        }
      ]
    }
  ]
}

paras

Parachain inclusion data

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/paras/{number}/inclusion'

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

const data = await response.json();

import requests

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

200

{}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] List all registered paras (parathreads & parachains).

GET

https://ksm-assethub.nownodes.io/paras

Returns all registered parachains and parathreads with lifecycle info.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve paras list at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] List all registered paras (parathreads & parachains).

curl -X GET 'https://ksm-assethub.nownodes.io/paras'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "paras": [
    {
      "paraId": "string",
      "paraLifecycle": "onboarding",
      "onboardingAs": "parachain"
    }
  ]
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get general information about the current lease period.

GET

https://ksm-assethub.nownodes.io/paras/leases/current

Returns an overview of the current lease period, including lease holders.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve current lease period info at.

currentLeaseHoldersbooleantruequery

Wether or not to include the currentLeaseHolders property. Inclusion of the property will likely result in a larger payload and increased response time.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get general information about the current lease period.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/leases/current'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/leases/current', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/leases/current')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "leasePeriodIndex": "string",
  "endOfLeasePeriod": "string",
  "currentLeaseHolders": [
    "string"
  ]
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the status of the current auction.

GET

https://ksm-assethub.nownodes.io/paras/auctions/current

Returns an overview of the current auction. There is only one auction at a time. If there is no auction most fields will be null. If the current auction phase is in vrfDelay and you are looking to retrieve the latest winning bids, it is advised to query one block before finishEnd in the endingPeriod phase for that auction as there technically are no winners during the vrfDelay and thus the field is null.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve auction progress at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the status of the current auction.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/auctions/current'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/auctions/current', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/auctions/current')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "beginEnd": "string",
  "finishEnd": "string",
  "phase": "startPeriod",
  "auctionIndex": "string",
  "leasePeriods": [
    "string"
  ],
  "winning": [
    {
      "bid": {
        "accountId": "string",
        "paraId": "string",
        "amount": "string"
      },
      "leaseSet": [
        "string"
      ]
    }
  ]
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] List all stored crowdloans.

GET

https://ksm-assethub.nownodes.io/paras/crowdloans

Returns a list of all the crowdloans and their associated paraIds.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the list of paraIds that have crowdloans at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] List all stored crowdloans.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/crowdloans'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/crowdloans', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/crowdloans')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "funds": [
    {
      "paraId": "string",
      "fundInfo": {
        "depositor": "string",
        "verifier": "string",
        "deposit": "string",
        "raised": "string",
        "end": "string",
        "cap": "string",
        "lastConstribution": "preEnding",
        "firstPeriod": "string",
        "lastPeriod": "string",
        "trieIndex": "string"
      }
    }
  ]
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get crowdloan information for a `paraId`.

GET

https://ksm-assethub.nownodes.io/paras/{paraId}/crowdloan-info

Returns crowdloan's fundInfo and the set of leasePeriods the crowdloan` covers.

Parameters

paraIdnumberrequiredpath

paraId to query the crowdloan information of.

atstring<unsignedInteger or $hex>query

Block at which to retrieve info at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get crowdloan information for a `paraId`.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/{paraId}/crowdloan-info'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/{paraId}/crowdloan-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/{paraId}/crowdloan-info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "fundInfo": {
    "depositor": "string",
    "verifier": "string",
    "deposit": "string",
    "raised": "string",
    "end": "string",
    "cap": "string",
    "lastConstribution": "preEnding",
    "firstPeriod": "string",
    "lastPeriod": "string",
    "trieIndex": "string"
  },
  "leasePeriods": [
    "string"
  ]
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get current and future leases as well as the lifecycle stage for a given `paraId`.

GET

https://ksm-assethub.nownodes.io/paras/{paraId}/lease-info

Returns a list of leases that belong to the paraId as well as the paraId's current lifecycle stage.

Parameters

paraIdnumberrequiredpath

paraId to query the crowdloan information of.

atstring<unsignedInteger or $hex>query

Block at which to retrieve para's leases at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get current and future leases as well as the lifecycle stage for a given `paraId`.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/{paraId}/lease-info'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/{paraId}/lease-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/{paraId}/lease-info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "paraLifecycle": "onboarding",
  "onboardingAs": "parachain",
  "leases": [
    {
      "leasePeriodIndex": "string",
      "account": "string",
      "deposit": "string"
    }
  ]
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the heads of the included (backed and considered available) parachain candidates at the specified block height or at the most recent finalized head otherwise.

GET

https://ksm-assethub.nownodes.io/paras/head/included-candidates

Returns an object with all the parachain id's as keys, and their headers as values.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve para's heads at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the heads of the included (backed and considered available) parachain candidates at the specified block height or at the most recent finalized head otherwise.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/head/included-candidates'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/head/included-candidates', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/head/included-candidates')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "paraId": {
    "hash": "string",
    "number": "string",
    "parentHash": "string",
    "stateRoot": "string",
    "extrinsicsRoot": "string",
    "digest": {
      "logs": [
        {
          "type": "string",
          "index": "string",
          "value": [
            "string"
          ]
        }
      ]
    }
  }
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the heads of the backed parachain candidates at the specified block height or at the most recent finalized head otherwise.

GET

https://ksm-assethub.nownodes.io/paras/head/backed-candidates

Returns an object with all the parachain id's as keys, and their headers as values.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve para's heads at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the heads of the backed parachain candidates at the specified block height or at the most recent finalized head otherwise.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/head/backed-candidates'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/head/backed-candidates', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/head/backed-candidates')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "paraId": {
    "hash": "string",
    "number": "string",
    "parentHash": "string",
    "stateRoot": "string",
    "extrinsicsRoot": "string",
    "digest": {
      "logs": [
        {
          "type": "string",
          "index": "string",
          "value": [
            "string"
          ]
        }
      ]
    }
  }
}

ahm

Asset Hub Migration information

Asset Hub Migration info

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/ahm-info'

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

const data = await response.json();

import requests

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

200

{}

capabilities

API capabilities and chain pallets

API capabilities

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/capabilities'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/balance-info'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/proxy-info'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-info'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-payouts'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/vesting-info'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/blocks'

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

const data = await response.json();

import requests

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

200

{}

RC get head block

GET

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

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

const data = await response.json();

import requests

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

200

{}

RC get head block header

GET

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

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

const data = await response.json();

import requests

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

200

{}

RC get block by ID

GET

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

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

const data = await response.json();

import requests

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

200

{}

RC get raw extrinsics

GET

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

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

const data = await response.json();

import requests

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

200

{}

RC get extrinsic by index

GET

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

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

const data = await response.json();

import requests

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

200

{}

RC get block header

GET

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

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

const data = await response.json();

import requests

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

200

{}

RC get parachain inclusions

GET

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

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

const data = await response.json();

import requests

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

200

{}

RC get node network

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/node/network'

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

const data = await response.json();

import requests

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

200

{}

RC get transaction pool

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/node/transaction-pool'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/node/version'

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

const data = await response.json();

import requests

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

200

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

RC on-going referenda

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/on-going-referenda'

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

const data = await response.json();

import requests

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

200

{}

RC staking progress

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/staking/progress'

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

const data = await response.json();

import requests

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

200

{}

RC staking validators

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/staking/validators'

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

const data = await response.json();

import requests

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

200

{}

RC pallet constants

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts'

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

const data = await response.json();

import requests

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

200

{}

RC pallet constant value

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}'

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

const data = await response.json();

import requests

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

200

{}

RC pallet dispatchables

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables'

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

const data = await response.json();

import requests

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

200

{}

RC pallet dispatchable details

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}'

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

const data = await response.json();

import requests

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

200

{}

RC pallet errors

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors'

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

const data = await response.json();

import requests

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

200

{}

RC pallet error details

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}'

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

const data = await response.json();

import requests

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

200

{}

RC pallet events

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/events'

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

const data = await response.json();

import requests

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

200

{}

RC pallet event details

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}'

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

const data = await response.json();

import requests

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

200

{}

RC pallet storage items

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage'

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

const data = await response.json();

import requests

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

200

{}

RC pallet storage item value

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}'

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

const data = await response.json();

import requests

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

200

{}

RC get runtime code

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/runtime/code'

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

const data = await response.json();

import requests

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

200

{}

RC get runtime metadata

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/runtime/metadata'

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

const data = await response.json();

import requests

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

200

{}

RC get metadata versions

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/runtime/metadata/versions'

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

const data = await response.json();

import requests

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

200

{}

RC get metadata by version

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/runtime/metadata/{version}'

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

const data = await response.json();

import requests

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

200

{}

RC get runtime spec

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/runtime/spec'

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

const data = await response.json();

import requests

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

200

{}

Submit transaction (relay chain)

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction', json=payload)
data = response.json()

Request Body

{}

200

{}

RC dry run transaction

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/dry-run' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/dry-run', json=payload)
data = response.json()

Request Body

{}

200

{}

RC fee estimate

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/fee-estimate' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/material'

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

const data = await response.json();

import requests

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

200

{}

RC transaction material versioned

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/material/{metadataVersion}'

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

const data = await response.json();

import requests

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

200

{}

RC metadata blob

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/metadata-blob' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/metadata-blob', json=payload)
data = response.json()

Request Body

{}

200

{}

Parse transaction (relay chain)

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/parse' \
  -H 'Content-Type: application/json' \
  -d '{
    "tx": "0x4902840004316d995f..."
  }'

const response = await fetch('https://ksm-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://ksm-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"
}

contracts

Query an !Ink contract with a given message (method).

POST

https://ksm-assethub.nownodes.io/contracts/ink/{address}/query

Will return a valid or invalid result.

Body

application/json

Metadata used to instantiate a ContractPromise. This metadata can be generated by compiling the contract you are querying.

ContractMetadata

Parameters

addressstringrequiredpath

SS58 or Hex address of the account associated with the contract.

methodstringgetquery

The message or method used to query.

gasLimitnumber-1query

The gas limit to be used as an option for the queried message.

storageDepositLimitnumbernullquery

The storage deposit limit to be used as an option for the queried message.

argsArray<string>query

Abi params used as args specified in the metadata to be passed into a query. The format to use this query param is ?args[]=1&args[]=2&args[]=3.

Response

200OK

succesful operation

400Bad Request

Invalid Method

Authorization

api-keyAuthapiKey in header

Query an !Ink contract with a given message (method).

curl -X POST 'https://ksm-assethub.nownodes.io/contracts/ink/{address}/query' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-assethub.nownodes.io/contracts/ink/{address}/query', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://ksm-assethub.nownodes.io/contracts/ink/{address}/query', json=payload)
data = response.json()

Request Body

{}

{
  "debugMessage": "string",
  "gasConsumed": "string",
  "gasRequired": "string",
  "output": true,
  "result": {},
  "storageDeposit": {}
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

trace

[Experimental - subject to breaking change.] Get traces for the most recently finalized block.

GET

https://ksm-assethub.nownodes.io/experimental/blocks/head/traces

Returns traces (spans and events) of the most recently finalized block from RPC state_straceBlock. Consult the RPC docs for conceptual info.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[Experimental - subject to breaking change.] Get traces for the most recently finalized block.

curl -X GET 'https://ksm-assethub.nownodes.io/experimental/blocks/head/traces'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/experimental/blocks/head/traces')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "blockHash": "string",
  "events": [
    {
      "data": {
        "stringValues": {
          "key": "string",
          "method": "string",
          "result": "string"
        }
      },
      "parentId": "string",
      "target": "string"
    }
  ],
  "parentHash": "string",
  "spans": [
    {
      "id": "string",
      "name": "string",
      "parentId": "string",
      "target": "string",
      "wasm": true
    }
  ],
  "storageKeys": "string",
  "tracingTargets": "string"
}

[Experimental - subject to breaking change.] Get traces for the given `blockId`.

GET

https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces

Returns traces (spans and events) of the specified block from RPC state_straceBlock. Consult the RPC docs for conceptual info.

Parameters

blockIdstringrequiredpath

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[Experimental - subject to breaking change.] Get traces for the given `blockId`.

curl -X GET 'https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces'

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "blockHash": "string",
  "events": [
    {
      "data": {
        "stringValues": {
          "key": "string",
          "method": "string",
          "result": "string"
        }
      },
      "parentId": "string",
      "target": "string"
    }
  ],
  "parentHash": "string",
  "spans": [
    {
      "id": "string",
      "name": "string",
      "parentId": "string",
      "target": "string",
      "wasm": true
    }
  ],
  "storageKeys": "string",
  "tracingTargets": "string"
}

[Experimental - subject to breaking change.] Get the operations from the most recently finalized block.

GET

https://ksm-assethub.nownodes.io/experimental/blocks/head/traces/operations

Returns the operations from the most recently finalized block. Operations represent one side of a balance change. For example if Alice transfers 100unit to Bob there will be two operations; 1) Alice - 100 2) Bob + 100.

Given account A and A's balance at block k0 (Ak0), if we sum all the operations for A from block k1 through kn against Ak0, we will end up with A's balance at block kn (Akn). Thus, operations can be used to audit that balances change as expected.

This is useful for Substrate based chains because the advanced business logic can make it difficult to ensure auditable balance reconciliation based purely on events. Instead of using events one can use the operations given from this endpoint.

Note - each operation corresponds to a delta of a single field of the system::AccountData storage item (i.e free, reserved, misc_frozen and fee_frozen). Note - operations are assigned a block execution phase (and extrinsic index for those in the apply extrinsic phase) based on an "action group". For example all the operations for 1 extrinsic will be in the same action group. The action groups can optionally be fetched with the action query param for closer auditing. Note - There are no 0 value operations (e.g. a transfer of 0, or a transfer to itself)

To learn more about operation and action group creation please consult this diagram

Parameters

actionsbooleanfalsequery

Whether or not to include action groups.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[Experimental - subject to breaking change.] Get the operations from the most recently finalized block.

curl -X GET 'https://ksm-assethub.nownodes.io/experimental/blocks/head/traces/operations'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/experimental/blocks/head/traces/operations')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "operations": [
    {
      "phase": {
        "variant": "onInitialize",
        "extrinsicIndex": "string"
      },
      "parentSpanId": {
        "name": "string",
        "target": "string",
        "id": "string"
      },
      "primarySpanId": {
        "name": "string",
        "target": "string",
        "id": "string"
      },
      "eventIndex": "string",
      "address": "string",
      "storage": {
        "pallet": "string",
        "item": "string",
        "field1": "string",
        "field2": "string"
      },
      "amount": {
        "values": "string",
        "currency": {
          "symbol": "KSM"
        }
      }
    }
  ]
}

[Experimental - subject to breaking change.] Get the operations from the specified block.

GET

https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces/operations

To learn more about operation and action group creation please consult this diagram

Parameters

blockIdstringrequiredpath

Block identifier, as the block height or block hash.

actionsbooleanfalsequery

Whether or not to include action groups.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[Experimental - subject to breaking change.] Get the operations from the specified block.

curl -X GET 'https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces/operations'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces/operations')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "operations": [
    {
      "phase": {
        "variant": "onInitialize",
        "extrinsicIndex": "string"
      },
      "parentSpanId": {
        "name": "string",
        "target": "string",
        "id": "string"
      },
      "primarySpanId": {
        "name": "string",
        "target": "string",
        "id": "string"
      },
      "eventIndex": "string",
      "address": "string",
      "storage": {
        "pallet": "string",
        "item": "string",
        "field1": "string",
        "field2": "string"
      },
      "amount": {
        "values": "string",
        "currency": {
          "symbol": "KSM"
        }
      }
    }
  ]
}

staking

Get staking information for a Stash account.

GET

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

Returns information about a Stash account's staking activity. Replaces /staking/{address} from versions < v1.0.0. The Stash account can be either a validator or nominator account.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account. Must be a Stash account.

atstring<unsignedInteger or $hex>query

Block at which to query the staking info for the specified account.

includeClaimedRewardsstring<boolean>truequery

When set to false, the claimedRewards field is not included in the response.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

account not found

Authorization

api-keyAuthapiKey in header

Get staking information for a _Stash_ account.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get payout information for a Stash account.

GET

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

Returns payout information for the last specified eras. If specifying both the depth and era query params, this endpoint will return information for (era - depth) through era. (i.e. if depth=5 and era=20 information will be returned for eras 16 through 20). N.B. You cannot query eras less then current_era - HISTORY_DEPTH. N.B. The nominator* fields correspond to the address being queried, even if it is a validator's Stash address. This is because a validator is technically nominating itself.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account. Must be a Stash account.

atstring<unsignedInteger or $hex>query

Block at which to query staking payouts.

depthstring<unsignedInteger>1query

The number of eras to query for payouts of. Must be less than or equal to HISTORY_DEPTH. In cases where era - (depth -1) is less than 0, the first era queried will be 0.

erastring<unsignedInteger>`active_era - 1`query

The era to query at.

unclaimedOnlystring<boolean>truequery

Only return unclaimed rewards.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

account not found

Authorization

api-keyAuthapiKey in header

Get payout information for a _Stash_ account.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get progress on the general Staking pallet system.

GET

https://ksm-assethub.nownodes.io/pallets/staking/progress

Returns information on the progress of key components of the staking system and estimates of future points of interest. Replaces /staking-info from versions < v1.0.0.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve a staking progress report.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get progress on the general Staking pallet system.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "activeEra": "string",
  "forceEra": "ForceNone",
  "nextActiveEraEstimate": "string",
  "nextSessionEstimate": "string",
  "unappliedSlashes": [
    {
      "validator": "string",
      "own": "string",
      "others": [
        "string"
      ],
      "reporters": [
        "string"
      ],
      "payout": "string"
    }
  ],
  "electionStatus": {
    "status": {},
    "toggleEstimate": "string"
  },
  "idealValidatorCount": "string",
  "validatorSet": [
    "string"
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get all validators (active/waiting) of a specific chain.

GET

https://ksm-assethub.nownodes.io/pallets/staking/validators

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the list of validators.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get all validators (active/waiting) of a specific chain.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "validators": [
    {
      "address": "string",
      "status": "string"
    }
  ],
  "validatorsToBeChilled": [
    {
      "address": "string",
      "status": "string"
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

NODE

author

Submit a fully formatted extrinsic

POST

https://ksm-assethub.nownodes.io/author_submitExtrinsic

Sends a fully formatted extrinsic to the chain for processing.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing the encoded extrinsic

Response

200OK

Extrinsic submission result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Submit a fully formatted extrinsic

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_submitExtrinsic",
  "params": [
    "0x...extrinsic"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_submitExtrinsic",
  "params": [
    "0x...extrinsic"
  ]
}

200

{
  "jsonrpc": "2.0",
  "error": {
    "code": 1002,
    "message": "Verification Error: invalid signature"
  },
  "id": "test"
}

Submit and subscribe to an extrinsic until unsubscribed

POST

https://ksm-assethub.nownodes.io/author_submitAndWatchExtrinsic

Submits an extrinsic and allows monitoring its status until it is finalized or unsubscribed.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing the encoded extrinsic

Response

200OK

Extrinsic submission and watch result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Submit and subscribe to an extrinsic until unsubscribed

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_submitAndWatchExtrinsic",
  "params": [
    "0x290284ffdc3488a..."
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "author_submitAndWatchExtrinsic",
  "params": [
    "0x290284ffdc3488a..."
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "extrinsicHash": "0x123456789abcdef...7890",
    "status": {
      "Finalized": "0xabc123blockhash..."
    }
  },
  "id": "test"
}

Retrieve all pending extrinsics

POST

https://ksm-assethub.nownodes.io/author_pendingExtrinsics

Returns a list of all pending extrinsics, optionally grouped by sender.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

No parameters required

Response

200OK

List of pending extrinsics

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve all pending extrinsics

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "result": [
    "0x5d028400bc47b8533..."
  ],
  "id": "test"
}

chain

Get the hash of the last finalized block

POST

https://ksm-assethub.nownodes.io/chain_getFinalizedHead

Returns the hash of the block that was finalized on the chain.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

Method parameters (empty array)

Response

200OK

Hash of the last finalized block

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get the hash of the last finalized block

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "result": "0xb0e62ed11652d7562cb63598140c5eb7ac4f2086f0970334ce8472d403c66e1f",
  "id": "test"
}

Get block by hash

POST

https://ksm-assethub.nownodes.io/chain_getBlock

Returns full information of a block, including header, extrinsics, and digest.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing block hash to retrieve

Response

200OK

Full block details

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block by hash

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getBlock",
  "params": [
    "0x451c44b3009ba7a7a005f38c2cae2be4c2be56535f99f8dfac08995872666a44"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "block": {
      "header": {
        "parentHash": "0xd1b678077a900e1b03747ba5ade6c47960fe7ead346c8722289dbc3d9f1c9dc9",
        "number": "0x160303a",
        "stateRoot": "0x53e1c568f798214ff4406c8db027e4e05a1bc30c486ed391ebd0263ce74f3dc2",
        "extrinsicsRoot": "0xa4afa163cf63cc5851f7af044db5d25bc0229aa44645aadb1d98f9ec87f5ce63",
        "digest": {
          "logs": []
        }
      },
      "extrinsics": []
    },
    "justifications": null
  },
  "id": "test"
}

Get block hash by block number

POST

https://ksm-assethub.nownodes.io/chain_getBlockHash

Returns the block hash using the block number in the chain.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<integer>required

Array containing block number

Response

200OK

Block hash by block number

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block hash by block number

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getBlockHash",
  "params": [
    20440517
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "chain_getBlockHash",
  "params": [
    20440517
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0x1e2dc73f800f496f8fc2e1ab3e8b8037267546cf24198b0c6e5a7b87e8b38320",
  "id": "test"
}

payment

Retrieve fee information for an encoded extrinsic

POST

https://ksm-assethub.nownodes.io/payment_queryInfo

Returns detailed fee information (weight, partial fee, etc.) for a given encoded extrinsic.

Body

application/json

JSON-RPC request containing encoded extrinsic

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing encoded extrinsic(s) to query fee info for

Response

200OK

Fee information for the extrinsic

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve fee information for an encoded extrinsic

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "payment_queryInfo",
  "params": [
    "0x290284ffdc3488a..."
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "payment_queryInfo",
  "params": [
    "0x290284ffdc3488a..."
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "weight": 12345678,
    "partialFee": "1000000000000"
  },
  "id": "test"
}

state

Retrieve storage for a given key

POST

https://ksm-assethub.nownodes.io/state_getStorage

Returns the value stored under a specific key at the latest block or a given block.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<string>required

Array containing storage keys

Response

200OK

Returns the value stored at the specified key

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve storage for a given key

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorage",
  "params": [
    "StorageKey"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorage",
  "params": [
    "StorageKey"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0xf08af92e88010000",
  "id": "test"
}

Get the runtime version

POST

https://ksm-assethub.nownodes.io/state_getRuntimeVersion

Returns version information about the runtime, including spec version, implementation version, and transaction version.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

No parameters required

Response

200OK

Runtime version information

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get the runtime version

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "result": {
    "specName": "kusama",
    "implName": "parity-kusama",
    "authoringVersion": 2,
    "specVersion": 1002000,
    "implVersion": 0,
    "transactionVersion": 25,
    "stateVersion": 1
  },
  "id": "test"
}

Retrieve runtime metadata

POST

https://ksm-assethub.nownodes.io/state_getMetadata

Returns the runtime metadata, which includes information about modules, calls, storage, and events.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

No parameters required

Response

200OK

Runtime metadata in hex format

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve runtime metadata

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "result": "0x6e74696d653e000500485472616e73616374696f6e5061796d656e74...",
  "id": "test"
}

Returns proof of storage entries at a specific block state

POST

https://ksm-assethub.nownodes.io/state_getReadProof

Provides a cryptographic proof for the existence and content of storage entries at a given block.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

List of storage keys for which to generate proof

Response

200OK

Proof of storage entries

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Returns proof of storage entries at a specific block state

curl -X POST 'https://ksm-assethub.nownodes.io/state_getReadProof' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "state_getReadProof",
    "params": [
      "keys: Vec<StorageKey>"
    ]
  }'

const response = await fetch('https://ksm-assethub.nownodes.io/state_getReadProof', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": "test",
      "method": "state_getReadProof",
      "params": [
        "keys: Vec<StorageKey>"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getReadProof",
  "params": [
    "keys: Vec<StorageKey>"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getReadProof",
  "params": [
    "keys: Vec<StorageKey>"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "at": "0xabc123blockhash...",
    "proof": [
      "0xproofdata1...",
      "0xproofdata2..."
    ]
  },
  "id": "test"
}

Retrieves the storage hash

POST

https://ksm-assethub.nownodes.io/state_getStorageHash

Returns the hash of the storage value stored under a specific key.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

idstringrequired

methodstringrequired

paramsArray<any>required

Storage key(s) to compute hash

Response

200OK

Storage hash result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieves the storage hash

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorageHash",
  "params": [
    "StorageKey"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorageHash",
  "params": [
    "StorageKey"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0xabc123def4567890...",
  "id": "test"
}

Retrieves the storage size

POST

https://ksm-assethub.nownodes.io/state_getStorageSize

Returns the size in bytes of the storage value under a specific key.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

idstringrequired

methodstringrequired

paramsArray<any>required

Storage key(s) to measure

Response

200OK

Storage size result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieves the storage size

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorageSize",
  "params": [
    "StorageKey"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_getStorageSize",
  "params": [
    "StorageKey"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": "0x0000000000000032",
  "id": "test"
}

Query historical storage entries

POST

https://ksm-assethub.nownodes.io/state_queryStorage

Returns the storage changes between two blocks for a set of keys.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

idstringrequired

methodstringrequired

paramsArray<any>required

List of storage keys and block range

Response

200OK

Query storage result

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Query historical storage entries

curl -X POST 'https://ksm-assethub.nownodes.io/state_queryStorage' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "state_queryStorage",
    "params": [
      "StorageKeys",
      "fromBlock",
      "toBlock"
    ]
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_queryStorage",
  "params": [
    "StorageKeys",
    "fromBlock",
    "toBlock"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_queryStorage",
  "params": [
    "StorageKeys",
    "fromBlock",
    "toBlock"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "block": "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4",
    "changes": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7",
        "0x0000000000000000000000000000000000000000000000000000000000000000"
      ]
    ]
  },
  "id": "test"
}

Query storage entries at a specific block

POST

https://ksm-assethub.nownodes.io/state_queryStorageAt

Returns the storage values for given keys at a specified block hash.

Body

application/json

JSON-RPC request parameters

jsonrpcstringrequired

idstringrequired

methodstringrequired

paramsArray<any>required

List of storage keys and block hash

Response

200OK

Storage entries at block

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Query storage entries at a specific block

curl -X POST 'https://ksm-assethub.nownodes.io/state_queryStorageAt' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "test",
    "method": "state_queryStorageAt",
    "params": [
      "StorageKeys",
      "fromBlock"
    ]
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_queryStorageAt",
  "params": [
    "StorageKeys",
    "fromBlock"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": "test",
  "method": "state_queryStorageAt",
  "params": [
    "StorageKeys",
    "fromBlock"
  ]
}

200

{
  "jsonrpc": "2.0",
  "result": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7",
      "0x0000000000000000000000000000000000000000000000000000000000000000"
    ]
  ],
  "id": "test"
}

system

Retrieve the name of the chain

POST

https://ksm-assethub.nownodes.io/system_chain

Returns the network name (e.g., Kusama, Polkadot) the node is connected to.

Body

application/json

JSON-RPC request to get chain name

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

Should be empty for this method

Response

200OK

Chain name

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve the name of the chain

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "result": "Kusama",
  "id": "test"
}

Retrieve custom properties from chain spec

POST

https://ksm-assethub.nownodes.io/system_properties

Returns chain-specific properties such as token symbol, decimals, and address format.

Body

application/json

JSON-RPC request to get system properties

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

Method name

paramsArray<any>required

Should be empty for this method

Response

200OK

System properties of the chain

400Bad Request

Malformed address or application ID

401Unauthorized

Invalid API key

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Retrieve custom properties from chain spec

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "result": {
    "ss58Format": 2,
    "tokenDecimals": 12,
    "tokenSymbol": "KSM"
  },
  "id": "test"
}

health

Health check

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/health'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/node/network'

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

const data = await response.json();

import requests

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

200

{}

Transaction pool

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/node/transaction-pool'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/node/version'

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

const data = await response.json();

import requests

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

200

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

Get information about the Substrate node's activity in the peer-to-peer network.

GET

https://ksm-assethub.nownodes.io/node/network

Returns network related information of the node.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information about the Substrate node's activity in the peer-to-peer network.

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

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

const data = await response.json();

import requests

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

200

{
  "nodeRoles": "Full",
  "numPeers": "string",
  "isSyncing": true,
  "shouldHavePeers": true,
  "localPeerId": "string",
  "localListenAddresses": [
    "string"
  ],
  "peersInfo": [
    {
      "peerId": "string",
      "roles": "string",
      "protocolVersion": "string",
      "bestHash": "string",
      "bestNumber": "string"
    }
  ]
}

Get pending extrinsics from the Substrate node.

GET

https://ksm-assethub.nownodes.io/node/transaction-pool

Returns the extrinsics that the node knows of that have not been included in a block.

Parameters

includeFeebooleanfalsequery

Boolean representing whether or not to include tips, partialFee, and priority in each extrinsic.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get pending extrinsics from the Substrate node.

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

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

const data = await response.json();

import requests

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

200

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

Get information about the Substrates node's implementation and versioning.

GET

https://ksm-assethub.nownodes.io/node/version

Returns versioning information of the node.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information about the Substrates node's implementation and versioning.

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

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

const data = await response.json();

import requests

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

200

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

version

API version

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/version'

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

const data = await response.json();

import requests

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

200

{
  "version": "string"
}

blocks

Block queries and extrinsic data

Get blocks by range

GET

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

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

const data = await response.json();

import requests

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

200

[
  {}
]

Get latest block

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get head block header

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get block by ID

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get raw extrinsics

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get extrinsic by index

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get block header by ID

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get parachain inclusions

GET

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

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

const data = await response.json();

import requests

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

200

{}

Get a range of blocks by their height.

GET

https://ksm-assethub.nownodes.io/blocks

Given a range query parameter return an array of all the blocks within that range.

Parameters

rangestringrequiredquery

A range of integers. There is a max limit of 500 blocks per request.

eventDocsbooleanfalsequery

When set to true, every event will have an extra docs property with a string of the events documentation.

extrinsicDocsbooleanfalsequery

When set to true, every extrinsic will have an extra docs property with a string of the extrinsics documentation.

noFeesbooleanfalsequery

When set to true, the fee won't be calculated for the extrinsics.

Response

200OK

successful operation

400Bad Request

invalid Block identifier supplied

Authorization

api-keyAuthapiKey in header

Get a range of blocks by their height.

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

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

const data = await response.json();

import requests

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

[
  {
    "number": "string",
    "hash": "string",
    "parentHash": "string",
    "stateRoot": "string",
    "extrinsicRoot": "string",
    "authorId": "string",
    "logs": [
      {
        "type": "string",
        "index": "string",
        "value": [
          "string"
        ]
      }
    ],
    "onInitialize": {
      "events": [
        {
          "method": "string",
          "data": [
            "string"
          ]
        }
      ]
    },
    "extrinsics": [
      {
        "method": {
          "pallet": "string",
          "method": "string"
        },
        "signature": {
          "signature": "string",
          "signer": "string"
        },
        "nonce": "string",
        "args": {},
        "tip": "string",
        "hash": "string",
        "info": {
          "weight": {
            "refTime": "string",
            "proofSize": "string"
          },
          "class": "Normal",
          "partialFee": "string",
          "kind": "string"
        },
        "era": "{\"mortalEra\":[\"64\", \"11\"]}",
        "events": [
          {
            "method": "string",
            "data": [
              "string"
            ]
          }
        ],
        "success": true,
        "paysFee": true
      }
    ],
    "onFinalize": {
      "events": [
        {
          "method": "string",
          "data": [
            "string"
          ]
        }
      ]
    },
    "finalized": true
  }
]

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get a block by its height or hash.

GET

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

Returns a single block. BlockId can either be a block hash or a block height. Replaces /block/{number} from versions < v1.0.0.

Parameters

blockIdstringrequiredpath

Block identifier, as the block height or block hash.

eventDocsbooleanfalsequery

When set to true, every event will have an extra docs property with a string of the events documentation.

extrinsicDocsbooleanfalsequery

When set to true, every extrinsic will have an extra docs property with a string of the extrinsics documentation.

noFeesbooleanfalsequery

When set to true, the fee won't be calculated for the extrinsics.

finalizedKeybooleanquery

When set to false, this will override the chain-config, and omit the finalized key in the response. This can increase performance slightly by avoiding an additional RPC call to the node.

decodedXcmMsgsbooleanfalsequery

When set to true, this will show the decoded XCM messages within the extrinsics of the requested block.

paraIdstringquery

Response

200OK

successful operation

400Bad Request

invalid Block identifier supplied

Authorization

api-keyAuthapiKey in header

Get a block by its height or hash.

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

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

const data = await response.json();

import requests

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

{
  "number": "string",
  "hash": "string",
  "parentHash": "string",
  "stateRoot": "string",
  "extrinsicRoot": "string",
  "authorId": "string",
  "logs": [
    {
      "type": "string",
      "index": "string",
      "value": [
        "string"
      ]
    }
  ],
  "onInitialize": {
    "events": [
      {
        "method": "string",
        "data": [
          "string"
        ]
      }
    ]
  },
  "extrinsics": [
    {
      "method": {
        "pallet": "string",
        "method": "string"
      },
      "signature": {
        "signature": "string",
        "signer": "string"
      },
      "nonce": "string",
      "args": {},
      "tip": "string",
      "hash": "string",
      "info": {
        "weight": {
          "refTime": "string",
          "proofSize": "string"
        },
        "class": "Normal",
        "partialFee": "string",
        "kind": "string"
      },
      "era": "{\"mortalEra\":[\"64\", \"11\"]}",
      "events": [
        {
          "method": "string",
          "data": [
            "string"
          ]
        }
      ],
      "success": true,
      "paysFee": true
    }
  ],
  "onFinalize": {
    "events": [
      {
        "method": "string",
        "data": [
          "string"
        ]
      }
    ]
  },
  "finalized": true,
  "decodedXcmMsgs": {
    "horizontalMessages": [
      {
        "originParaId": "string",
        "destinationParaId": "string",
        "data": {}
      }
    ],
    "downwardMessages": [
      {
        "sentAt": "string",
        "msg": "string",
        "data": {}
      }
    ],
    "upwardMessages": [
      {
        "originParaId": "string",
        "data": {}
      }
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

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

GET

https://ksm-assethub.nownodes.io/blocks/{blockId}/header

Returns a single block's header. BlockId can either be a block hash or a block height.

Parameters

blockIdstringrequiredpath

Block identifier, as the block height or block hash.

Response

200OK

successful operation

400Bad Request

invalid Block identifier supplied

Authorization

api-keyAuthapiKey in header

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

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

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

const data = await response.json();

import requests

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

{
  "parentHash": "string",
  "number": "string",
  "stateRoot": "string",
  "extrinsicRoot": "string",
  "digest": {
    "logs": [
      {
        "type": "string",
        "index": "string",
        "value": [
          "string"
        ]
      }
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

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

GET

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

Returns a single extrinsic.

Parameters

blockIdstringrequiredpath

Block identifier, as the block height or block hash.

extrinsicIndexstringrequiredpath

The extrinsic's index within the block's body.

eventDocsbooleanfalsequery

When set to true, every event will have an extra docs property with a string of the events documentation.

extrinsicDocsbooleanfalsequery

When set to true, every extrinsic will have an extra docs property with a string of the extrinsics documentation.

Response

200OK

successful operation

400Bad Request

Requested extrinsicIndex does not exist

Authorization

api-keyAuthapiKey in header

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

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "extrinsic": {
    "method": {
      "pallet": "string",
      "method": "string"
    },
    "signature": {
      "signature": "string",
      "signer": "string"
    },
    "nonce": "string",
    "args": {},
    "tip": "string",
    "hash": "string",
    "info": {
      "weight": {
        "refTime": "string",
        "proofSize": "string"
      },
      "class": "Normal",
      "partialFee": "string",
      "kind": "string"
    },
    "era": "{\"mortalEra\":[\"64\", \"11\"]}",
    "events": [
      {
        "method": "string",
        "data": [
          "string"
        ]
      }
    ],
    "success": true,
    "paysFee": true
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the most recently finalized block.

GET

https://ksm-assethub.nownodes.io/blocks/head

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

Parameters

finalizedbooleantruequery

eventDocsbooleanfalsequery

When set to true, every event will have an extra docs property with a string of the events documentation.

extrinsicDocsbooleanfalsequery

When set to true, every extrinsic will have an extra docs property with a string of the extrinsics documentation.

noFeesbooleanfalsequery

When set to true, the fee won't be calculated for the extrinsics.

decodedXcmMsgsbooleanfalsequery

When set to true, this will show the decoded XCM messages within the extrinsics of the requested block.

paraIdstringquery

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get the most recently finalized block.

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

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

const data = await response.json();

import requests

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

200

{
  "number": "string",
  "hash": "string",
  "parentHash": "string",
  "stateRoot": "string",
  "extrinsicRoot": "string",
  "authorId": "string",
  "logs": [
    {
      "type": "string",
      "index": "string",
      "value": [
        "string"
      ]
    }
  ],
  "onInitialize": {
    "events": [
      {
        "method": "string",
        "data": [
          "string"
        ]
      }
    ]
  },
  "extrinsics": [
    {
      "method": {
        "pallet": "string",
        "method": "string"
      },
      "signature": {
        "signature": "string",
        "signer": "string"
      },
      "nonce": "string",
      "args": {},
      "tip": "string",
      "hash": "string",
      "info": {
        "weight": {
          "refTime": "string",
          "proofSize": "string"
        },
        "class": "Normal",
        "partialFee": "string",
        "kind": "string"
      },
      "era": "{\"mortalEra\":[\"64\", \"11\"]}",
      "events": [
        {
          "method": "string",
          "data": [
            "string"
          ]
        }
      ],
      "success": true,
      "paysFee": true
    }
  ],
  "onFinalize": {
    "events": [
      {
        "method": "string",
        "data": [
          "string"
        ]
      }
    ]
  },
  "finalized": true,
  "decodedXcmMsgs": {
    "horizontalMessages": [
      {
        "originParaId": "string",
        "destinationParaId": "string",
        "data": {}
      }
    ],
    "downwardMessages": [
      {
        "sentAt": "string",
        "msg": "string",
        "data": {}
      }
    ],
    "upwardMessages": [
      {
        "originParaId": "string",
        "data": {}
      }
    ]
  }
}

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

GET

https://ksm-assethub.nownodes.io/blocks/head/header

Returns the most recently finalized block's header.

Parameters

finalizedbooleantruequery

Response

200OK

successful operation

400Bad Request

invalid Block identifier supplied

Authorization

api-keyAuthapiKey in header

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

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

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

const data = await response.json();

import requests

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

{
  "parentHash": "string",
  "number": "string",
  "stateRoot": "string",
  "extrinsicRoot": "string",
  "digest": {
    "logs": [
      {
        "type": "string",
        "index": "string",
        "value": [
          "string"
        ]
      }
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get a blocks header & its extrinsics as hex values.

GET

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

Returns a block & its extrinsics as hex values. BlockId can either be a block hash or a block height.

Parameters

blockIdstringrequiredpath

Block identifier, as the block height or block hash.

Response

200OK

successful operation

400Bad Request

invalid Block identifier supplied

Authorization

api-keyAuthapiKey in header

Get a blocks header & its extrinsics as hex values.

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

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

const data = await response.json();

import requests

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

{
  "number": "string",
  "parentHash": "string",
  "stateRoot": "string",
  "extrinsicRoot": "string",
  "digest": {
    "logs": [
      {
        "type": "string",
        "index": "string",
        "value": [
          "string"
        ]
      }
    ]
  },
  "extrinsics": [
    "string"
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

accounts

Account balance, staking, and proxy information

Compare account addresses

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/accounts/compare'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/asset-approvals'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/asset-balances'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/balance-info'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/convert'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/foreign-asset-balances'

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

const data = await response.json();

import requests

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

200

{}

Account pool asset approvals

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-approvals'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/pool-asset-balances'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/proxy-info'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/staking-info'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/staking-payouts'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/validate'

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

const data = await response.json();

import requests

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

200

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

Account vesting info

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/accounts/{accountId}/vesting-info'

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

const data = await response.json();

import requests

response = requests.get('https://ksm-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"
    }
  ]
}

Get an array of asset-balances for an account.

GET

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

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query asset-balance info for the specified account.

assetsArray<string><Array of unsignedInteger's>query

Response

200OK

successfull operation

400Bad Request

Invalid Address

Authorization

api-keyAuthapiKey in header

Get an array of asset-balances for an account.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get an asset approval for an account.

GET

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

Returns information about an account's asset approval transaction. It is required to pass in a delegate and an assetId as query parameters.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query asset approval info for the specified account.

assetIdstring<unsignedInteger>requiredquery

The assetId associated with the asset-approval.

delegatestring<SS58>requiredquery

The delegate's accountId associated with an asset-approval.

Response

200OK

successfull operation

400Bad Request

Invalid Address

Authorization

api-keyAuthapiKey in header

Get an asset approval for an account.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "amount": "string",
  "deposit": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get balance information for an account.

GET

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

Returns information about an account's balance. Replaces /balance/{address} from versions < v1.0.0.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query balance info for the specified account.

tokenstringquery

denominatedbooleanfalsequery

When set to true it will denominate any balance's given atomic value using the chains given decimal value.

Response

200OK

successful operation

400Bad Request

Invalid Address

404Not Found

account not found

Authorization

api-keyAuthapiKey in header

Get balance information for an account.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Convert a given AccountId to an SS58 address.

GET

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

Returns the SS58 prefix, the network address format, the SS58 address, and the AccountId that was given as input parameter, the scheme that was used and if it is a public key or not (boolean).

Parameters

accountIdstring<AccountId or Hex>requiredpath

AccountId or Public Key (hex).

schemestring<string>sr25519query

prefixstring<number>42query

The address prefix which can be one of the values found in the SS58-registry.

publicKeystring<boolean>truequery

Defines if the given value in the path parameter is a Public Key (hex) or not (hence AccountId).

Response

200OK

successfully converted the AccountId and retrieved the address info.

400Bad Request

Invalid AccountId

404Not Found

AccountId not found

Authorization

api-keyAuthapiKey in header

Convert a given AccountId to an SS58 address.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get an array of pool-asset-balances for an account.

GET

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

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query pool-asset-balance info for the specified account.

assetsArray<string><Array of unsignedInteger's>query

Response

200OK

successfull operation

400Bad Request

Invalid Address

Authorization

api-keyAuthapiKey in header

Get an array of pool-asset-balances for an account.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get an asset approval for an account.

GET

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

Returns information about an account's asset approval transaction. It is required to pass in a delegate and an assetId as query parameters.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query asset approval info for the specified account.

assetIdstring<unsignedInteger>requiredquery

The assetId associated with the asset-approval.

delegatestring<SS58>requiredquery

The delegate's accountId associated with an asset-approval.

Response

200OK

successfull operation

400Bad Request

Invalid Address

Authorization

api-keyAuthapiKey in header

Get an asset approval for an account.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "amount": "string",
  "deposit": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get proxy account information.

GET

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

Returns information about a proxy account. This will include delegated accounts and deposits held.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query proxy info for the specified account.

Response

200OK

successfull operation

400Bad Request

Invalid Address

Authorization

api-keyAuthapiKey in header

Get proxy account information.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get vesting information for an account.

GET

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

Returns the vesting schedule for an account. Replaces /vesting/{address} from versions < v1.0.0.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account.

atstring<unsignedInteger or $hex>query

Block at which to query the vesting info for the specified account.

Response

200OK

successful operation

400Bad Request

Invalid Address

404Not Found

account not found

Authorization

api-keyAuthapiKey in header

Get vesting information for an account.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Validate a given address.

GET

https://ksm-assethub.nownodes.io/accounts/{address}/validate

Returns whether the given address is valid ss58 format, the ss58 prefix if the address has one, the network address format, and what the account ID is for this address.

Parameters

addressstring<SS58 or Hex>requiredpath

SS58 or Hex address of the account.

Response

200OK

successfully retrieved address info

Authorization

api-keyAuthapiKey in header

Validate a given address.

curl -X GET 'https://ksm-assethub.nownodes.io/accounts/{address}/validate'

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

const data = await response.json();

import requests

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

200

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

Compares up to 30 SS58 addresses.

GET

https://ksm-assethub.nownodes.io/accounts/compare

Returns if the given addresses are equal or not, along with details of each address. Equality is determined by comparing the accountId/publicKey of each address.

Parameters

addressesArray<string>requiredquery

Response

200OK

successfully compared at least two SS58 addresses.

400Bad Request

Invalid Address

Authorization

api-keyAuthapiKey in header

Compares up to 30 SS58 addresses.

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

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

const data = await response.json();

import requests

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

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

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

pallets

Runtime pallet metadata, storage, constants, events, errors

Liquidity pools

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/asset-conversion/liquidity-pools'

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

const data = await response.json();

import requests

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

200

{}

Next available pool ID

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/asset-conversion/next-available-id'

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

const data = await response.json();

import requests

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

200

{}

Asset info

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/assets/{assetId}/asset-info'

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

const data = await response.json();

import requests

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

200

{}

Foreign assets

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/foreign-assets'

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

const data = await response.json();

import requests

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

200

{}

Nomination pools info

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/nomination-pools/info'

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

const data = await response.json();

import requests

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

200

{}

Nomination pool details

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/nomination-pools/{poolId}'

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

const data = await response.json();

import requests

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

200

{}

On-going referenda

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/on-going-referenda'

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

const data = await response.json();

import requests

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

200

{}

Pool asset info

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/pool-assets/{assetId}/asset-info'

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

const data = await response.json();

import requests

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

200

{}

Staking progress

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/staking/progress'

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

const data = await response.json();

import requests

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

200

{}

Staking validators

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/staking/validators'

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

const data = await response.json();

import requests

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

200

{}

Pallet constants

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/consts'

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

const data = await response.json();

import requests

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

200

{}

Pallet constant value

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/consts/{constantItemId}'

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

const data = await response.json();

import requests

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

200

{}

Pallet dispatchables

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables'

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

const data = await response.json();

import requests

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

200

{}

Pallet dispatchable details

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/dispatchables/{dispatchableId}'

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

const data = await response.json();

import requests

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

200

{}

Pallet errors

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/errors'

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

const data = await response.json();

import requests

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

200

{}

Pallet error details

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/errors/{errorItemId}'

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

const data = await response.json();

import requests

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

200

{}

Get pallet events

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/events'

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

const data = await response.json();

import requests

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

200

{}

Get pallet event item

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/events/{eventItemId}'

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

const data = await response.json();

import requests

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

200

{}

Pallet storage items

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/storage'

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

const data = await response.json();

import requests

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

200

{}

Pallet storage item value

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/pallets/{palletId}/storage/{storageItemId}'

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

const data = await response.json();

import requests

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

200

{}

Get information and metadata associated with an asset.

GET

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

Returns information associated with an asset which includes the assets AssetDetails and AssetMetadata.

Parameters

assetIdstring<unsignedInteger>requiredpath

The unsignedInteger Id of an asset.

atstring<unsignedInteger or $hex>query

Block at which to retrieve the assetInfo.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information and metadata associated with an asset.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "assetInfo": {
    "owner": "string",
    "issuer": "string",
    "admin": "string",
    "freezer": "string",
    "supply": "string",
    "deposit": "string",
    "minBalance": "string",
    "isSufficient": true,
    "accounts": "string",
    "sufficients": "string",
    "approvals": "string",
    "status": "string"
  },
  "assetMetadata": {
    "deposit": "string",
    "name": "string",
    "symbol": "string",
    "decimals": "string",
    "isFrozen": true
  }
}

Get information related to existing liquidity pools.

GET

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

Returns a list of the existing liquidity pools and its corresponding tokens at a given block height. If no block is specified, it returns the latest list available.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the liquidity pools information.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get information related to existing liquidity pools.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "pools": "[{\"reserves\":[{\"parents\":\"1\",\"interior\":{\"here\": null}},{\"parents\":\"0\",\"interior\":{\"x2\":[{\"palletInstance\": \"50\"},{\"generalIndex\":\"2\"}]}}],\"lpToken\":{\"lpToken\":\"1\"} },{\"lpToken\":{\"lpToken\":\"0\"}}]"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the next available liquidity pool id.

GET

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

Returns the next available liquidity pool's id at a given block height. If no block is specified, it returns the latest list available.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the next liquidity pool's id.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get the next available liquidity pool id.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "id": "4"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get information and metadata associated with foreign assets.

GET

https://ksm-assethub.nownodes.io/pallets/foreign-assets

Returns information associated with every foreign asset which includes the assets AssetDetails and AssetMetadata.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the foreign assets.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information and metadata associated with foreign assets.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "items": [
    {
      "foreignAssetInfo": {
        "owner": "string",
        "issuer": "string",
        "admin": "string",
        "freezer": "string",
        "supply": "string",
        "deposit": "string",
        "minBalance": "string",
        "isSufficient": true,
        "accounts": "string",
        "sufficients": "string",
        "approvals": "string",
        "status": "string"
      },
      "foreignAssetMetadata": {
        "deposit": "string",
        "name": "string",
        "symbol": "string",
        "decimals": "string",
        "isFrozen": true
      }
    }
  ]
}

Get information associated with nomination pools.

GET

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

Returns information and metadata for nomination pools including pool counters and limits.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the nomination pool info.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information associated with nomination pools.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "counterForBondedPools": 0,
  "counterForMetadata": 0,
  "counterForPoolMembers": 0,
  "counterForReversePoolIdLookup": 0,
  "counterForRewardPools": 0,
  "counterForSubPoolsStorage": 0,
  "lastPoolId": 0,
  "maxPoolMembers": 0,
  "maxPoolMembersPerPool": 0,
  "maxPools": 0,
  "minCreateBond": 0,
  "minJoinBond": 0
}

Get information and metadata associated with a nomination pool.

GET

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

Returns information associated with a nomination pool which includes the nomination pools' bondedPool, rewardPool and metadata.

Parameters

poolIdstring<unsignedInteger>requiredpath

The unsignedInteger Id of a nomination pool.

atstring<unsignedInteger or $hex>query

Block at which to retrieve the nomination pool.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information and metadata associated with a nomination pool.

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

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

const data = await response.json();

import requests

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

200

{
  "bondedPool": {
    "points": 0,
    "state": "string",
    "memberCounter": 0,
    "roles": {
      "depositor": "string",
      "root": "string",
      "nominator": "string",
      "stateToggler": "string"
    }
  },
  "rewardPool": {
    "lastRecordedRewardCounter": 0,
    "lastRecordedTotalPayouts": 0,
    "totalRewardsClaimed": 0
  }
}

Get a list of all on-going referenda that have track `root (0)` and `whitelisted (1)`, along with their associated information.

GET

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

Returns information associated with on-going referenda which includes the referendum's enactment, submitted and deciding fields.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the on-going referenda.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get a list of all on-going referenda that have track `root (0)` and `whitelisted (1)`, along with their associated information.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "referenda": [
    {
      "id": "string",
      "decisionDeposit": {
        "who": "string",
        "amount": "string"
      },
      "enactment": "at",
      "submitted": "string",
      "deciding": {
        "since": "string",
        "confirming": "string"
      }
    }
  ]
}

Get a list of constants for a pallet.

GET

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

Returns a list of const item metadata for constant items of the specified palletId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read constant metadata for. Note: the pallet name must match what is specified in the runtime metadata.

onlyIdsbooleanquery

Only return the names (IDs) of the const items instead of every constant's metadata.

atstring<unsignedInteger or $hex>query

Block at which to retrieve a list of the pallet's constant items.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find pallet with palletId

Authorization

api-keyAuthapiKey in header

Get a list of constants for a pallet.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "pallet": "democracy",
  "palletIndex": "14",
  "items": [
    {
      "name": "VotingPeriod",
      "type": "4",
      "value": "0x00270600",
      "docs": "Information concerning any given constant.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control."
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the value of a constant item.

GET

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

Returns the value stored under the constantItemId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read constant metadata for. Note: the pallet name must match what is specified in the runtime metadata.

constantItemIdstringrequiredpath

Id of the const item to query for.

atstring<unsignedInteger or $hex>query

Block at which to query the const item at.

metadatabooleanfalsequery

Include the const items metadata (including documentation) if set to true.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find resource with id

Authorization

api-keyAuthapiKey in header

Get the value of a constant item.

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

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

const data = await response.json();

import requests

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

{
  "pallet": "democracy",
  "palletIndex": "14",
  "errorItem": "EnactmentPeriod",
  "metadata": {
    "name": "VotingPeriod",
    "type": "4",
    "value": "0x00270600",
    "docs": "Information concerning any given constant.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control."
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get a list of dispatchables for a pallet.

GET

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

Returns a list of dispatchable item metadata for distpachable items of the specified palletId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read dispatchable metadata for. Note: the pallet name must match what is specified in the runtime metadata.

onlyIdsbooleanquery

Only return the names (IDs) of the dispatchable items instead of every dispatchable's metadata.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find pallet with palletId

Authorization

api-keyAuthapiKey in header

Get a list of dispatchables for a pallet.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "pallet": "democracy",
  "palletIndex": "14",
  "items": [
    {
      "name": "propose",
      "fields": [
        "string"
      ],
      "index": "0",
      "docs": "Information concerning any given dispatchable.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control.",
      "args": [
        "string"
      ]
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the value of a dispatchable item.

GET

https://ksm-assethub.nownodes.io/pallets/{palletId}/dispatchables/{dispatchableItemId}

Returns the value stored under the dispatchableItemId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read dispatchable metadata for. Note: the pallet name must match what is specified in the runtime metadata.

dispatchableItemIdstringrequiredpath

Id of the dispatchable item to query for.

metadatabooleanfalsequery

Include the dispatchable items metadata (including documentation) if set to true.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find resource with id

Authorization

api-keyAuthapiKey in header

Get the value of a dispatchable item.

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

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

const data = await response.json();

import requests

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

{
  "pallet": "democracy",
  "palletIndex": "14",
  "dispatchableItem": "vote",
  "metadata": {
    "name": "propose",
    "fields": [
      "string"
    ],
    "index": "0",
    "docs": "Information concerning any given dispatchable.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control.",
    "args": [
      "string"
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get a list of errors for a pallet.

GET

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

Returns a list of error item metadata for error items of the specified palletId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read error metadata for. Note: the pallet name must match what is specified in the runtime metadata.

onlyIdsbooleanquery

Only return the names (IDs) of the error items instead of every error's metadata.

atstring<unsignedInteger or $hex>query

Block at which to retrieve a list of the pallet's error items.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find pallet with palletId

Authorization

api-keyAuthapiKey in header

Get a list of errors for a pallet.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "pallet": "democracy",
  "palletIndex": "14",
  "items": [
    {
      "name": "InsufficientFunds",
      "fields": [
        "string"
      ],
      "index": "0",
      "docs": " Information concerning any given error.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control.",
      "args": [
        "string"
      ]
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the value of an error item.

GET

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

Returns the value stored under the errorItemId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read error metadata for. Note: the pallet name must match what is specified in the runtime metadata.

errorItemIdstringrequiredpath

Id of the error item to query for.

atstring<unsignedInteger or $hex>query

Block at which to query the error item at.

metadatabooleanfalsequery

Include the error items metadata (including documentation) if set to true.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find resource with id

Authorization

api-keyAuthapiKey in header

Get the value of an error item.

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

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

const data = await response.json();

import requests

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

{
  "pallet": "democracy",
  "palletIndex": "14",
  "errorItem": "ValueLow",
  "metadata": {
    "name": "InsufficientFunds",
    "fields": [
      "string"
    ],
    "index": "0",
    "docs": " Information concerning any given error.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control.",
    "args": [
      "string"
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get a list of events for a pallet.

GET

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

Returns a list of event item metadata for event items of the specified palletId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read event metadata for. Note: the pallet name must match what is specified in the runtime metadata.

onlyIdsbooleanquery

Only return the names (IDs) of the event items instead of every event's metadata.

atstring<unsignedInteger or $hex>query

Block at which to retrieve a list of the pallet's event items.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find pallet with palletId

Authorization

api-keyAuthapiKey in header

Get a list of events for a pallet.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "pallet": "democracy",
  "palletIndex": "14",
  "items": [
    {
      "name": "Tabled",
      "fields": [
        "string"
      ],
      "index": "0",
      "docs": " Information concerning any given event.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control.",
      "args": [
        "string"
      ]
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the value of an event item.

GET

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

Returns the value stored under the eventItemId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to read event metadata for. Note: the pallet name must match what is specified in the runtime metadata.

eventItemIdstringrequiredpath

Id of the event item to query for.

atstring<unsignedInteger or $hex>query

Block at which to query the event item at.

metadatabooleanfalsequery

Include the event items metadata (including documentation) if set to true.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find resource with id

Authorization

api-keyAuthapiKey in header

Get the value of an event item.

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

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

const data = await response.json();

import requests

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

{
  "pallet": "democracy",
  "palletIndex": "14",
  "eventItem": "Proposed",
  "metadata": {
    "name": "Tabled",
    "fields": [
      "string"
    ],
    "index": "0",
    "docs": " Information concerning any given event.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control.",
    "args": [
      "string"
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get a list of storage items for a pallet.

GET

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

Returns a list of storage item metadata for storage items of the specified palletId.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to query the storage of. Note: the pallet name must match what is specified in the runtime metadata.

onlyIdsbooleanquery

Only return the names (IDs) of the storage items instead of all of each storage item's metadata.

atstring<unsignedInteger or $hex>query

Block at which to retrieve a list of the pallet's storage items.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find pallet with palletId

Authorization

api-keyAuthapiKey in header

Get a list of storage items for a pallet.

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

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

const data = await response.json();

import requests

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

{
  "pallet": "democracy",
  "palletIndex": "15",
  "items": [
    {
      "name": "ReferendumInfoOf",
      "modifier": "Optional",
      "type": {},
      "fallback": "0x00",
      "docs": " Information concerning any given referendum.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control."
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get the value of a storage item.

GET

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

Returns the value stored under the storageItemId. If it is a map, query param key1 is required. If the storage item is double map query params key1 and key2 are required.

Parameters

palletIdstringrequiredpath

Name or index of the pallet to query the storage of. Note: pallet name aligns with pallet name as specified in runtime metadata.

storageItemIdstringrequiredpath

Id of the storage item to query for.

keysArray<string>query

atstring<unsignedInteger or $hex>query

Block at which to query the storage item at.

metadatabooleanfalsequery

Include the storage items metadata (including documentation) if set to true.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

could not find resource with id

Authorization

api-keyAuthapiKey in header

Get the value of a storage item.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "pallet": "democracy",
  "palletIndex": "15",
  "storageItem": "referendumInfoOf",
  "keys": [
    "0x00",
    "0x01"
  ],
  "value": {
    "Ongoing": {
      "end": "1612800",
      "proposalHash": "0x7de70fc8be782076d0b5772be77153d172a5381c72dd56d3385e25f62abf507e",
      "threshold": "Supermajorityapproval",
      "delay": "403200",
      "tally": {
        "ayes": "41925212461400000",
        "nays": "214535586500000",
        "turnout": "34485320658000000"
      }
    }
  },
  "metadata": {
    "name": "ReferendumInfoOf",
    "modifier": "Optional",
    "type": {},
    "fallback": "0x00",
    "docs": " Information concerning any given referendum.\n\n TWOX-NOTE: SAFE as indexes are not under an attacker’s control."
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get information and metadata associated with a pool asset.

GET

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

Returns information associated with a pool asset which includes the assets AssetDetails and AssetMetadata.

Parameters

assetIdstring<unsignedInteger>requiredpath

The unsignedInteger Id of a pool asset.

atstring<unsignedInteger or $hex>query

Block at which to retrieve the assetInfo.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get information and metadata associated with a pool asset.

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

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

const data = await response.json();

import requests

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

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "poolAssetInfo": {
    "owner": "string",
    "issuer": "string",
    "admin": "string",
    "freezer": "string",
    "supply": "string",
    "deposit": "string",
    "minBalance": "string",
    "isSufficient": true,
    "accounts": "string",
    "sufficients": "string",
    "approvals": "string",
    "status": "string"
  },
  "poolAssetMetadata": {
    "deposit": "string",
    "name": "string",
    "symbol": "string",
    "decimals": "string",
    "isFrozen": true
  }
}

Get progress on the general Staking pallet system.

GET

https://ksm-assethub.nownodes.io/pallets/staking/progress

Returns information on the progress of key components of the staking system and estimates of future points of interest. Replaces /staking-info from versions < v1.0.0.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve a staking progress report.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get progress on the general Staking pallet system.

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

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

const data = await response.json();

import requests

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

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "activeEra": "string",
  "forceEra": "ForceNone",
  "nextActiveEraEstimate": "string",
  "nextSessionEstimate": "string",
  "unappliedSlashes": [
    {
      "validator": "string",
      "own": "string",
      "others": [
        "string"
      ],
      "reporters": [
        "string"
      ],
      "payout": "string"
    }
  ],
  "electionStatus": {
    "status": {},
    "toggleEstimate": "string"
  },
  "idealValidatorCount": "string",
  "validatorSet": [
    "string"
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get all validators (active/waiting) of a specific chain.

GET

https://ksm-assethub.nownodes.io/pallets/staking/validators

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the list of validators.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get all validators (active/waiting) of a specific chain.

curl -X GET 'https://ksm-assethub.nownodes.io/pallets/staking/validators'

const response = await fetch('https://ksm-assethub.nownodes.io/pallets/staking/validators', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/pallets/staking/validators')
data = response.json()

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "validators": [
    {
      "address": "string",
      "status": "string"
    }
  ],
  "validatorsToBeChilled": [
    {
      "address": "string",
      "status": "string"
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

runtime

Runtime specification, metadata, and code

Runtime Wasm code

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/runtime/code'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/runtime/code', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/runtime/code')
data = response.json()

200

{}

Runtime metadata

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/runtime/metadata'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/runtime/metadata', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/runtime/metadata')
data = response.json()

200

{}

Available metadata versions

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/runtime/metadata/versions'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/runtime/metadata/versions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/runtime/metadata/versions')
data = response.json()

200

[
  "string"
]

Runtime metadata by version

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/runtime/metadata/{version}'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/runtime/metadata/{version}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/runtime/metadata/{version}')
data = response.json()

200

{}

Runtime specification

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/runtime/spec'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/runtime/spec', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/runtime/spec')
data = response.json()

200

{}

Get the runtime metadata in decoded, JSON form.

GET

https://ksm-assethub.nownodes.io/runtime/metadata

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the metadata at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get the runtime metadata in decoded, JSON form.

curl -X GET 'https://ksm-assethub.nownodes.io/runtime/metadata'

const response = await fetch('https://ksm-assethub.nownodes.io/runtime/metadata', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/runtime/metadata')
data = response.json()

200

{}

Get the requested version of runtime metadata in decoded, JSON form.

GET

https://ksm-assethub.nownodes.io/runtime/metadata/{metadataVersion}

Parameters

metadataVersionstringrequiredpath

The version of metadata. The input is expected in a vX format, where X represents the version number (e.g. v14, v15).

atstring<unsignedInteger or $hex>query

Block at which to retrieve the metadata at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get the requested version of runtime metadata in decoded, JSON form.

curl -X GET 'https://ksm-assethub.nownodes.io/runtime/metadata/{metadataVersion}'

const response = await fetch('https://ksm-assethub.nownodes.io/runtime/metadata/{metadataVersion}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/runtime/metadata/{metadataVersion}')
data = response.json()

200

{}

Get the available versions of runtime metadata.

GET

https://ksm-assethub.nownodes.io/runtime/metadata/versions

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the metadata versions at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get the available versions of runtime metadata.

curl -X GET 'https://ksm-assethub.nownodes.io/runtime/metadata/versions'

const response = await fetch('https://ksm-assethub.nownodes.io/runtime/metadata/versions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/runtime/metadata/versions')
data = response.json()

200

[
  "string"
]

Get the runtime wasm blob.

GET

https://ksm-assethub.nownodes.io/runtime/code

Returns the runtime Wasm blob in hex format.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the runtime wasm blob at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get the runtime wasm blob.

curl -X GET 'https://ksm-assethub.nownodes.io/runtime/code'

const response = await fetch('https://ksm-assethub.nownodes.io/runtime/code', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/runtime/code')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "code": "string"
}

Get version information of the Substrate runtime.

GET

https://ksm-assethub.nownodes.io/runtime/spec

Returns version information related to the runtime.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve runtime version information at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get version information of the Substrate runtime.

curl -X GET 'https://ksm-assethub.nownodes.io/runtime/spec'

const response = await fetch('https://ksm-assethub.nownodes.io/runtime/spec', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/runtime/spec')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "authoringVersion": "string",
  "chainType": "{\"live\": null}",
  "implVersion": "string",
  "specName": "string",
  "specVersion": "string",
  "transactionVersion": "string",
  "properties": {}
}

transaction

Transaction submission, fee estimation, and construction material

Submit transaction

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/transaction' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-assethub.nownodes.io/v1/transaction', json=payload)
data = response.json()

Request Body

{}

200

{}

Dry run transaction

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/dry-run' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/dry-run', json=payload)
data = response.json()

Request Body

{}

200

{}

Estimate transaction fee

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/fee-estimate' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/transaction/material'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/transaction/material', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/transaction/material')
data = response.json()

200

{}

Transaction material with versioned metadata

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/material/{metadataVersion}'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/transaction/material/{metadataVersion}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/transaction/material/{metadataVersion}')
data = response.json()

200

{}

Generate metadata blob

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/metadata-blob' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/metadata-blob', json=payload)
data = response.json()

Request Body

{}

200

{}

Parse transaction

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/transaction/parse' \
  -H 'Content-Type: application/json' \
  -d '{
    "tx": "0x4902840004316d995f..."
  }'

const response = await fetch('https://ksm-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://ksm-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"
}

Submit a transaction to the node's transaction pool.

POST

https://ksm-assethub.nownodes.io/transaction

Accepts a valid signed extrinsic. Replaces /tx from versions < v1.0.0.

Body

application/json

txstring<hex>

Response

200OK

successful operation

400Bad Request

failed to parse or submit transaction

Authorization

api-keyAuthapiKey in header

Submit a transaction to the node's transaction pool.

curl -X POST 'https://ksm-assethub.nownodes.io/transaction' \
  -H 'Content-Type: application/json' \
  -d '{
    "tx": "string"
  }'

const response = await fetch('https://ksm-assethub.nownodes.io/transaction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "tx": "string"
    }),
});

const data = await response.json();

import requests

payload = {
  "tx": "string"
}

response = requests.post('https://ksm-assethub.nownodes.io/transaction', json=payload)
data = response.json()

Request Body

{
  "tx": "string"
}

{
  "hash": "string"
}

{
  "code": 0,
  "error": "string",
  "transaction": "string",
  "cause": "string",
  "stack": "string"
}

Dry run an extrinsic.

POST

https://ksm-assethub.nownodes.io/transaction/dry-run

Use the dryRun call to simulate the submission of a transaction without executing it so that you can check for potential errors and validate the expected outcome.

Body

application/json

atstring<unsignedInteger>

txstring<hex>

senderAddressstring<ss58>

Response

200OK

successful operation

400Bad Request

failed to dry-run transaction

Authorization

api-keyAuthapiKey in header

Dry run an extrinsic.

curl -X POST 'https://ksm-assethub.nownodes.io/transaction/dry-run' \
  -H 'Content-Type: application/json' \
  -d '{
    "at": "string",
    "tx": "string",
    "senderAddress": "string"
  }'

const response = await fetch('https://ksm-assethub.nownodes.io/transaction/dry-run', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "at": "string",
      "tx": "string",
      "senderAddress": "string"
    }),
});

const data = await response.json();

import requests

payload = {
  "at": "string",
  "tx": "string",
  "senderAddress": "string"
}

response = requests.post('https://ksm-assethub.nownodes.io/transaction/dry-run', json=payload)
data = response.json()

Request Body

{
  "at": "string",
  "tx": "string",
  "senderAddress": "string"
}

{
  "resultType": "DispatchOutcome",
  "result": {
    "actualWeight": "string",
    "paysFee": "string"
  }
}

{
  "code": 0,
  "error": "string",
  "transaction": "string",
  "cause": "string",
  "stack": "string"
}

Receive a fee estimate for a transaction.

POST

https://ksm-assethub.nownodes.io/transaction/fee-estimate

Body

application/json

txstring<hex>

Response

200OK

successful operation

400Bad Request

fee estimation failure

Authorization

api-keyAuthapiKey in header

Receive a fee estimate for a transaction.

curl -X POST 'https://ksm-assethub.nownodes.io/transaction/fee-estimate' \
  -H 'Content-Type: application/json' \
  -d '{
    "tx": "string"
  }'

const response = await fetch('https://ksm-assethub.nownodes.io/transaction/fee-estimate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "tx": "string"
    }),
});

const data = await response.json();

import requests

payload = {
  "tx": "string"
}

response = requests.post('https://ksm-assethub.nownodes.io/transaction/fee-estimate', json=payload)
data = response.json()

Request Body

{
  "tx": "string"
}

{
  "weight": {
    "refTime": "string",
    "proofSize": "string"
  },
  "class": "Normal",
  "partialFee": "string"
}

{
  "code": 0,
  "at": {
    "hash": "string"
  },
  "error": "string",
  "transaction": "string",
  "block": "string",
  "cause": "string",
  "stack": "string"
}

Get all the network information needed to construct a transaction offline.

GET

https://ksm-assethub.nownodes.io/transaction/material

Returns the material that is universal to constructing any signed transaction offline. Replaces /tx/artifacts from versions < v1.0.0.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the transaction construction material.

noMetabooleanfalsequery

DEPRECATED! This is no longer supported

metadatastringquery

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get all the network information needed to construct a transaction offline.

curl -X GET 'https://ksm-assethub.nownodes.io/transaction/material'

const response = await fetch('https://ksm-assethub.nownodes.io/transaction/material', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/transaction/material')
data = response.json()

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "genesisHash": "string",
  "chainName": "string",
  "specName": "string",
  "specVersion": "string",
  "txVersion": "string",
  "metadata": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get all the network information needed to construct a transaction offline and the version of metadata specified in `metadataVersion`.

GET

https://ksm-assethub.nownodes.io/transaction/material/{metadataVersion}

Returns all the materials necessary for constructing any signed transactions offline.

Parameters

metadataVersionstringrequiredpath

atstring<unsignedInteger or $hex>query

Block at which to retrieve the transaction construction material.

metadatastringquery

Specifies the format of the metadata to be returned. Accepted values are 'json', and 'scale'. 'json' being the decoded metadata, and 'scale' being the SCALE encoded metadata.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get all the network information needed to construct a transaction offline and the version of metadata specified in `metadataVersion`.

curl -X GET 'https://ksm-assethub.nownodes.io/transaction/material/{metadataVersion}'

const response = await fetch('https://ksm-assethub.nownodes.io/transaction/material/{metadataVersion}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/transaction/material/{metadataVersion}')
data = response.json()

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "genesisHash": "string",
  "chainName": "string",
  "specName": "string",
  "specVersion": "string",
  "txVersion": "string",
  "metadata": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

coretime

Coretime system information

Get coretime info

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/coretime/info'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/coretime/info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/coretime/info')
data = response.json()

200

{}

Get coretime leases

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/coretime/leases'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/coretime/leases', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/coretime/leases')
data = response.json()

200

{}

Get coretime overview

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/coretime/overview'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/coretime/overview', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/coretime/overview')
data = response.json()

200

{}

Get coretime regions

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/coretime/regions'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/coretime/regions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/coretime/regions')
data = response.json()

200

{}

Get coretime potential renewals

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/coretime/renewals'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/coretime/renewals', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/coretime/renewals')
data = response.json()

200

{}

Get coretime reservations

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/coretime/reservations'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/coretime/reservations', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/coretime/reservations')
data = response.json()

200

{}

Get all the leases currently registered on coretime chain.

GET

https://ksm-assethub.nownodes.io/coretime/leases

Parameters

blockIdstringquery

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get all the leases currently registered on coretime chain.

curl -X GET 'https://ksm-assethub.nownodes.io/coretime/leases'

const response = await fetch('https://ksm-assethub.nownodes.io/coretime/leases', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/coretime/leases')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "leases": [
    {
      "task": "string",
      "until": "string",
      "core": "string"
    }
  ]
}

Get all the regions currently registered on coretime chain.

GET

https://ksm-assethub.nownodes.io/coretime/regions

Parameters

blockIdstringquery

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get all the regions currently registered on coretime chain.

curl -X GET 'https://ksm-assethub.nownodes.io/coretime/regions'

const response = await fetch('https://ksm-assethub.nownodes.io/coretime/regions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/coretime/regions')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "regions": [
    {
      "core": "string",
      "begin": "string",
      "end": "string",
      "owner": "string",
      "paid": "string",
      "mask": "string"
    }
  ]
}

Get all the potential renewals currently registered on coretime chain.

GET

https://ksm-assethub.nownodes.io/coretime/renewals

Parameters

blockIdstringquery

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get all the potential renewals currently registered on coretime chain.

curl -X GET 'https://ksm-assethub.nownodes.io/coretime/renewals'

const response = await fetch('https://ksm-assethub.nownodes.io/coretime/renewals', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/coretime/renewals')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "renewals": [
    {
      "completion": "string",
      "core": "string",
      "mask": "string",
      "price": "string",
      "task": "string",
      "when": "string"
    }
  ]
}

Get all the reservations currently registered on coretime chain.

GET

https://ksm-assethub.nownodes.io/coretime/reservations

Parameters

blockIdstringquery

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get all the reservations currently registered on coretime chain.

curl -X GET 'https://ksm-assethub.nownodes.io/coretime/reservations'

const response = await fetch('https://ksm-assethub.nownodes.io/coretime/reservations', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/coretime/reservations')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "reservations": [
    {
      "task": "string",
      "mask": "string"
    }
  ]
}

Get the generic information about coretime, either on coretime chain or relay chain.

GET

https://ksm-assethub.nownodes.io/coretime/info

Parameters

blockIdstringquery

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get the generic information about coretime, either on coretime chain or relay chain.

curl -X GET 'https://ksm-assethub.nownodes.io/coretime/info'

const response = await fetch('https://ksm-assethub.nownodes.io/coretime/info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/coretime/info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "configuration": {
    "interludeLength": "string",
    "leadinLength": "string",
    "regionLength": "string",
    "relayBlocksPerTimeslice": "string"
  },
  "currentRegion": {
    "start": "string",
    "end": "string"
  },
  "cores": {
    "total": "string",
    "available": "string",
    "sold": "string",
    "currentCorePrice": "string",
    "selloutPrice": "string",
    "firstCore": "string"
  }
}

Get all the cores information either on coretime chain or relay chain.

GET

https://ksm-assethub.nownodes.io/coretime/overview

Parameters

blockIdstringquery

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

Get all the cores information either on coretime chain or relay chain.

curl -X GET 'https://ksm-assethub.nownodes.io/coretime/overview'

const response = await fetch('https://ksm-assethub.nownodes.io/coretime/overview', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/coretime/overview')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "cores": [
    {
      "coreId": "string",
      "paraId": "string",
      "workload": {
        "isPool": true,
        "isTask": true,
        "mask": "string",
        "task": "string"
      },
      "workplan": [
        {
          "core": "string",
          "timeslice": "string",
          "info": [
            {
              "isPool": true,
              "isTask": true,
              "mask": "string",
              "task": "string"
            }
          ]
        }
      ],
      "type": {
        "condition": "string",
        "details": "string"
      },
      "regions": [
        {
          "core": "string",
          "begin": "string",
          "end": "string",
          "owner": "string",
          "paid": "string",
          "mask": "string"
        }
      ]
    }
  ]
}

paras

Parachain inclusion data

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/paras/{number}/inclusion'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/paras/{number}/inclusion', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/paras/{number}/inclusion')
data = response.json()

200

{}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] List all registered paras (parathreads & parachains).

GET

https://ksm-assethub.nownodes.io/paras

Returns all registered parachains and parathreads with lifecycle info.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve paras list at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] List all registered paras (parathreads & parachains).

curl -X GET 'https://ksm-assethub.nownodes.io/paras'

const response = await fetch('https://ksm-assethub.nownodes.io/paras', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "paras": [
    {
      "paraId": "string",
      "paraLifecycle": "onboarding",
      "onboardingAs": "parachain"
    }
  ]
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get general information about the current lease period.

GET

https://ksm-assethub.nownodes.io/paras/leases/current

Returns an overview of the current lease period, including lease holders.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve current lease period info at.

currentLeaseHoldersbooleantruequery

Wether or not to include the currentLeaseHolders property. Inclusion of the property will likely result in a larger payload and increased response time.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get general information about the current lease period.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/leases/current'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/leases/current', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/leases/current')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "leasePeriodIndex": "string",
  "endOfLeasePeriod": "string",
  "currentLeaseHolders": [
    "string"
  ]
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the status of the current auction.

GET

https://ksm-assethub.nownodes.io/paras/auctions/current

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve auction progress at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the status of the current auction.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/auctions/current'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/auctions/current', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/auctions/current')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "beginEnd": "string",
  "finishEnd": "string",
  "phase": "startPeriod",
  "auctionIndex": "string",
  "leasePeriods": [
    "string"
  ],
  "winning": [
    {
      "bid": {
        "accountId": "string",
        "paraId": "string",
        "amount": "string"
      },
      "leaseSet": [
        "string"
      ]
    }
  ]
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] List all stored crowdloans.

GET

https://ksm-assethub.nownodes.io/paras/crowdloans

Returns a list of all the crowdloans and their associated paraIds.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the list of paraIds that have crowdloans at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] List all stored crowdloans.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/crowdloans'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/crowdloans', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/crowdloans')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "funds": [
    {
      "paraId": "string",
      "fundInfo": {
        "depositor": "string",
        "verifier": "string",
        "deposit": "string",
        "raised": "string",
        "end": "string",
        "cap": "string",
        "lastConstribution": "preEnding",
        "firstPeriod": "string",
        "lastPeriod": "string",
        "trieIndex": "string"
      }
    }
  ]
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get crowdloan information for a `paraId`.

GET

https://ksm-assethub.nownodes.io/paras/{paraId}/crowdloan-info

Returns crowdloan's fundInfo and the set of leasePeriods the crowdloan` covers.

Parameters

paraIdnumberrequiredpath

paraId to query the crowdloan information of.

atstring<unsignedInteger or $hex>query

Block at which to retrieve info at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get crowdloan information for a `paraId`.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/{paraId}/crowdloan-info'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/{paraId}/crowdloan-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/{paraId}/crowdloan-info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "fundInfo": {
    "depositor": "string",
    "verifier": "string",
    "deposit": "string",
    "raised": "string",
    "end": "string",
    "cap": "string",
    "lastConstribution": "preEnding",
    "firstPeriod": "string",
    "lastPeriod": "string",
    "trieIndex": "string"
  },
  "leasePeriods": [
    "string"
  ]
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get current and future leases as well as the lifecycle stage for a given `paraId`.

GET

https://ksm-assethub.nownodes.io/paras/{paraId}/lease-info

Returns a list of leases that belong to the paraId as well as the paraId's current lifecycle stage.

Parameters

paraIdnumberrequiredpath

paraId to query the crowdloan information of.

atstring<unsignedInteger or $hex>query

Block at which to retrieve para's leases at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get current and future leases as well as the lifecycle stage for a given `paraId`.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/{paraId}/lease-info'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/{paraId}/lease-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/{paraId}/lease-info')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "paraLifecycle": "onboarding",
  "onboardingAs": "parachain",
  "leases": [
    {
      "leasePeriodIndex": "string",
      "account": "string",
      "deposit": "string"
    }
  ]
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the heads of the included (backed and considered available) parachain candidates at the specified block height or at the most recent finalized head otherwise.

GET

https://ksm-assethub.nownodes.io/paras/head/included-candidates

Returns an object with all the parachain id's as keys, and their headers as values.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve para's heads at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

curl -X GET 'https://ksm-assethub.nownodes.io/paras/head/included-candidates'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/head/included-candidates', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/head/included-candidates')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "paraId": {
    "hash": "string",
    "number": "string",
    "parentHash": "string",
    "stateRoot": "string",
    "extrinsicsRoot": "string",
    "digest": {
      "logs": [
        {
          "type": "string",
          "index": "string",
          "value": [
            "string"
          ]
        }
      ]
    }
  }
}

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the heads of the backed parachain candidates at the specified block height or at the most recent finalized head otherwise.

GET

https://ksm-assethub.nownodes.io/paras/head/backed-candidates

Returns an object with all the parachain id's as keys, and their headers as values.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve para's heads at.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the heads of the backed parachain candidates at the specified block height or at the most recent finalized head otherwise.

curl -X GET 'https://ksm-assethub.nownodes.io/paras/head/backed-candidates'

const response = await fetch('https://ksm-assethub.nownodes.io/paras/head/backed-candidates', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/paras/head/backed-candidates')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "paraId": {
    "hash": "string",
    "number": "string",
    "parentHash": "string",
    "stateRoot": "string",
    "extrinsicsRoot": "string",
    "digest": {
      "logs": [
        {
          "type": "string",
          "index": "string",
          "value": [
            "string"
          ]
        }
      ]
    }
  }
}

ahm

Asset Hub Migration information

Asset Hub Migration info

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/ahm-info'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/ahm-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/ahm-info')
data = response.json()

200

{}

capabilities

API capabilities and chain pallets

API capabilities

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/capabilities'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/capabilities', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/balance-info'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/balance-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/proxy-info'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/proxy-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-info'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-payouts'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/staking-payouts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/vesting-info'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/accounts/{accountId}/vesting-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/blocks'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/blocks', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/blocks')
data = response.json()

200

{}

RC get head block

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/blocks/head'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/blocks/head', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/blocks/head')
data = response.json()

200

{}

RC get head block header

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/blocks/head/header'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/blocks/head/header', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/blocks/head/header')
data = response.json()

200

{}

RC get block by ID

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}')
data = response.json()

200

{}

RC get raw extrinsics

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics-raw'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics-raw', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics-raw')
data = response.json()

200

{}

RC get extrinsic by index

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics/{extrinsicIndex}'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics/{extrinsicIndex}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}/extrinsics/{extrinsicIndex}')
data = response.json()

200

{}

RC get block header

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}/header'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}/header', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}/header')
data = response.json()

200

{}

RC get parachain inclusions

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}/para-inclusions'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}/para-inclusions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/blocks/{blockId}/para-inclusions')
data = response.json()

200

{}

RC get node network

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/node/network'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/node/network', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/node/network')
data = response.json()

200

{}

RC get transaction pool

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/node/transaction-pool'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/node/transaction-pool', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/node/version'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/node/version', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/node/version')
data = response.json()

200

{
  "chain": "string",
  "clientImplName": "string",
  "clientVersion": "string"
}

RC on-going referenda

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/on-going-referenda'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/on-going-referenda', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/on-going-referenda')
data = response.json()

200

{}

RC staking progress

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/staking/progress'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/staking/progress', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/staking/progress')
data = response.json()

200

{}

RC staking validators

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/staking/validators'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/staking/validators', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/staking/validators')
data = response.json()

200

{}

RC pallet constants

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts')
data = response.json()

200

{}

RC pallet constant value

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/consts/{constantItemId}')
data = response.json()

200

{}

RC pallet dispatchables

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables')
data = response.json()

200

{}

RC pallet dispatchable details

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/dispatchables/{dispatchableId}')
data = response.json()

200

{}

RC pallet errors

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors')
data = response.json()

200

{}

RC pallet error details

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/errors/{errorItemId}')
data = response.json()

200

{}

RC pallet events

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/events'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/events', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/events')
data = response.json()

200

{}

RC pallet event details

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/events/{eventItemId}')
data = response.json()

200

{}

RC pallet storage items

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage')
data = response.json()

200

{}

RC pallet storage item value

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/pallets/{palletId}/storage/{storageItemId}')
data = response.json()

200

{}

RC get runtime code

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/runtime/code'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/runtime/code', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/runtime/code')
data = response.json()

200

{}

RC get runtime metadata

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/runtime/metadata'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/runtime/metadata', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/runtime/metadata')
data = response.json()

200

{}

RC get metadata versions

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/runtime/metadata/versions'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/runtime/metadata/versions', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/runtime/metadata/versions')
data = response.json()

200

{}

RC get metadata by version

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/runtime/metadata/{version}'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/runtime/metadata/{version}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/runtime/metadata/{version}')
data = response.json()

200

{}

RC get runtime spec

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/runtime/spec'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/runtime/spec', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/runtime/spec')
data = response.json()

200

{}

Submit transaction (relay chain)

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction', json=payload)
data = response.json()

Request Body

{}

200

{}

RC dry run transaction

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/dry-run' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/dry-run', json=payload)
data = response.json()

Request Body

{}

200

{}

RC fee estimate

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/fee-estimate' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-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://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/material'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/transaction/material', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/transaction/material')
data = response.json()

200

{}

RC transaction material versioned

GET

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/material/{metadataVersion}'

const response = await fetch('https://ksm-assethub.nownodes.io/v1/rc/transaction/material/{metadataVersion}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/v1/rc/transaction/material/{metadataVersion}')
data = response.json()

200

{}

RC metadata blob

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/metadata-blob' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/metadata-blob', json=payload)
data = response.json()

Request Body

{}

200

{}

Parse transaction (relay chain)

POST

https://ksm-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://ksm-assethub.nownodes.io/v1/rc/transaction/parse' \
  -H 'Content-Type: application/json' \
  -d '{
    "tx": "0x4902840004316d995f..."
  }'

const response = await fetch('https://ksm-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://ksm-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"
}

contracts

Query an !Ink contract with a given message (method).

POST

https://ksm-assethub.nownodes.io/contracts/ink/{address}/query

Will return a valid or invalid result.

Body

application/json

Metadata used to instantiate a ContractPromise. This metadata can be generated by compiling the contract you are querying.

ContractMetadata

Parameters

addressstringrequiredpath

SS58 or Hex address of the account associated with the contract.

methodstringgetquery

The message or method used to query.

gasLimitnumber-1query

The gas limit to be used as an option for the queried message.

storageDepositLimitnumbernullquery

The storage deposit limit to be used as an option for the queried message.

argsArray<string>query

Abi params used as args specified in the metadata to be passed into a query. The format to use this query param is ?args[]=1&args[]=2&args[]=3.

Response

200OK

succesful operation

400Bad Request

Invalid Method

Authorization

api-keyAuthapiKey in header

Query an !Ink contract with a given message (method).

curl -X POST 'https://ksm-assethub.nownodes.io/contracts/ink/{address}/query' \
  -H 'Content-Type: application/json' \
  -d '{}'

const response = await fetch('https://ksm-assethub.nownodes.io/contracts/ink/{address}/query', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});

const data = await response.json();

import requests

payload = {}

response = requests.post('https://ksm-assethub.nownodes.io/contracts/ink/{address}/query', json=payload)
data = response.json()

Request Body

{}

{
  "debugMessage": "string",
  "gasConsumed": "string",
  "gasRequired": "string",
  "output": true,
  "result": {},
  "storageDeposit": {}
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

trace

[Experimental - subject to breaking change.] Get traces for the most recently finalized block.

GET

https://ksm-assethub.nownodes.io/experimental/blocks/head/traces

Returns traces (spans and events) of the most recently finalized block from RPC state_straceBlock. Consult the RPC docs for conceptual info.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[Experimental - subject to breaking change.] Get traces for the most recently finalized block.

curl -X GET 'https://ksm-assethub.nownodes.io/experimental/blocks/head/traces'

const response = await fetch('https://ksm-assethub.nownodes.io/experimental/blocks/head/traces', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/experimental/blocks/head/traces')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "blockHash": "string",
  "events": [
    {
      "data": {
        "stringValues": {
          "key": "string",
          "method": "string",
          "result": "string"
        }
      },
      "parentId": "string",
      "target": "string"
    }
  ],
  "parentHash": "string",
  "spans": [
    {
      "id": "string",
      "name": "string",
      "parentId": "string",
      "target": "string",
      "wasm": true
    }
  ],
  "storageKeys": "string",
  "tracingTargets": "string"
}

[Experimental - subject to breaking change.] Get traces for the given `blockId`.

GET

https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces

Returns traces (spans and events) of the specified block from RPC state_straceBlock. Consult the RPC docs for conceptual info.

Parameters

blockIdstringrequiredpath

Block identifier, as the block height or block hash.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[Experimental - subject to breaking change.] Get traces for the given `blockId`.

curl -X GET 'https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces'

const response = await fetch('https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "blockHash": "string",
  "events": [
    {
      "data": {
        "stringValues": {
          "key": "string",
          "method": "string",
          "result": "string"
        }
      },
      "parentId": "string",
      "target": "string"
    }
  ],
  "parentHash": "string",
  "spans": [
    {
      "id": "string",
      "name": "string",
      "parentId": "string",
      "target": "string",
      "wasm": true
    }
  ],
  "storageKeys": "string",
  "tracingTargets": "string"
}

[Experimental - subject to breaking change.] Get the operations from the most recently finalized block.

GET

https://ksm-assethub.nownodes.io/experimental/blocks/head/traces/operations

To learn more about operation and action group creation please consult this diagram

Parameters

actionsbooleanfalsequery

Whether or not to include action groups.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[Experimental - subject to breaking change.] Get the operations from the most recently finalized block.

curl -X GET 'https://ksm-assethub.nownodes.io/experimental/blocks/head/traces/operations'

const response = await fetch('https://ksm-assethub.nownodes.io/experimental/blocks/head/traces/operations', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/experimental/blocks/head/traces/operations')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "operations": [
    {
      "phase": {
        "variant": "onInitialize",
        "extrinsicIndex": "string"
      },
      "parentSpanId": {
        "name": "string",
        "target": "string",
        "id": "string"
      },
      "primarySpanId": {
        "name": "string",
        "target": "string",
        "id": "string"
      },
      "eventIndex": "string",
      "address": "string",
      "storage": {
        "pallet": "string",
        "item": "string",
        "field1": "string",
        "field2": "string"
      },
      "amount": {
        "values": "string",
        "currency": {
          "symbol": "KSM"
        }
      }
    }
  ]
}

[Experimental - subject to breaking change.] Get the operations from the specified block.

GET

https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces/operations

To learn more about operation and action group creation please consult this diagram

Parameters

blockIdstringrequiredpath

Block identifier, as the block height or block hash.

actionsbooleanfalsequery

Whether or not to include action groups.

Response

200OK

successful operation

Authorization

api-keyAuthapiKey in header

[Experimental - subject to breaking change.] Get the operations from the specified block.

curl -X GET 'https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces/operations'

const response = await fetch('https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces/operations', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/experimental/blocks/{blockId}/traces/operations')
data = response.json()

200

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "operations": [
    {
      "phase": {
        "variant": "onInitialize",
        "extrinsicIndex": "string"
      },
      "parentSpanId": {
        "name": "string",
        "target": "string",
        "id": "string"
      },
      "primarySpanId": {
        "name": "string",
        "target": "string",
        "id": "string"
      },
      "eventIndex": "string",
      "address": "string",
      "storage": {
        "pallet": "string",
        "item": "string",
        "field1": "string",
        "field2": "string"
      },
      "amount": {
        "values": "string",
        "currency": {
          "symbol": "KSM"
        }
      }
    }
  ]
}

staking

Get staking information for a Stash account.

GET

https://ksm-assethub.nownodes.io/accounts/{accountId}/staking-info

Returns information about a Stash account's staking activity. Replaces /staking/{address} from versions < v1.0.0. The Stash account can be either a validator or nominator account.

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account. Must be a Stash account.

atstring<unsignedInteger or $hex>query

Block at which to query the staking info for the specified account.

includeClaimedRewardsstring<boolean>truequery

When set to false, the claimedRewards field is not included in the response.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

account not found

Authorization

api-keyAuthapiKey in header

Get staking information for a _Stash_ account.

curl -X GET 'https://ksm-assethub.nownodes.io/accounts/{accountId}/staking-info'

const response = await fetch('https://ksm-assethub.nownodes.io/accounts/{accountId}/staking-info', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/accounts/{accountId}/staking-info')
data = response.json()

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "rewardDestination": "Staked",
  "controller": "string",
  "numSlashingSpans": "string",
  "nominations": {
    "targets": [
      "string"
    ],
    "submittedIn": "string",
    "suppressed": true
  },
  "staking": {
    "stash": "string",
    "total": "string",
    "active": "string",
    "unlocking": "string",
    "claimedRewards": [
      {
        "era": "string",
        "status": "claimed"
      }
    ]
  }
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get payout information for a Stash account.

GET

https://ksm-assethub.nownodes.io/accounts/{accountId}/staking-payouts

Parameters

accountIdstring<SS58>requiredpath

SS58 address of the account. Must be a Stash account.

atstring<unsignedInteger or $hex>query

Block at which to query staking payouts.

depthstring<unsignedInteger>1query

The number of eras to query for payouts of. Must be less than or equal to HISTORY_DEPTH. In cases where era - (depth -1) is less than 0, the first era queried will be 0.

erastring<unsignedInteger>`active_era - 1`query

The era to query at.

unclaimedOnlystring<boolean>truequery

Only return unclaimed rewards.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

404Not Found

account not found

Authorization

api-keyAuthapiKey in header

Get payout information for a _Stash_ account.

curl -X GET 'https://ksm-assethub.nownodes.io/accounts/{accountId}/staking-payouts'

const response = await fetch('https://ksm-assethub.nownodes.io/accounts/{accountId}/staking-payouts', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/accounts/{accountId}/staking-payouts')
data = response.json()

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "erasPayouts": [
    {
      "era": "string",
      "totalEraRewardPoints": "string",
      "totalEraPayout": "string",
      "payouts": [
        {
          "validatorId": "string",
          "nominatorStakingPayout": "string",
          "claimed": true,
          "totalValidatorRewardPoints": "string",
          "validatorCommission": "string",
          "totalValidatorExposure": "string",
          "nominatorExposure": "string"
        }
      ]
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get progress on the general Staking pallet system.

GET

https://ksm-assethub.nownodes.io/pallets/staking/progress

Returns information on the progress of key components of the staking system and estimates of future points of interest. Replaces /staking-info from versions < v1.0.0.

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve a staking progress report.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get progress on the general Staking pallet system.

curl -X GET 'https://ksm-assethub.nownodes.io/pallets/staking/progress'

const response = await fetch('https://ksm-assethub.nownodes.io/pallets/staking/progress', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/pallets/staking/progress')
data = response.json()

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "activeEra": "string",
  "forceEra": "ForceNone",
  "nextActiveEraEstimate": "string",
  "nextSessionEstimate": "string",
  "unappliedSlashes": [
    {
      "validator": "string",
      "own": "string",
      "others": [
        "string"
      ],
      "reporters": [
        "string"
      ],
      "payout": "string"
    }
  ],
  "electionStatus": {
    "status": {},
    "toggleEstimate": "string"
  },
  "idealValidatorCount": "string",
  "validatorSet": [
    "string"
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Get all validators (active/waiting) of a specific chain.

GET

https://ksm-assethub.nownodes.io/pallets/staking/validators

Parameters

atstring<unsignedInteger or $hex>query

Block at which to retrieve the list of validators.

Response

200OK

successful operation

400Bad Request

invalid blockId supplied for at query param

Authorization

api-keyAuthapiKey in header

Get all validators (active/waiting) of a specific chain.

curl -X GET 'https://ksm-assethub.nownodes.io/pallets/staking/validators'

const response = await fetch('https://ksm-assethub.nownodes.io/pallets/staking/validators', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ksm-assethub.nownodes.io/pallets/staking/validators')
data = response.json()

{
  "at": {
    "hash": "string",
    "height": "string"
  },
  "validators": [
    {
      "address": "string",
      "status": "string"
    }
  ],
  "validatorsToBeChilled": [
    {
      "address": "string",
      "status": "string"
    }
  ]
}

{
  "code": 0,
  "message": "string",
  "stack": "string",
  "level": "string"
}

Documentation

Authentication

ASSETHUB

author

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

chain

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

payment

Body

Response

Authorization

state

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

Body

Response

Authorization

system

Body

Response

Authorization

Body

Response

Authorization

health

Response

Authorization

node

Response

Authorization

Parameters

Response

Authorization

Response

Authorization

Response

Authorization

Parameters

Response

Authorization

Response

Authorization

version

Response

Authorization