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

Steps

  • API (market)
  • API (limit)
  • API (TWAP)
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

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 details on your placed order using either the Get Order endpoint or by subscribing to the Trade WebSocket:

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