Get Trades by ClientId

Retrieve all trades associated with a specific client identifier.

Auth:Bearer <api_key>

Tags:Trades

Request

cURL

curl -G https://publicapi.sandbox.hercle.financial/api/v1/user/trades/{tradeClientId} \
  -H "Authorization: Bearer eyJhb..." \

Path Parameters

Name	Type	Required	Description
clientId	string	Yes	Unique client identifier to filter trades Example: `HercleX`

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

clientId

Required

Unique client identifier to filter trades

Request URL

https://publicapi.sandbox.hercle.financial/api/v1/user/trades/{tradeClientId}