Skip to content
Assets Overview

Equity Holding Summary

Returns Holding Summary.

Request parameters

  • Required: equity_type (Equity Type)
  • Optional: client_types (Client Type), account_types (Account Type), broker_codes (AE), page (Page), page_size (Page Size)
  • See each field for its format, allowed values, and business meaning.

Result

On success, the endpoint completes the operation. See the 200 response schema for returned data and subsequent state information.

POSThttps://b-api.longbridge.xyz/v1/portfolio/query_equity_holding_summary

Authorization

AuthorizationstringheaderRequired

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

Request body application/json

client_typesstring

Client Type. Client type.

  • Join multiple values with a comma ,
  • Omit this parameter to query all client types
  • Example: 1,2

Allowed values:

  • 1 - Personal Client
  • 2 - Corporate Client
  • 3 - Joint Client

123

account_typesstring

Account Type. Account type.

  • Join multiple values with a comma ,
  • Omit this parameter to query all account types
  • Example: M,C

Note: An invalid combination of account type and equity_type (for example, futures account F with fund FUND ) returns 400.

Allowed values:

  • M - Margin
  • C - Cash
  • F - Futures

MCF

broker_codesstring

AE. Filter by broker (AE) code.

  • Join multiple values with a comma ,
  • Omit this parameter to query all brokers
  • = means unassigned
  • Example: =,LBtestwbwhale123

Query the complete AE code list through GET /v1/datasets/refs/broker_accounts. Values vary by tenant and environment.

Values currently documented:

  • = - Unassigned

=

equity_typestringrequired

Equity Type. Asset-type filter for the holding summary. Only one value is supported.

Values come from the dynamic equity_holding_summary_equity_type enumeration and are not fixed.

Call GET /v1/datasets/refs/equity_holding_summary_equity_type to retrieve the current data dictionary, and use the returned entry's key as this field's value.

Values currently documented:

  • STOCK - Stock
  • OPTION - Option
  • FUND - Fund
  • BOND - Bond
  • MMF - Cash Plus
  • OTC - Other
  • CRYPTO - Cryptocurrency
  • WM - OTC Derivatives

STOCKOPTIONFUNDBONDMMFOTCCRYPTOWM

pagenumber

Page number to query, starting from 1.

page_sizenumber

Page Size. Maximum number of records to return per page. Use a positive integer.

Responses

HTTP 200The request was processed successfully. data contains total_holdings, page, page_size, total_page, total.
Standard response envelopecodemessagedata
dataobjectdata structure
total_holdingsarray<object>

Holdings. Returned value: List of holdings.

Child attributes
counter_idstring

Counter ID. Returned value: Counter ID.

equity_typestring

Equity Type. Same as the request equity_type; see equity_holding_summary_equity_type for values.

counter_namestring

Symbol Name. Localized name, returned per Accept-Language.

total_quantitystring

Holding Quantity. Returned value: Holding Quantity.

last_donestring

Closing Price. Returned value: Closing Price.

market_valuestring

Holding Market Value. Returned value: Holding Market Value.

settledstring

Settled. Returned value: Settled.

unsettlestring

Outstanding. Returned value: Outstanding.

trade_0string

T+0 quantity to be settled. Returned value: T+0 quantity to be settled.

trade_1string

T+1 quantity to be settled. Returned value: T+1 quantity to be settled.

trade_2string

T+2 quantity to be settled. Returned value: T+2 quantity to be settled.

trade_nstring

T+N quantity to be settled. Returned value: T+N quantity to be settled.

symbolstring

Symbol. Instrument code; empty for some holdings.

pagenumber

Page. Returned value: Current page number.

page_sizenumber

Page Size. Returned value: Number of records per page in this response.

total_pagenumber

Total Pages. Returned value: Total number of result pages.

totalnumber

Total. 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