Place Trade Orders

Overview

Once you deposit funds into your trading account, you can place the following trade orders:

• Market - An immediate order at the current market value.
• Limit - A pending order at a value your specify. The order executes only if the market value reaches the specified price during the specified duration.
• Time-weighted average price (TWAP) - An order for the average price over a specified duration.

To complete a trade order, you must build an unsigned trade payload. This payload authorizes moving the funds from your trading account to the counterparty's trading account. BitGo reserves the funds until the order completes. Trading transactions abide by your enterprise and wallet policies, and must receive all required signatures and approvals.

Prerequisites

• Get Started
• Set Up Trading Account

Steps

Copy code block
1
2
3
4
5
6
7
8
9
10
POST /api/prime/trading/v1/accounts/{accountId}/orders

{
  "clientOrderId": "myorder1",
  "type": "market",
  "product": "TBTC-TFIATUSD",
  "side": "buy",
  "quantity": "10000",
  "quantityCurrency": "TFIATUSD"
}

Step Result

Copy code block
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "id": "67fd640c-cb6c-4218-80ae-49e79ec15646",
  "accountId": "60e740e7898f7d00064d43769a73dc48",
  "clientOrderId": "myorderid1",
  "time": "2021-08-05T18:05:23.431Z",
  "creationDate": "2021-08-05T18:05:22.286Z",
  "scheduledDate": "2021-08-05T18:05:00.000Z",
  "lastFillDate": "2021-08-05T18:05:23.302Z",
  "completionDate": "2021-08-05T18:05:23.431Z",
  "settleDate": "2021-08-05T20:00:00.000Z",
  "fundingType": "funded",
  "type": "market",
  "status": "completed",
  "product": "TBTC-TFIATUSD",
  "side": "buy",
  "quantity": "1000",
  "quantityCurrency": "TFIATUSD",
  "filledQuantity": "0.02457152",
  "averagePrice": "40697.32"
}

Next Steps

You can view order details using either the Get Order endpoint or by subscribing to the Trade WebSocket:

• API Reference: Get Order
• View Live Order and Market Data Updates

Note: You can cancel an open trade order, but you can't update it. If you want to edit an open trade order, cancel the order and place a new one.

See Also

API Reference: Place Order