REST
GET
/api/v1/user/trades/{startDate}/{endDate}/{page}/{pageSize}Get Trades Paginated
Retrieve a paginated list of trades filtered by date range. Maximum date range is 7 days.
Auth:Bearer <api_key>
Tags:Trades
Request
cURL
curl -G https://publicapi.sandbox.hercle.financial/api/v1/user/trades/{startDate}/{endDate}/{page}/{pageSize} \
-H "Authorization: Bearer eyJhb..." \
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| startDate | string | Yes | Start date for filtering trades (ISO 8601 format). Maximum range: 7 days from end date. Example: 2025-12-01T00:00:00Z |
| endDate | string | Yes | End date for filtering trades (ISO 8601 format). Maximum range: 7 days from start date. Example: 2025-12-05T23:59:59Z |
| page | number | Yes | Page number for pagination (starting from 0) Example: 0 |
| pageSize | number | Yes | Number of items per page (min: 5, max: 50) Example: 5 |
Headers
| Name | Type | Required | Description |
|---|---|---|---|
| Authorization | string | Yes | Bearer token for authentication |
Response
Success Response Schema
List of trades retrieved successfully
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the trade |
clientId | string | Client identifier associated with the trade |
userId | string | User identifier who executed the trade |
instrument | string | Trading instrument (e.g., BTC/USDT) |
side | string | Trade side Allowed values: buysell |
price | number | Execution price |
quantityFilled | number | Quantity filled in the trade |
timestamp | string | ISO 8601 timestamp of trade execution |
email | string | Email address of the user |
Responses
List of trades retrieved successfully
200 application/json
[
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"clientId": "client_001",
"userId": "987e6543-e21b-12d3-a456-426614174001",
"instrument": "BTC/USDT",
"side": "buy",
"price": 50000,
"quantityFilled": 0.1,
"timestamp": "2024-06-01T12:00:00Z",
"email": "john.doe@example.com"
}
]API Tester
Test this endpoint directly against the sandbox environment
Get your API key from Hercle Sandbox
Start date for filtering trades (ISO 8601 format). Maximum range: 7 days from end date.
End date for filtering trades (ISO 8601 format). Maximum range: 7 days from start date.
Page number for pagination (starting from 0)
Number of items per page (min: 5, max: 50)
https://publicapi.sandbox.hercle.financial/api/v1/user/trades/{startDate}/{endDate}/{page}/{pageSize}