Skip to content
Longport WhaleLongport Whale
Symbol Information

Clearing - Instrument Information

Query the clearing instrument (security) information. Combine business filters through filters, and control pagination with page and page_size.

Response

On success, returns the matching list of records together with pagination information. See each field's documentation for the purpose, allowed values, and dynamic data source of every filter.

GEThttps://b-api.longbridge.xyz/v1/datasets/clearing_stock_infos

Dataset endpoints are available on the Test host only (https://b-api.longbridge.xyz); the Production host returns 404.

This Dataset query is read-only. Use GET by default. If the encoded query parameters are too large, send the same parameters as a JSON body with POST to the same path.

Authorization

AuthorizationstringheaderRequired

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

Permission

lb_hk_clearing.close_price_query

The Broker ACCESS_TOKEN must be granted the permission below, or the call will be rejected.

Query parameters

filtersobject

Combines business filters. Omit a filter field to disable that filter.

Child attributes
ledger_datestringrequired

Filters results by Ledger Date.

codestring

Filters results by Counter ID.

namestring

Filters results by Fallback Name.

counter_idstring

Filters results by Counter ID.

statusstring

Filters results by Status.

Multiple values are supported. Join them with commas (,). Omit the field to disable this filter.

0 · Active1 · Suspended2 · Delisted3 · Prelist8 · Unknown9 · Othersnormal · Active

close_pricestring

Filters results by Close Price.

stamp_duty_markstring

Filters results by Stamp Duty Exemption.

1 · Subject to stamp duty0 · Exempt from stamp duty

has_holdingstring

Filters results by Existing Position.

has_pending_ticketstring

Filters results by Pending Approvals.

pageinteger

Page number to retrieve, starting from 1.

page_sizeinteger

Number of records to return per page.

Responses

HTTP 200On success, returns paginated Clearing - Instrument Information records together with pagination metadata such as the page number, page size, and total record count.
Standard response envelopecodemessagedata
dataobjectdata structure
listarray<object>required

Returned value: List of list.

Child attributes
ledger_datestring

Returned value: Ledger Date. The date or time format follows the value returned by the API.

codestring

Returned value: Counter ID.

counter_idstring

Returned value: Counter ID.

marketstring

Returned value: Market.

currencystring

Returned value: Currency.

namestring

Returned value: Fallback Name.

name_enstring

Returned value: Name(EN).

name_cnstring

Returned value: Name(CN).

name_hkstring

Returned value: Name(TC).

isinstring

Returned value: ISIN.

ipo_datestring

Returned value: IPO Date. The date or time format follows the value returned by the API.

ipo_pricestring

Returned value: IPO Price.

statusstring

Returned value: State.

status_valstring

Raw value of status. The status field contains the display value resolved through a dictionary or related record; this field contains the underlying code or ID.

suspend_datestring

Returned value: Suspension Date. The date or time format follows the value returned by the API.

lot_sizestring

Returned value: Lot size.

stamp_duty_exemptionstring

Returned value: Stamp Duty Exemption.

stamp_duty_exemption_valstring

Raw value of stamp_duty_exemption. The stamp_duty_exemption field contains the display value resolved through a dictionary or related record; this field contains the underlying code or ID.

close_pricestring

Returned value: Closing Price.

pre_close_pricestring

Returned value: Previous Closing Price.

settle_pricestring

Returned value: Stock Lending Settlement Price.

close_price_suspendstring

Returned value: Closing Price For Statement(For suspended stock).

turnoverstring

Returned value: Turnover.

has_holdingstring

Returned value: Indicates whether existing position.

updated_atstring

Returned value: Updated At. The date or time format follows the value returned by the API.

operatorstring

Returned value: Operator.

operator_valstring

Raw value of operator. The operator field contains the display value resolved through a dictionary or related record; this field contains the underlying code or ID.

totalintegerrequired

Returned value: Total number of matching records, used for pagination.

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