Principal market price

What is this endpoint for?

This endpoint returns principal market value prices for crypto assets, helping with financial reporting under US-GAAP (FASB ASC 820), IFRS, and other major accounting frameworks. It determines the principal market using Kaiko's Exchange Ranking — a proprietary ranking of cryptocurrency exchanges based on criteria, including regulatory compliance, security, transparency and data quality — to determine the 20 eligible exchanges. Among these exchanges, the principal market is chosen based on the highest 2-week rolling average USD trading volume for the chosen asset.

Endpoint

https://us.market-api.kaiko.io/v2/data/trades.v1/principal_market_value

Query parameters

Parameter	Required	Description
asset		The desired base asset code
end_time		Ending time in ISO 8601 (exclusive) Automatically included in continuation tokens. Note: data is for the current quarter only.

Fields

Field	Description
timestamp	The time at which the value was calculated.
price	The Principal Market Value. Price represented in USD.
last_trade_timestamp	Timestamp of the trade corresponding to the Principal Market Value.
principal_market_name	Exchange name in which the trade has been executed, i.e. “principal market”.
principal_market_code	Exchange code in which the trade was executed, i.e. “principal market”.
adtv_2w	The two week average daily trading volume of the principal market (in base asset)
total_adtv_2w	The two week average daily trading volume among the eligible exchanges (in base asset)

Request examples

cURL

curl --compressed -H 'Accept: application/json' -H 'X-Api-Key: <client-api-key>' \
  'https://us.market-api.kaiko.io/v2/data/trades.v1/principal_market_value?end_time=2025-09-09T15:00:00.000Z&asset=btc'

Python

Response example

{
    "query": {
        "end_time": "2025-09-09T15:00:00Z",
        "asset": "btc",
        "data_version": "v1",
        "commodity": "principal_market_value",
        "request_time": "2025-09-15T13:00:08.391Z",
        "end_timestamp": 1757430000000
    },
    "time": "2025-09-15T13:00:08.494Z",
    "timestamp": 1757941208494,
    "data": [
        {
            "timestamp": 1757430000000,
            "last_trade_timestamp": 1757429999945,
            "price": 111764,
            "principal_market_name": "CRCO",
            "principal_market_code": "crco",
            "adtv_2w": 8135.835284285715,
            "total_adtv_2w": 16893.05731083857
        }
    ],
    "result": "success",
    "access": {
        "access_range": {
            "start_timestamp": 1454284800000,
            "end_timestamp": 1877896800000
        },
        "data_range": {
            "start_timestamp": 1454281200000,
            "end_timestamp": 1877896800000
        }
    }
}