Skip to content
Shorted Stock Call Back

Short Stock Holding Records

Returns the position records for short-stock recall.

Request parameters

  • Required: aaid (securities account ID) and log_id (short-stock recall record ID). The frontend always sends both.
  • log_id is the id of a row returned by holding_short_stock_margin_logs; pass that row's aaid with it.
  • See the field definitions for each field's format, allowed values, and business meaning.

Returns

On success, returns the short-stock recall position records. See the response definition for field meanings.

POSThttps://b-api.lbkrs.com/v1/risk_monitoring/short_stock_margin_holdings

Authorization

AuthorizationstringheaderRequired

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

Request body application/json

aaidstringrequired

A/C No.

Pass the internal numeric ID of the customer's securities account (aaid), not the securities account number account_no (such as H00000000) or the customer ID member_id. One customer can have multiple aaid values.

log_idintegerrequired

Short-stock recall record ID: the id of the row returned by holding_short_stock_margin_logs (short-stock margin recall logs). Pass it together with the same row's aaid; without it the backend cannot locate the recall record and returns 30020049.

Responses

HTTP 200OK
Standard response envelopecodemessagedata
dataobjectdata structure
holding_detailarray<object>
Child attributes
symbolstring
counter_idstring
directioninteger
holding_quantityinteger
avail_quantityinteger
pricenumber
HTTP 400Bad request. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 401The user is not authenticated, or the login session has expired.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 403The current account is not authorized to use this feature. Grant the required permission to the account in User Permission.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

HTTP 408The request timed out. Check the business error code in code and the error details in message.
Standard response envelopecodemessagedata
dataobjectdata structure

No nested fields

Whale Docs