Get coin trading volume history
With the coin trading-volume-history endpoint you can retrieve a coin's historical trading volume. Each value is the total volume traded over the given interval, expressed in the reference currency (e.g. US Dollar or Bitcoin). Use this data to build volume charts, compare activity across periods, or analyze trends.
https://api.coinranking.com/v2/coin/:uuid/trading-volume-history
Path parameters
| Parameter | Description |
|---|---|
uuid String | UUID of the coin you want to request trading volume history for. A UUID is our unique identifier for each coin. You can find them in all our coin endpoints, or look them up in the find UUID page. |
Query parameters
| Parameter | Description |
|---|---|
referenceCurrencyUuid (optional) String |
UUID of the reference currency (fiat or crypto) in which volumes are expressed. You can find UUIDs in our coin endpoints or the reference currencies endpoint. Default value: yhjMzLPhuIDl (US Dollar)Example:
https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/trading-volume-history?referenceCurrencyUuid=5k-_VTxqtCEI
|
interval (optional) String |
The interval determines the time period over which each volume item is aggregated. Default value: dayAllowed values: hour day week month Example:
https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/trading-volume-history?interval=hour
|
limit (optional) Number |
Maximum number of history entries to return. For example, when interval=day and limit=30, data is returned for the last 30 days. The maximum is 5000 for the Startup and Professional plan, and 100 for the Free plan. Default value: 50Size range: 1-5000 Example:
https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/trading-volume-history?limit=100
|
Code examples
Response
jsonHTTP/1.1 200 OK
{
"status": "success",
"data": {
"history": [
{
"timestamp": 1770422400000,
"volume": "42791236212.35"
},
{
"timestamp": 1770508800000,
"volume": "27425856445.82"
},
{
"timestamp": 1770595200000,
"volume": "29311576049.00"
}
]
}
}
Response fields
| Property | Description |
|---|---|
status String | Status of the request Allowed values:success |
data Object | |
data.history Object[] | List of trading volume entries |
data.history.timestamp Number | An Epoch timestamp in seconds |
data.history.volume String/null | Trading volume over the interval in the reference currency. |
Error response
jsonHTTP/1.1 404 Not Found
{
"status": "fail",
"type": "COIN_NOT_FOUND",
"message": "Coin not found"
}
Previous
Next