otc

Approve OTC Trade

Authorize an OTC trade previously submitted on your behalf by an inter-dealer broker.

Submits a command to the trading engine to approve an OTC trade. A successful response indicates that the command entry was acknowledged but does not indicate that the command was executed. This endpoint uses the signing format which does not require strict field ordering and addition of null fields in the request body.

Command schemas and examples are provided below. Supported commands:

  • V1ApproveOtcTrade

Requires

  • bearer token in authorization header
post/v2/otc-command#approve

Request

Headers

BX-SIGNATUREstring required

signature obtained using the signing format

BX-TIMESTAMPstring required

timestamp is the number of milliseconds since EPOCH

BX-NONCEstring required

nonce is a client side incremented unsigned 64 bit integer

Request body

commandTypestring required

Specifies the command type and must be 'V1ApproveOtcTrade' to indicate the approval of an OTC trade.

tradingAccountIdstring required

unique trading account ID

otcTradeIdstring

unique numeric (i64) identifier generated on Bullish side expressed as a string value

clientOtcTradeIdstring

unique numeric (i64) identifier generated on the client side expressed as a string value

Example request

{
  "commandType": "V1ApproveOtcTrade",
  "otcTradeId": "200000000000000098",
  "tradingAccountId": "111000000000001"
}

Response

Status OK. This means a command was successfully acknowledged.

messagestring required

message indicating the status of the request

requestIdstring required
otcTradeIdstring required

unique numeric (i64) identifier generated on Bullish side expressed as a string value

clientOtcTradeIdstring

unique numeric (i64) identifier generated on the client side expressed as a string value

tradingAccountIdstring required

unique trading account ID

Example response

{
  "message": "Command acknowledged - ApproveOtcTrade",
  "requestId": "100000000000000149",
  "otcTradeId": "200000000000000098",
  "tradingAccountId": "111000000000001"
}

Changes

No recorded changes to this operation across all 1 revision of this API.