Statistics API

v1.0.0

Base URL

https://api.nownodes.io

Authentication

api-keyAuthapiKey

Authentication token used to authorize API requests. This token can be obtained from the Statistics tab in your personal account dashboard. Note: The Statistics tab is available starting from the Business tariff plan.

API Key: token in header

General

Statistics API

Get subscription and usage statistics

GET

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

Returns subscription details and request usage statistics for the provided token (available from Business plan).

Response

200OK

Successful response with subscription and usage statistics.

401Unauthorized

Invalid or missing token.

403Forbidden

Token does not have access to this endpoint.

500Internal Server Error

Internal server error.

Authorization

api-keyAuthapiKey in header

Get subscription and usage statistics

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

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

const data = await response.json();

import requests

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

{
  "subscription_type": "business",
  "activated_at": "2026-06-08T09:56:00.000Z",
  "expires_at": "2026-07-08T09:56:38.745Z",
  "used_requests_per_month": 203643,
  "overage_requests_per_month": 0,
  "request_limit_per_month": 30000000,
  "remaining_requests_per_month": 29796357,
  "usage_percent_per_month": 1
}

{
  "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"
}

Get list of API keys

GET

https://api.nownodes.io/v1.0/api-keys

Returns the current tariff name and a list of API keys with optional filtering by status and sorting by call count.

Parameters

calls_count_orderstringascdescquery

Specifies the sort order of the results based on the total number of API calls. Use asc for ascending or desc for descending order.

is_activebooleanquery

Filters the results to include only API keys with the specified active status. Set to true for active keys or false for inactive keys.

Response

200OK

Successful response containing the tariff name and a list of API keys.

400Bad Request

Bad Request — One or more query parameters are invalid.

401Unauthorized

Invalid or missing token.

403Forbidden

Token does not have access to this endpoint.

500Internal Server Error

Internal server error.

Authorization

api-keyAuthapiKey in header

Get list of API keys

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

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

const data = await response.json();

import requests

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

{
  "tariff_name": "business",
  "api_keys": [
    {
      "id": 26953,
      "api_key_name": "[email protected](1)",
      "is_active": false,
      "calls_count": 400,
      "created_at": "2026-05-13T11:59:14.270Z"
    },
    {
      "id": 26954,
      "api_key_name": "[email protected](2)",
      "is_active": true,
      "calls_count": 500,
      "created_at": "2026-05-18T10:15:31.996Z"
    },
    {
      "id": 26955,
      "api_key_name": "[email protected](3)",
      "is_active": true,
      "calls_count": 30201500,
      "created_at": "2026-05-18T10:15:33.485Z"
    },
    {
      "id": 26982,
      "api_key_name": "[email protected](4)",
      "is_active": true,
      "calls_count": 546,
      "created_at": "2026-05-27T15:40:52.169Z"
    }
  ]
}

{
  "message": "calls_count_order must be asc/desc",
  "error": "Bad Request",
  "statusCode": 400
}

{
  "message": "is_active must be true/false",
  "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"
}

Retrieve usage statistics

GET

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

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.

Authorization

api-keyAuthapiKey in header

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();

import requests

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

{
  "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"
}

Documentation

Authentication

General

Statistics API

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization