Currencies

Historical Market Data

Description

Market state of all tracked coins at a given point in time: price, market cap, volume and circulating supply.

Note: storedTime is the actual timestamp of the returned values, which may differ slightly from the requested date.

Note: A date deeper than your plan allows returns 403 PLAN_LIMIT_EXCEEDED — Advanced 2y, Pro 5y, Business 10y.

Tip: For the history of a single coin use /currencies/:id/sparkline.

Access

  • Available from: Advanced
  • Cost: 1 credit per request
get/v3/currencies/historical

Request

  • Base URL: https://api.cryptorank.io
  • URL: https://api.cryptorank.io/v3/currencies/historical
  • Auth: API key in header X-Api-Key

Query parameters

pagenumber

Page number (1-based). Returns up to 100 items per page.

datestring required
Example:2024-01-15

Point in time to return market data for. Accepted: ISO 8601, bare date (YYYY-MM-DD), or Unix timestamp in seconds or milliseconds. Must not be in the future. Bounded by your plan's history limit — Advanced 2y, Pro 5y, Business 10y.

currencyIdsstring
Example:1,1027

Comma-separated coin IDs, up to 100. See: GET /v3/currencies/map.

sortBy'id' | 'rank' | 'price' | 'marketCap' | 'volume24h'

Sort field: id | rank | price | marketCap | volume24h.

sortOrder'asc' | 'desc'

Sort direction. For rank, asc puts top-1 first.

convertstring

Fiat ISO code for monetary fields (e.g. USD, EUR, RUB, AED). See: GET /v3/fiat/list.

Response

Example response

{
  "data": [
    {
      "circulatingSupply": "19500000",
      "id": 1,
      "marketCap": "835000000000",
      "name": "Bitcoin",
      "price": "42750.5",
      "slug": "bitcoin",
      "storedTime": 1705320000000,
      "symbol": "BTC",
      "volume24h": "21000000000",
      "volume24hBase": "490000"
    }
  ],
  "meta": {
    "hasNextPage": true,
    "page": 1,
    "pageSize": 25
  },
  "status": {
    "timestamp": 1780000000000,
    "usedCredits": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.