Virtual Asset Contract

POSThttps://b-api.longbridge.xyz/v1/datasets/booking_va_contracts

Authorization

AuthorizationstringheaderRequired

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

Request body application/json

filtersobject

Filters

Child attributes

filters.falsestring

Contract No

filters.aaidstring

Client

filters.contract.trade_dateobject

Trade Date. Range filter; both bounds are optional (omit a bound to leave that side unbounded).

Child attributes

filters.contract.trade_date.gtestring

Greater Than or Equal

filters.contract.trade_date.ltestring

Less Than or Equal

filters.marketstring

Market. Values are dynamically queried from clear_used_market (not fixed); fetch them live via GET /v1/datasets/refs/clearing_config_markets.

filters.counter_idstring

Counter ID

filters.directionstring

Trade Direction. Options: 1 = Buy; 2 = Sell

12

filters.settlement_channelstring

Settlement Channel. Values are dynamically queried from billing_settlement_channel (not fixed); fetch them live via GET /v1/datasets/refs/billing_settlement_channel.

filters.statestring

Status. Options: 2 = To Be Calculated; 3 = To Be Charged; 4 = To Be Settled; 5 = Settlement Completed; 6 = Equity settled; 1 = Init; -1 = --

234561-1

filters.currencystring

Currency. Values are dynamically queried from global_currency (not fixed); fetch them live via GET /v1/datasets/refs/tenant_currencies.

pageinteger

Page

page_sizeinteger

Page Size

orderByarray<object>

Order By

Responses

HTTP 200Paginated list result.

Standard response envelopecodemessagedata

dataobjectdata structure

listarray<object>required

List

totalintegerrequired

Total

Request

curl --request POST \
  --url 'https://b-api.longbridge.xyz/v1/datasets/booking_va_contracts' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'
  --data '{
  "filters": {},
  "page": 1,
  "page_size": 20,
  "orderBy": []
}'

Response

{
  "code": 0,
  "message": null,
  "data": {
    "list": [
      {
        "false": "<string>",
        "ledger_date": "<string>",
        "trade_date": "<string>",
        "aaid": "<string>",
        "settlement_account": "<string>",
        "settlement_channel": "<string>",
        "market": "<string>",
        "counter_id": "<string>",
        "direction": "<string>",
        "trade_quantity": "<string>",
        "trade_amount": "<string>",
        "currency": "<string>",
        "bill_amount": "<string>",
        "calculate_out_amount": "<string>",
        "deduction_amount": "<string>",
        "receivable_amount": "<string>",
        "state": "<string>",
        "updated_at": "<string>"
      }
    ],
    "total": 0
  }
}