Get Account Bcan Information

This interface is used to retrieve the BCAN (Broker-to-Client Assigned Number) related information for a specified securities account. By providing the account number account_no, it returns the central number ce_no, BCAN code bcan_no, consent status for China Connect, consent status for HKIDR, and the effective status of both.

GEThttps://b-api.longbridge.xyz/v1/whaleapi/account/bcan_info

Authorization

AuthorizationstringheaderRequired

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

Parameters

account_nostringRequired

Account Number

Responses

HTTP 200Success

Standard response envelopecodemessagedata

dataobjectdata structure

ce_nostringrequired

ce_no

bcan_nostringrequired

bcan_no

is_agreebooleanrequired

is_agree

hk_is_agreebooleanrequired

hk_is_agree

stateintegerrequired

state

hk_stateintegerrequired

hk_state

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

Request

curl --request GET \
  --url 'https://b-api.longbridge.xyz/v1/whaleapi/account/bcan_info' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "ce_no": "string",
    "bcan_no": "string",
    "is_agree": false,
    "hk_is_agree": false,
    "state": 0,
    "hk_state": 0
  }
}