Orders

Place RFQ Order

Changed on

Places an order priced off a previously accepted RFQ quote.

The request carries only the quoteId: the agreed price, quantity, side and product are already persisted on the quote. The order executes fill-or-kill at the quote's price.

A quote can fund exactly one order. Placing an order on an expired or already-used quote fails.

post/api/prime/trading/v1/accounts/{accountId}/rfq/order

Request

  • Base URL
    https://developers.bitgo.com
  • URL
    https://developers.bitgo.com/api/prime/trading/v1/accounts/{accountId}/rfq/order
  • Auth
    none declared

Path parameters

accountIdstring required

The ID of the account

Request body

quoteIdstring uuid required

ID of the RFQ quote to execute. The quote must be unexpired and not already used.

Example request

{
  "quoteId": "68ade562-5e4d-4efc-83d0-9b76aa6bf88a"
}

Response

An RFQ order

idstring uuid required

Unique identifier for the order. Used to reference the order in other endpoints.

accountIdstring required

The ID of the account

enterpriseIdstring required
initiatedByUserIdstring required
canceledByUserIdstring required
clientOrderIdstring required

Custom order ID provided by the client. This must be a unique ID for each individual order and cannot be the same across multiple requests. Can be used to ensure idempotency of order requests.

timestring date-time required
creationDatestring date-time required
scheduledDatestring date-time required

Date to schedule the order. If not provided, the order will be placed immediately.

lastFillDatestring date-time required
completionDatestring date-time required
settleDatestring date-time required
fundingType'margin' | 'funded' 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.
type'market' | 'twap' | 'limit' | 'steady_pace' | 'stop' | 'rfq' required

The type of order to be placed. See our Trade Guide for more details on each order type.

timeInForce'GTC' | 'IOC' | 'FOK' | 'GTD' required

Time in force policy for the order.

  • GTC (Good Till Cancelled): Order remains active until filled or cancelled.
  • IOC (Immediate or Cancel): Order fills as much as possible immediately, any unfilled remainder is cancelled.
  • FOK (Fill or Kill): The entire order must be filled immediately or it is cancelled completely. Unlike IOC, no partial fills are accepted.
  • GTD (Good Till Date): Order remains active until filled, cancelled, or the specified duration expires. Requires duration to be set.
status'pending_open' | 'open' | 'completed' | 'pending_cancel' | 'canceled' | 'error' | 'scheduled' required
reason'internalError' | 'insufficientFunds' required

Reason for order cancellation. 'internalError' indicates an error occurred within the server while processing the order, resulting in an order cancellation. 'insufficientFunds' indicates that the order was cancelled due to shortage of funds to complete the transaction.

reasonDescriptionstring required
productstring required

Product name e.g. BTC-USD (base-quote)

side'buy' | 'sell' required

The side of the order

quoteIdstring uuid

ID of the RFQ quote the order was placed from. Present only on orders placed via the RFQ endpoint.

quantitystring decimal required

The specified quantity.

quantityCurrencystring required

The specified quantity currency.

filledQuantitystring decimal required

The total base quantity filled.

filledQuoteQuantitystring decimal required

The total quote quantity filled.

leavesQuantitystring decimal required

For orders created with base currency, this field is set to the remaining unfilled base quantity.

  • Only one of leavesQuantity or leavesQuoteQuantity will be set.
  • This field is set to null for orders created with quote currency.
leavesQuoteQuantitystring decimal required

For orders created with quote currency, this field is set to the remaining unfilled quote quantity.

  • Only one of leavesQuantity or leavesQuoteQuantity will be set.
  • This field is set to null for orders created with base currency.
averagePricestring decimal required

The average price for the order's trades.

limitPricestring decimal required

The limit price. It always refers to the quote currency.

  • It's maximum precision is determined by the product's quoteDisplayPrecision field, which can be fetched from the list products endpoint.
triggerPricestring decimal

The trigger price for stop orders. When the market reaches this price, the stop order is activated.

  • For buy stop-limit orders, triggerPrice must be less than or equal to limitPrice.
  • For sell stop-limit orders, triggerPrice must be greater than or equal to limitPrice.
  • It always refers to the quote currency.
durationinteger required

Duration of the order in minutes.

twapIntervalinteger required

Interval length of the TWAP order in minutes.

rtIdstring required

The request tracking ID associated with the order.

notesstring required

Additional notes associated with the order.

Example response

{
  "id": "67fd640c-cb6c-4218-80ae-49e79ec15646",
  "accountId": "60e740e7898f7d00064d43769a73dc48",
  "enterpriseId": "129841a2143f99c3229c1f4x590396b4",
  "initiatedByUserId": "1203c28030c4320a4b90255b4683ecq6",
  "canceledByUserId": null,
  "clientOrderId": "myorderid1",
  "time": "2025-11-25T23:12:18.210507Z",
  "creationDate": "2025-11-25T23:12:18.210507Z",
  "scheduledDate": null,
  "lastFillDate": "2025-11-25T23:12:17.642764Z",
  "completionDate": "2025-11-25T23:12:17.642764Z",
  "settleDate": null,
  "fundingType": "funded",
  "type": "market",
  "timeInForce": null,
  "status": "completed",
  "reason": null,
  "reasonDescription": null,
  "product": "BTC-USD",
  "side": "buy",
  "quantity": "1000",
  "quantityCurrency": "USD",
  "filledQuantity": "0.02457152",
  "filledQuoteQuantity": "1000",
  "leavesQuantity": null,
  "leavesQuoteQuantity": "0",
  "averagePrice": "40697.32",
  "limitPrice": null,
  "triggerPrice": null,
  "duration": null,
  "twapInterval": null,
  "rtId": null,
  "isFinanced": false,
  "notes": null
}

Changes

  • df6644551827Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • c91f30eef223Revision changes
    • info

      endpoint added