REST API›Trade›Orders

GET

Get Trade

Get the details of a single trade by trade id.

Requires access token scope: trade_view

Path Params

  • accountId string required
    The ID of the account
  • tradeId string required
    The id of the trade to retrieve

Responses

200
A trade

Response Body

object

  • 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 enum required
    The side of the order
    buysell
  • 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 enum 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 for more details on each funding type.

    Defaults to funded

    marginfunded
  • settled boolean required
  • settleDate string date-time nullable
    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
Bad request - Invalid trade ID

Response Body

object

  • 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.
    context object
    • 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
Unauthorized - Invalid or missing authentication

Response Body

object

  • 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.
    context object
    • 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
Forbidden - Insufficient permissions

Response Body

object

  • 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.
    context object
    • 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
Not Found - Trade does not exist

Response Body

object

  • 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.
    context object
    • 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
Internal Server Error

Response Body

object

  • 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.
    context object
    • 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.