My App

Get authenticated account's trade history

Retrieve the trade history for the authenticated account, optionally filtered by product and time range. Returns detailed information about each trade including fees and liquidity indicators.

Requires authentication.

GET
/trade-history
OBSIDIAN-KEY<token>

In: header

OBSIDIAN-SECRET<token>

In: header

Query Parameters

product_id?string

Product ID to filter trades by (e.g., "BTC-PERP", "ETH-PERP")

start_time?string

Optional: Start timestamp in nanoseconds for filtering trades (inclusive)

Formatuint64
end_time?string

Optional: End timestamp in nanoseconds for filtering trades (inclusive)

Formatuint64
page?string

Page number for pagination, starting at 1 (default: 1)

Formatint64
limit?string

Number of records per page (default: 100)

Formatint64

Response Body

application/json

application/json

curl -X GET "https://api.dev.obsidian.exchange/trade-history"
{
  "product_id": "string",
  "trades": [
    {
      "id": "string",
      "product_id": "string",
      "order_id": "string",
      "client_order_id": "string",
      "side": "BUY",
      "price": "string",
      "size": "string",
      "quote_size": "string",
      "fee_rate": "string",
      "fee_asset": "string",
      "fee_amount": "string",
      "liquidity_indicator": "MAKER",
      "created_at": "string"
    }
  ],
  "page": "string",
  "total": "string"
}
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string",
      "property1": null,
      "property2": null
    }
  ]
}