Skip to main content
GET
List Order Trades

Overview

Retrieve all trades (fills) associated with a specific order. This is useful for seeing how a partially filled or fully filled order was executed across multiple trades. This endpoint requires authentication with an API key that has Read scope.

Authentication

X-Api-Key
string
required
Your API key with Read or Trade scope

Path Parameters

order_id
string
required
The unique order identifier (UUID)Example: 550e8400-e29b-41d4-a716-446655440000

Request Examples

Response

success
boolean
required
Indicates if the request was successful
message
string
required
Human-readable response message
data
array
required
Array of trade objects for the order
timestamp
string
ISO 8601 timestamp of the response

Success Response

Error Responses

Notes

  • You can only view trades for your own orders. Attempting to access trades for another user’s order will return a 404 response.
  • An order may have zero trades (if still open or cancelled before any fills), one trade, or many trades (if filled in multiple partial fills).
  • Trades are returned in chronological order.

Rate Limits

  • 100 requests per minute per API key

Next Steps

Get Order

View the order details

List Trades

View all your trades across orders