Skip to content
Account Transfers

Query Stock Transfer Records

Returns stock transfer records for the record list and details pages. Each record is a batch. For the list, send aaid_list. For details, send batch_no and use the first item in tickets. Send at least one of aaid_list and batch_no. The operation is not paginated. The Broker App sorts records by apply_time in descending order.

Each stock in a batch has its own status. The Broker App derives the batch status from stocks[].status: failed when some stocks failed (3 or 5) and none succeeded; partially succeeded when both successes (4) and failures exist; succeeded when all stocks succeeded; otherwise processing.

When calling through WhaleCore requestService(), set requiresTradeToken to true.

GEThttps://api.lbkrs.com/v1/app/risk_event_api/query_stock_transfer_tickets

Parameters

aaid_liststringquery

Account aaid values to query, separated by commas. Send to query the record list. The Broker App sends all sub-accounts of the current account

batch_nostringquery

Batch number. Send to query a single batch

Responses

HTTP 200The request succeeded. The response body contains the result of the “Query Stock Transfer Records” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
ticketsarray<object>

Stock transfer batch records

Child attributes
batch_nostring

Batch number, which is the ref_no used at submission

apply_timeinteger

Submission time as a Unix timestamp in seconds

from_aaidinteger

aaid of the source account

to_aaidinteger

aaid of the destination account

from_origin_nostring

Account number of the source account, for display

to_origin_nostring

Account number of the destination account, for display

from_account_typeinteger

Source account level:

  • 0 - Main account
  • Other values - Sub-account
to_account_typeinteger

Destination account level:

  • 0 - Main account
  • Other values - Sub-account
stocksarray<object>

Stocks transferred in this batch

Child attributes
counter_idstring

Security ID in the format <type>/<market>/<code>, such as ST/HK/700

codestring

Stock code

marketstring

Market, such as HK or US

name_localsstring

Stock name in the current language. Show code when empty

transfer_quantitystring

Number of shares transferred

statusinteger

Transfer status:

  • 0 - Submitted
  • 1 - Pending review
  • 2 - Approved
  • 3 - Rejected
  • 4 - Succeeded
  • 5 - Failed
  • 6 - Cancelled

3, 4, 5, and 6 are terminal. 0, 1, and 2 mean the transfer is still being processed.

Values
0
1
2
3
4
5
6
Whale Docs