List of assets

Retrieve market data for fiat currencies, wrapped tokens, staked tokens, commodities, indices, and stocks in one request. Use this endpoint to build asset directories, market overviews, search filters, or comparison views that include financial assets beyond regular cryptocurrencies.

Assets are grouped by type, making it easy to display each category separately or request only the categories relevant to your application. Each asset includes its current price, market cap, 24-hour volume and price change, sparkline, all-time high, icon, and Coinranking page URL. Monetary values can be converted to a reference currency of your choice.

https://api.coinranking.com/v2/assets

Query parameters

Parameter Description
types (optional) String[]

Asset types to include. By default, all asset types are selected. The response always includes every asset-type array; arrays that were not requested are returned empty.

Allowed values: fiat wrapped staked commodities indices stocks

Example:
https://api.coinranking.com/v2/assets?types[]=commodities&types[]=stocks
referenceCurrencyUuid (optional) String

UUID of the currency in which all prices, market caps, volumes, sparklines, and all-time-high prices are calculated. Defaults to US Dollar, but you can use any supported reference currency. You can find UUIDs in the dedicated reference currency endpoint.

Default value: yhjMzLPhuIDl

Example:
https://api.coinranking.com/v2/assets?referenceCurrencyUuid=Qwsogvtv82FCd
limit (optional) Number

Limit used for pagination. It applies separately to every selected asset-type array. For example, a limit of 10 can return up to 10 fiat currencies and 10 stocks in the same response. The maximum is 5000 for the Startup and Professional plan, and 100 for the Free plan.

Default value: 50
Size range: 1-5000

Example:
https://api.coinranking.com/v2/assets?limit=10
offset (optional) Number

Offset used for pagination. The same offset is applied to every selected asset type. Deprecated — use cursor-based pagination instead. The maximum allowed offset is 5000. A non-zero offset cannot be combined with a cursor.

Default value: 0
Maximum value: 5000

Example:
https://api.coinranking.com/v2/assets?offset=50
cursor (optional) String

Cursor for pagination. Use the nextCursor value from the previous response to get the next grouped page, or previousCursor to navigate back. One cursor advances every selected asset-type array. Use it with the same types and limit values as the request that created it. See Pagination for more information.

Example:
https://api.coinranking.com/v2/assets?cursor=eyJ2ZXJzaW9uIjoxLC...

Code examples

Response

json
HTTP/1.1 200 OK
{
  "status": "success",
  "data": {
    "fiat": [
      {
        "uuid": "yhjMzLPhuIDl",
        "symbol": "USD",
        "name": "US Dollar",
        "type": "fiat",
        "color": "#2b9b5a",
        "iconUrl": "https://cdn.coinranking.com/kz6a7w6vF/usd.svg",
        "marketCap": "21697800000000",
        "price": "1",
        "listedAt": 1548111600,
        "change": "0",
        "sparkline": ["1", "1", "1"],
        "allTimeHigh": {
          "price": "1",
          "timestamp": 1548111600
        },
        "24hVolume": null,
        "coinrankingUrl": "https://coinranking.com/fiat/yhjMzLPhuIDl+us-dollar-usd"
      }
    ],
    "wrapped": [],
    "staked": [],
    "commodities": [],
    "indices": [],
    "stocks": [
      {
        "uuid": "stock-uuid",
        "symbol": "AAPL",
        "name": "Apple",
        "type": "stocks",
        "color": null,
        "iconUrl": "https://cdn.coinranking.com/apple.svg",
        "marketCap": "3000000000000",
        "price": "220.12",
        "listedAt": 1751328000,
        "change": "1.24",
        "sparkline": ["217.43", "219.01", "220.12"],
        "allTimeHigh": {
          "price": "260.10",
          "timestamp": 1767139200
        },
        "24hVolume": "5400000000",
        "coinrankingUrl": "https://coinranking.com/stocks/stock-uuid+apple-aapl"
      }
    ]
  },
  "pagination": {
    "limit": 10,
    "hasNextPage": true,
    "hasPreviousPage": false,
    "nextCursor": "eyJ2ZXJzaW9uIjoxLC...",
    "previousCursor": null
  }
}

Response fields

Property Description
status String

Status of the request

Allowed values:
success
data Object

Assets grouped by type. The response does not include aggregate statistics or ranks.
data.fiat Object[]

List of fiat currencies. The array is empty when fiat was not requested or has no results on the current page.
data.wrapped Object[]

List of wrapped tokens. The array is empty when wrapped was not requested or has no results on the current page.
data.staked Object[]

List of staked tokens. The array is empty when staked was not requested or has no results on the current page.
data.commodities Object[]

List of commodities. The array is empty when commodities were not requested or have no results on the current page.
data.indices Object[]

List of market indices. The array is empty when indices were not requested or have no results on the current page.
data.stocks Object[]

List of stocks. The array is empty when stocks were not requested or have no results on the current page.
data.*.uuid String

UUID of the asset
data.*.symbol String/null

Currency or ticker symbol of the asset. Returns null when no symbol is available.
data.*.name String

Name of the asset
data.*.type String

Type of the asset and the name of the array in which it is returned

Allowed values: fiat wrapped staked commodities indices stocks
data.*.color String/null

Main HEX color of the asset. Returns null when no color is available.
data.*.iconUrl String/null

Location of the icon. Replace .svg with .png or .webp, optionally with ?size=WIDTHxHEIGHT (e.g. ?size=28x28) to control dimensions. Returns null when no icon is available. See Icons for more details.
data.*.marketCap String/null

Market capitalization expressed in the selected reference currency. Returns null when no market-cap data is available.
data.*.price String/null

Current price expressed in the selected reference currency. Returns null when no price is available.
data.*.listedAt Number/null

Epoch timestamp in seconds of when we started listing the asset. Returns null when the listing time is unknown.
data.*.change String/null

Price change percentage over the last 24 hours. Returns null when the change cannot be calculated.
data.*.sparkline (String/null)[]

Array of prices over the last 24 hours, expressed in the selected reference currency and useful for displaying a sparkline. Missing price points are returned as null.
data.*.allTimeHigh Object

The highest recorded price of the asset and when it was reached
data.*.allTimeHigh.price String/null

The highest recorded price expressed in the selected reference currency. Returns null when no all-time-high data is available.
data.*.allTimeHigh.timestamp Number/null

Epoch timestamp in seconds of when the asset reached its highest price. Returns null when no all-time-high data is available.
data.*.24hVolume String/null

Trading volume over the last 24 hours, expressed in the selected reference currency. Returns null when no volume data is available.
data.*.coinrankingUrl String

Location of the type-specific asset page on coinranking.com
pagination Object

Pagination information shared by all selected asset types. See Pagination for more details.
pagination.limit Number

The maximum number of results requested for each selected asset type
pagination.hasNextPage Boolean

Whether at least one selected asset type has more results after the current page
pagination.hasPreviousPage Boolean

Whether a previous grouped page is available
pagination.nextCursor String/null

Cursor to use for the next grouped page, or null when none of the selected asset types has more results
pagination.previousCursor String/null

Cursor to use for the previous grouped page, or null when the current page is the first page

Error response

json
HTTP/1.1 422 Unprocessable Entity
{
  "status": "fail",
  "type": "INVALID_CURSOR",
  "message": "The provided cursor is invalid or malformed"
}

Error responses

Previous

Bulk coins

 Next

Playground

On this page