marketoverview.v1.MarketOverviewService
GetSpotVolumeHistory
Get aligned pair-level and total trailing-24h USD volume, sampled every 15 minutes over the latest day. Unavailable valuations fail the request.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/marketoverview.v1.MarketOverviewService/GetSpotVolumeHistory' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"symbolId": [
1
]
}'Responses
{
"bucket": "1m",
"endTsSec": 1735689600,
"pairs": [
{
"symbolId": 1,
"volumeUsdScaled": [
"123456"
]
}
],
"points": 1,
"startTsSec": 1735689600,
"totalVolumeUsdScaled": [
"123456"
]
}marketoverview.v1.GetSpotVolumeHistoryRequestmarketoverview.v1.GetSpotVolumeHistoryResponsePair IDs from GetSpotConfig; empty selects every configured pair separately. At most 2000 distinct positive IDs. Unknown IDs are rejected. If the full universe exceeds 2000 pairs, specify a filter; results are never truncated.
Sampling interval between points; currently always "15m".
First sample timestamp in seconds since Unix epoch (UTC), inclusive.
Last sample timestamp in seconds since Unix epoch (UTC), inclusive.
Number of aligned values in every pair array and the total array; always 97.
Stable numeric pair ID; clients may group these series by base asset.
Trailing-24h USD amounts scaled by 1e6, oldest first. Exactly points values, aligned with the shared response grid. Zero means no executed trades in the window. USD values round down once per contributing 15-minute bucket.
Sum across selected pairs, USD scaled by 1e6. Exactly points values, oldest first. REST renders decimal strings in totalVolumeUsd. Do not sum overlapping trailing-24h samples to obtain period traded volume.
| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| bad-request | 400 | invalid_argument | Bad Request | Bad request. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Service Unavailable | Service unavailable. |
| upstream-error | 502 | unavailable | Upstream Error | Upstream error. |