Retrieve Market Information

This endpoint allows users to get detailed market data for a given asset identified by its id. It provides information on exchange details, trading volume, price, and the relationship between base and quote assets.

GET /assets/{id}/markets

Try it

Retrieve market information for a specific asset

cURL

curl --request GET \
  --url https://api.coincap.io/v2/assets/{id}/markets \
  --header 'Authorization: Bearer <token>'

200

{
  "exchangeId": "<string>",
  "baseId": "<string>",
  "quoteId": "<string>",
  "baseSymbol": "<string>",
  "quoteSymbol": "<string>",
  "volumeUsd24Hr": 123,
  "priceUsd": 123,
  "volumePercent": 123
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

The asset ID to fetch market data for (e.g., bitcoin).

Example:

"bitcoin"

Query Parameters

limit · integer · default: 5

The maximum number of results to return

Required range: x <= 2000

offset · integer · default: 1

The index of the first result to return (useful for pagination)

Response

200 - application/json

Successfully retrieved market data

exchangeId · string

A unique identifier for the exchange

baseId · string

The unique identifier for the base asset (the asset being purchased)

quoteId · string

The unique identifier for the quote asset (the asset used to purchase the base asset)

baseSymbol · string

The most common symbol used to identify the base asset

quoteSymbol · string

The most common symbol used to identify the quote asset

volumeUsd24Hr · number

The volume of the base asset transacted on this market in the last 24 hours (in USD)

priceUsd · number

The price of one unit of the base asset, denominated in the quote asset

volumePercent · number

The percentage of the total quote asset volume in this market