MarketOverviewService
Get Spot Volume History
Get aligned columnar pair-level and total trailing-24h USD volume at 15-minute intervals over the latest day. Exactly 97 values per array and at most 2000 pairs. Unavailable valuations fail the request.
Request
curl --request GET \ \ --url 'https://api.testnet.polyester.com/v1/spot/markets/volume-history?symbolId=1' \ --header 'Accept: */*'
Responses
{
"bucket": "1m",
"endTsSec": 1735689600,
"pairs": [
{
"symbolId": 1,
"volumeUsd": [
"0.123456"
]
}
],
"points": 1,
"startTsSec": 1735689600,
"totalVolumeUsd": [
"0.123456"
]
}Stable pair IDs; repeat this parameter for multiple pairs. Empty selects all currently listed pairs. At most 2000 distinct positive IDs; unknown IDs are rejected.
Sampling interval between points; currently always "15m".
1mLast sample timestamp in seconds since Unix epoch (UTC), inclusive.
1735689600Stable pair ID. Pairs are ordered by ascending ID, each included exactly once.
1Trailing-24h USD volume as decimal strings. Exactly points values aligned with the shared grid, oldest first. Zero means no executed trades.
["0.123456"]Number of aligned values in every pair array and the total array; always 97.
1First sample timestamp in seconds since Unix epoch (UTC), inclusive.
1735689600Total trailing-24h USD volume as decimal strings. Exactly points values, oldest first, aligned with every pair. Index i maps to startTsSec + i * 900 seconds. Zero means no trades; unavailable valuations fail the request.
["0.123456"]| Key | Status | Error | When |
|---|---|---|---|
| unauthenticated | 401 | Unauthenticated | Authentication required. |
| permission-denied | 403 | Permission Denied | Permission denied. |
| invalid-argument | 400 | Invalid Argument | Invalid argument. |
| not-found | 404 | Not Found | Not found. |
| unavailable | 503 | Unavailable | Service unavailable. |