Currencies

Currency List with Market Data

Description

Returns a paginated market table of cryptocurrencies with key market metrics, with sorting, pagination and filters by coin set, category, market cap and 24h volume.

Note: Supports conversion via the convert parameter. Market cap and volume filters always apply to USD values.

Tip: Pass currencyIds to fetch a specific watchlist in one call instead of paging the whole market. Resolve tickers to ids once via /currencies/search.

Tip: Filter to one ecosystem’s projects with ecosystemId — get IDs from /ecosystems/list.

Access

  • Available from: Sandbox
  • Cost: 1 credit per request
get/v3/currencies/list

Request

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

Query parameters

pagenumber

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

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

Sort field.

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.

ecosystemIdnumber
Example:17

Filter to coins that are core projects of this ecosystem. See: GET /v3/ecosystems/list.

tagIdnumber
Example:12

Filter by coin tag. See: GET /v3/currencies/tags.

currencyIdsstring
Example:1,1027

Comma-separated coin IDs, up to 100. Restricts the list to these coins; unknown IDs are skipped. Resolve tickers via See: GET /v3/currencies/search.

categoryIdnumber
Example:37

Filter by coin category. See: GET /v3/currencies/categories.

minMarketCapnumber

Minimum market cap filter, USD.

maxMarketCapnumber

Maximum market cap filter, USD.

minVolume24hnumber

Minimum 24h volume filter, USD.

maxVolume24hnumber

Maximum 24h volume filter, USD.

Response

Example response

{
  "data": [
    {
      "circulatingSupply": "19700000",
      "id": 1,
      "imageUrl": "https://images.cryptorank.io/coins/150x150.bitcoin1524754012028.png",
      "marketCap": "1280000000000",
      "name": "Bitcoin",
      "price": "65000.5",
      "priceChangePercent24h": 2.34,
      "rank": 1,
      "slug": "bitcoin",
      "symbol": "BTC",
      "volume24h": "32000000000"
    }
  ],
  "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.