Get Trade

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

Get the details of a single trade by trade id.

Path Parameters

  • accountIdstringRequired
    The ID of the account
  • tradeIdstringRequired
    The id of the trade to retrieve

200 Response

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.

404 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.