Ctrl+K

List Trades

get/api/prime/trading/v1/accounts/{accountId}/trades

Lists trades from the trading account. This will include trades that have not yet settled.

Path Parameters

  • accountIdstringRequired
    The ID of the account

Query Parameters

  • offsetinteger
  • limitinteger
  • orderIdstring<uuid>
    The orderId of the trades to retrieve
  • dateGtestring<date-time>
    Return exchange trades with a trade date that is greater than or equal to the given timestamp
  • dateLtstring<date-time>
    Return exchange trades with a trade date that is less than the given timestamp
  • creationDateGtestring<date-time>
    Return exchange trades with a creation date that is greater than or equal to the given timestamp
  • creationDateLtstring<date-time>
    Return exchange trades with a creation date that is less than the given timestamp
  • isSettledboolean
    Return trades based on settlement status. true for settled trades, false for unsettled trades.
  • fundingTypestringDefault: funded
    Filter by funding type. 'funded' for available balance, 'margin' for margin balance.
    Enum: margin funded

200 Response

data array[object] required
Example: {"id":"7e0c768e-2d16-4c1e-b39d-06fa20009397","orderId":"d50ec984-77a8-460a-b958-66f114b0de9b","time":"2025-11-26T15:27:35.1234Z","creationDate":"2025-11-26T15:27:41.5318Z","side":"buy","product":"BTC-USD","quoteQuantity":"100.50","price":"22333.33","quantity":"0.0045","fundingType":"funded","settled":true}
id string <uuid>required
orderId string <uuid>required
time string <date-time>required
The exchange trade date (when the trade occurred at the LP)
creationDate string <date-time>required
The date when the trade was created in our system
product string required
Product name e.g. BTC-USD
side string required
The side of the order
Allowed values: buy sell
Example: buy
price string <decimal>required
quoteQuantity string <decimal>required
Quote quantity, e.g. For BTC-USD product, 100.50 USD
quantity string <decimal>required
Base quantity, e.g. For BTC-USD product, 0.0045 BTC
fundingType string required
The funding type of the order. - Funded orders will be placed using the Go account balance. - Margin orders will be placed using the margin account balances. See our [Trade Guide](/docs/trade-overview) for more details on each funding type.
Allowed values: margin funded
Default: funded
settled boolean required

default Response

error string required
errorName string required
reqId string required