Account vesting info

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Changed. If reading vesting schedules from the node fails, the endpoint now returns 503 Service temporarily unavailable (safe to retry) instead of 200 with an empty vesting list. An unrecognised storage layout returns 500. A 200 response is unchanged and now always reflects real on-chain data. Addresses encoded with any SS58 prefix are now accepted; before, an address from another network was rejected with 400.

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

Account vesting info

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

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

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ksmassethub-playbook.nownodes.io/v1/accounts/{accountId}/vesting-info')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

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

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

const data = await response.json();

const endpoint = "https://ksmassethub-playbook.nownodes.io/v1/accounts/{accountId}/vesting-info";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

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

const data = await response.json();

import requests

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

require 'net/http'
require 'json'

uri = URI('https://ksmassethub-playbook.nownodes.io/v1/accounts/{accountId}/vesting-info')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

200

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