Skip to main content
GET
/
v3
/
currencies
/
{id}
/
historical
Currency historical OHLC
curl --request GET \
  --url https://api.cryptorank.io/v3/currencies/{id}/historical \
  --header 'X-Api-Key: <api-key>'
[
  {
    "date": 1715000000000,
    "open": "65000.5",
    "high": "65500.123",
    "low": "64500.4",
    "avg": "65100.21",
    "close": "65200.7",
    "volume": "32400000000",
    "circulatingSupply": "19500000",
    "priceChangePercent": 0.31,
    "volumeChangePercent": 0.42,
    "circulatingSupplyChangePercent": 0.001
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.cryptorank.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
id
integer
required

Numeric coin id.

Example:

1

Query Parameters

​
interval
enum<string>
default:day

Aggregation interval.

Available options:
day,
week,
month
​
from
string
required

Range start (ISO 8601 or Unix timestamp in seconds/milliseconds).

Example:

"2025-01-01"

​
to
string

Range end (ISO 8601 or Unix timestamp in seconds/milliseconds). Defaults to now.

​
limit
number
default:5000

Maximum number of candles returned. For wider windows shift from and re-query.

Required range: 1 <= x <= 5000

Response

​
date
number
required

Bucket start, Unix milliseconds.

Example:

1715000000000

​
open
string
required

USD price at bucket open.

Example:

"65000.5"

​
high
string
required

Highest USD price during the bucket.

Example:

"65500.123"

​
low
string
required

Lowest USD price during the bucket.

Example:

"64500.4"

​
avg
string
required

Average USD price across the bucket.

Example:

"65100.21"

​
close
string
required

USD price at bucket close.

Example:

"65200.7"

​
volume
string
required

24-hour trading volume in USD reported at bucket close.

Example:

"32400000000"

​
circulatingSupply
string
required

Circulating supply at bucket close.

Example:

"19500000"

​
priceChangePercent
number
required

Percent price change within the bucket: (close - open) / open * 100.

Example:

0.31

​
volumeChangePercent
object
required

Percent change of volume vs the previous bucket. Null when no previous bucket exists.

Example:

0.42

​
circulatingSupplyChangePercent
object
required

Percent change of circulatingSupply vs the previous bucket. Null when no previous bucket exists.

Example:

0.001