Returns historical trades for a market from flat files.
Retrieves historical trade data from flat files stored in external storage (S3).
Supports hourly granularity with automatic fallback to daily files.
Use either 'date' for full day or 'time_start'/'time_end' for specific time ranges.
The limit parameter applies in both cases (default 100, max 10000), including when date selects a full day.
Important: Results are filtered by data processing time (time_coinapi) - the time when CoinAPI received and processed the data from the exchange. Each trade also includes time_exchange showing when the trade actually occurred on the exchange. Due to API polling delays, time_exchange may be earlier than time_coinapi.
API Key is required to access the endpoints
In: header
Path Parameters
Query Parameters
Full day in ISO 8601 or YYYY-MM-DD (mutually exclusive with time_start/time_end)
Range start in ISO 8601 (required if date is omitted)
Range end in ISO 8601 (optional)
Maximum number of trades to return (1-10000, default 100). Applies even when date selects a full day.
int32100Response Body
curl -X GET "https://example.com/v1/activity/string/string/history/trades"[ { "id": "string", "market_id": "string", "price": 0.1, "quantity": 0.1, "timestamp": "2019-08-24T14:15:22Z", "outcome": "string", "side": "Buy" }]