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

400 Response

error string required
errorName string required
reqId string required

401 Response

error string required
errorName string required
reqId string required

403 Response

error string required
errorName string required
reqId string required

500 Response

error string required
errorName string required
reqId string required