REST
GET
/api/v1/user/transactions/{startDate}/{endDate}/{page}/{pageSize}/historicalGet Historical Transactions Paginated
Retrieve a paginated list of historical transactions filtered by date range. Maximum date range is 30 days.
Auth:Bearer <api_key>
Tags:Transactions
Request
cURL
curl -G https://publicapi.sandbox.hercle.financial/api/v1/user/transactions/{startDate}/{endDate}/{page}/{pageSize}/historical \
-H "Authorization: Bearer eyJhb..." \
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| startDate | string | Yes | Start date for filtering transactions (ISO 8601 format). Maximum range: 30 days from end date. Example: 2025-12-01T00:00:00Z |
| endDate | string | Yes | End date for filtering transactions (ISO 8601 format). Maximum range: 30 days from start date. Example: 2025-12-31T23: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 transactions retrieved successfully
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the transaction |
userId | string | User identifier who owns the transaction |
sequence | number | Sequence number for transaction ordering |
type | number | Type of transaction 0→ Deposit1→ Withdrawal2→ Trade Fee |
asset | string | Asset code (e.g., BTC, USDT) |
amount | number | Transaction amount |
timestamp | string | ISO 8601 timestamp of transaction |
Responses
List of transactions retrieved successfully
200 application/json
[
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"userId": "987e6543-e21b-12d3-a456-426614174001",
"sequence": 1,
"type": 2,
"asset": "BTC",
"amount": 0.0005,
"timestamp": "2024-06-01T12:00:00Z"
}
]API Tester
Test this endpoint directly against the sandbox environment
Get your API key from Hercle Sandbox
Start date for filtering transactions (ISO 8601 format). Maximum range: 30 days from end date.
End date for filtering transactions (ISO 8601 format). Maximum range: 30 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/transactions/{startDate}/{endDate}/{page}/{pageSize}/historical