Create Exchange Contract V2

POSThttps://b-api.longbridge.xyz/v2/billing/exchange_contract

Authorization

AuthorizationstringheaderRequired

Send the Broker ACCESS_TOKEN as Authorization: Bearer <token>.

Request body application/json

trade_datestringrequired

Trade Date

counter_idstringrequired

Counter ID

directionstringrequired

Direction

currencystringrequired

Trade Currency

aaidstringrequired

A/C No

settlement_channelstringrequired

Settlement Channel

settlement_accountstring

Settlement Account

stagestring

Trade Stage

order_sourcestring

Order Source

custodian_idstring

Custodian ID

expected_equity_settlement_datestring

Expected Equity Settlement Date

expected_balance_settlement_datestring

Expected Balance Settlement Date

currency_setlstring

Settlement Currency

trade_to_setl_exchange_ratestring

Trade to Settlement Exchange Rate

otcr_flagstring

OTCR Flag

open_closestringrequired

Open/Close

OPENCLOSE

positionstringrequired

Position

LONGSHORT

biz_typestring

Biz Type

issue_pricestring

Issue Price. Used when the instrument type is BOND.

trade_donesarray<string>required

Trade Done List. Each item contains order_seq (front-office order number) / quantity / amount / per_value (par value per share) / ibond_interest (accrued interest) / price.

Responses

HTTP 200No confirmable field definitions are available for the response yet.

Standard response envelopecodemessagedata

dataobjectdata structure

No nested fields

Request

curl --request POST \
  --url 'https://b-api.longbridge.xyz/v2/billing/exchange_contract' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'
  --data '{
  "trade_date": "2026-07-10",
  "counter_id": "700.HK",
  "direction": "",
  "currency": "HKD",
  "aaid": "",
  "settlement_channel": "",
  "settlement_account": "",
  "stage": "",
  "order_source": "",
  "custodian_id": "",
  "expected_equity_settlement_date": "2026-07-10",
  "expected_balance_settlement_date": "2026-07-10",
  "currency_setl": "",
  "trade_to_setl_exchange_rate": "1",
  "otcr_flag": "",
  "open_close": "OPEN",
  "position": "LONG",
  "biz_type": "",
  "issue_price": "",
  "trade_dones": [
    {
      "order_seq": "",
      "quantity": "",
      "amount": "",
      "per_value": "",
      "ibond_interest": "",
      "price": ""
    }
  ]
}'

Response

{
  "code": 0,
  "message": null,
  "data": {}
}