Retrieve usage statistics

GET

https://api.nownodes.io/v1.0/statistics

Authorizations

ApiKeyAuthApiKeyAuth

token string

NOWNodes API key passed in the api-key header.

Returns detailed statistics about API requests made using your API keys. This endpoint provides information about request counts, types, dates, and blockchain nodes used.

Parameters

current_subscriptionbooleantruefalserequiredquery

Determines the time period for statistics:

true - displays statistics for the active (current) subscription period only
false - displays statistics from the first request record to today's date

blockchain_tickerArray<string>adaaktalgoALPHaptarbardrARKATLAatomauroraavaxaxlBABYbandbasebchbdagBERAblastBLDbnbbsvbtcbtgcelocfxclocmpcorecoreumcsprdashdcrdgbdividogedotdot-assethubegldeosetcethethwfetfiat-ratesfilfiroflrFLUXftmglmrgrsHBARHypeicxinjinj-indexeriotakaiakaskavakmdksmksm-assethublinealskltclunalunclyxmarket-datamaticMetisMONmtrnanonearneooneontoposmopivxplsqieQTUMQTUM-testnetrskrvnSSEIshibsolSorobanSoroban TestnetstraxstrdstrkSTXsuisysTAOthetatiatomotontrxUnichainVCvetWemixxdcxecxemxlayerxlmxmrxplxrdxrpxrp-evmxtzxvgzeczenzetazilzkquery

Filter statistics by specific blockchain ticker(s). Multiple values can be provided as an array.

request_typestringhttpwssquery

Filter statistics by the type of API request. http for HTTP requests or wss for WebSocket connections.

api_keystringquery

Filter statistics by a specific API key name. The value should match the exact name of the API key.

date_fromstring<date>query

The start date for the statistics period (inclusive). Date format: YYYY-MM-DD. Constraints depend on current_subscription:

If current_subscription=true: date cannot be earlier than the subscription start date
If current_subscription=false: date cannot be earlier than the first request record date

date_tostring<date>query

The end date for the statistics period (inclusive). Date format: YYYY-MM-DD. Constraints depend on current_subscription:

If current_subscription=true: date cannot be later than the subscription end date
If current_subscription=false: date cannot be later than today's date

calls_count_orderstringascdescquery

Sort order for the results based on the number of API calls. asc for ascending (lowest first) or desc for descending (highest first).

date_orderstringascdescquery

Sort order for the results based on the date. asc for chronological order (oldest first) or desc for reverse chronological order (newest first).

Response

200OK

Successful response containing usage statistics.

400Bad Request

Bad Request — One or more query parameters are invalid or missing.

401Unauthorized

Invalid or missing token.

403Forbidden

Token does not have access to this endpoint.

500Internal Server Error

Internal server error.

Retrieve usage statistics

curl -X GET 'https://api.nownodes.io/v1.0/statistics'

const response = await fetch('https://api.nownodes.io/v1.0/statistics', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://api.nownodes.io/v1.0/statistics')
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://api.nownodes.io/v1.0/statistics')
data = response.json()

const response = await fetch('https://api.nownodes.io/v1.0/statistics', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://api.nownodes.io/v1.0/statistics";
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://api.nownodes.io/v1.0/statistics', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://api.nownodes.io/v1.0/statistics')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://api.nownodes.io/v1.0/statistics')
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)

{
  "period": {
    "from": "2025-05-10",
    "to": "2026-06-15"
  },
  "total_requests": 510,
  "details": [
    {
      "api_key_name": "[email protected](4)",
      "request_type": "http",
      "date": "2026-06-05",
      "blockchain_ticker": "tomo",
      "calls_count": 10
    },
    {
      "api_key_name": "[email protected](4)",
      "request_type": "http",
      "date": "2026-06-04",
      "blockchain_ticker": "tomo",
      "calls_count": 250
    },
    {
      "api_key_name": "[email protected](4)",
      "request_type": "http",
      "date": "2026-05-28",
      "blockchain_ticker": "tomo",
      "calls_count": 250
    }
  ]
}

{
  "message": [
    "current_subscription should not be null or undefined",
    {
      "current_subscription must be one of the following values": "true, false"
    },
    {
      "request_type must be one of the following values": "http, wss"
    },
    {
      "calls_count_order must be one of the following values": "asc, desc"
    },
    {
      "date_order must be one of the following values": "asc, desc"
    }
  ],
  "error": "Bad Request",
  "statusCode": 400
}

{
  "message": "Invalid or missing token",
  "error": "Unauthorized",
  "statusCode": 401
}

{
  "message": "This token does not have access to the endpoint",
  "error": "Forbidden",
  "statusCode": 403
}

{
  "statusCode": 500,
  "message": "Internal server error"
}