Get Historical Trades Paginated

Retrieve a paginated list of historical trades filtered by date range. Maximum date range is 30 days.

Auth:Bearer <api_key>

Tags:Trades

Request

cURL

curl -G https://publicapi.sandbox.hercle.financial/api/v1/user/trades/{startDate}/{endDate}/{page}/{pageSize}/historical \
  -H "Authorization: Bearer eyJhb..." \

Path Parameters

Name	Type	Required	Description
startDate	string	Yes	Start date for filtering historical trades (ISO 8601 format). Maximum range: 30 days from end date. Example: `2025-12-01T00:00:00Z`
endDate	string	Yes	End date for filtering historical trades (ISO 8601 format). Maximum range: 30 days from start date. Example: `2025-12-30T23: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: `buy` `sell`
`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

API Key

Get your API key from Hercle Sandbox

Path Parameters

startDate

Required

Start date for filtering historical trades (ISO 8601 format). Maximum range: 30 days from end date.

endDate

Required

End date for filtering historical trades (ISO 8601 format). Maximum range: 30 days from start date.

page

Required

Page number for pagination (starting from 0)

pageSize

Required

Number of items per page (min: 5, max: 50)

Request URL

https://publicapi.sandbox.hercle.financial/api/v1/user/trades/{startDate}/{endDate}/{page}/{pageSize}/historical