Get historical ticket balances

GET

https://xtz-index.nownodes.io/v1/tickets/historical_balances/{level}

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns a list of ticket balances at the end of the specified block. Note, this endpoint is quite heavy, therefore at least one of the filters (account, ticket.id, ticket.ticketer) must be specified.

Parameters

levelinteger<int32>requiredpath

Level of the block at the end of which historical balances must be calculated

idobject | nullquery

Filter by internal TzKT id. Click on the parameter to expand more details.

ticket.idobject | nullquery

Filter by internal TzKT id. Click on the parameter to expand more details.

ticket.ticketerobject | nullquery

Filter by ticketer address. Click on the parameter to expand more details.

accountobject | nullquery

Filter by account address. Click on the parameter to expand more details.

balanceobject | nullquery

Filter by balance. Click on the parameter to expand more details.

sortobject | nullquery

Sorts items (asc or desc) by the specified field. You can see what fields can be used for sorting in the response description, below. Click on the parameter to expand more details.

offsetobject | nullquery

Specifies which or how many items should be skipped. Click on the parameter to expand more details.

limitinteger<int32>[0, 10000]query

Maximum number of items to return.

selectobject | nullquery

Specify a comma-separated list of fields to include into response or leave it undefined to get default set of fields. This parameter accepts values of the following format: {field}{path?}{as alias?}, so you can do.

Response

200OK

Successful response.

400Bad Request

Invalid request.

Get historical ticket balances

curl -X GET 'https://xtz-index.nownodes.io/v1/tickets/historical_balances/{level}'

const response = await fetch('https://xtz-index.nownodes.io/v1/tickets/historical_balances/{level}', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://xtz-index.nownodes.io/v1/tickets/historical_balances/{level}')
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://xtz-index.nownodes.io/v1/tickets/historical_balances/{level}')
data = response.json()

const response = await fetch('https://xtz-index.nownodes.io/v1/tickets/historical_balances/{level}', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://xtz-index.nownodes.io/v1/tickets/historical_balances/{level}";
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://xtz-index.nownodes.io/v1/tickets/historical_balances/{level}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://xtz-index.nownodes.io/v1/tickets/historical_balances/{level}')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://xtz-index.nownodes.io/v1/tickets/historical_balances/{level}')
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)

[
  {
    "ticket": {
      "ticketer": {
        "address": "tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU"
      },
      "rawType": {
        "type": 0
      },
      "rawContent": {
        "type": 0
      }
    },
    "account": {
      "address": "tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU"
    }
  }
]

{
  "error": "Invalid request parameters."
}