Get current or historical fiat rates.

GET

https://kmdbook.nownodes.io/api/v2/tickers

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Modified in 0.6.0: fiat-rate currency selectors are bounded and rate fetching is hardened against throttling - the response shape is unchanged. Live on KMD fiat rates are unavailable: current rates answer 400 "No tickers found!", historical timestamps answer 200 with rates -1. Documented as it exists in 0.6.0.

Returns currency rates for the requested currency and date. If a rate is unavailable for the exact timestamp, the closest available rate can be returned. Responses include the actual rate timestamp. Without a currency parameter, all available currencies can be returned. A rate of -1 marks an unavailable or invalid currency for that timestamp.

Load estimate: Low to medium; specific currency lookups are cheap, while omitted currency and token lookups increase response size.

live-verified behavior:

Live: fiat rates are unavailable on the KMD instance - current rates answer HTTP 400 {"error":"No tickers found!"}, historical timestamps answer 200 with rates -1.

Parameters

currencystringquery

Optional currency code. When omitted, all available rates can be returned.

timestampinteger<int64>query

Unix timestamp for historical rates.

blockstringquery

Block height or hash whose timestamp should be used for historical rates.

tokenstringquery

Optional token symbol or contract/address key for token-specific rates.

Response

200OK

HTTP 200 Komodo Blockbook response for getFiatTicker.

400Bad Request

Domain or validation error. live-verified: JSON body {"error": "..."} (unknown block/transaction, invalid address, malformed broadcast hex, missing filter parameters).

401Unauthorized

Unauthorized: missing or invalid api-key header. The NOWNodes gateway returns the plain-text body "Unknown API_key".

405Method Not Allowed

Method Not Allowed: gateway-level response for unknown routes (and for the v1 GET broadcast route on this instance).

500Internal Server Error

Internal Server Error. live-verified on the deployed instance: JSON body {"error":"Internal server error"} (observed on /api/rawtx and invalid XPUB lookups).

Get current or historical fiat rates.

curl -X GET 'https://kmdbook.nownodes.io/api/v2/tickers/'

const response = await fetch('https://kmdbook.nownodes.io/api/v2/tickers/', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

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

const response = await fetch('https://kmdbook.nownodes.io/api/v2/tickers/', {
  method: 'GET',
});

const data = await response.json();

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

const data = await response.json();

import requests

response = requests.get('https://kmdbook.nownodes.io/api/v2/tickers/')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://kmdbook.nownodes.io/api/v2/tickers/')
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)

{
  "ts": 1788550806,
  "rates": {
    "usd": -1
  }
}

{
  "error": "No tickers found!"
}

{
  "error": "No tickers found!"
}

Unknown API_key

Method Not Allowed

{
  "error": "Internal server error"
}