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 trades with a trade date that is greater than or equal to the given timestamp
  • dateLtstring<date-time>
    Return trades with a trade date that is less than the given timestamp
  • creationDateGtestring<date-time>
    Return trades with a creation date that is greater than or equal to the given timestamp
  • creationDateLtstring<date-time>
    Return 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,"settleDate":"2025-11-27T10:00:00.0000Z","accountId":"66fdc289c4f722d994fedj8021f5ffb1","enterpriseId":"59cd72485007a239fb00282ed480da1f"}
id string <uuid>required
orderId string <uuid>required
time string <date-time>required
The date when the trade occurred
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
Filled price, e.g. For BTC-USD product, 90000.00 USD
quoteQuantity string <decimal>required
Filled quote quantity, e.g. For BTC-USD product, 100.50 USD
quantity string <decimal>required
Filled 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
settleDate
string or null
<date-time>
The date when the trade was settled. Null if not yet settled.
accountId string required
The ID of the account
enterpriseId string required
The BitGo enterprise ID associated with this trade

400 Response

error string required
errorName string required
reqId string required
context object
Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
errorName string required
Same value as the top-level errorName.
field string
Request field associated with the validation failure.
message string
Human-readable field-level validation message.

401 Response

error string required
errorName string required
reqId string required
context object
Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
errorName string required
Same value as the top-level errorName.
field string
Request field associated with the validation failure.
message string
Human-readable field-level validation message.

403 Response

error string required
errorName string required
reqId string required
context object
Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
errorName string required
Same value as the top-level errorName.
field string
Request field associated with the validation failure.
message string
Human-readable field-level validation message.

500 Response

error string required
errorName string required
reqId string required
context object
Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
errorName string required
Same value as the top-level errorName.
field string
Request field associated with the validation failure.
message string
Human-readable field-level validation message.