Sub‐Account Service

The SubAccountService provides a comprehensive suite of tools for managing sub-accounts within your BingX account. This service is particularly useful for institutional traders and users who need to segregate their trading activities and manage multiple accounts under a single master account.

Accessing the Service

To begin managing your sub-accounts, you must first access the SubAccountService through your BingXClient instance:

from bingx import BingXClient

client = BingXClient(api_key="YOUR_API_KEY", api_secret="YOUR_API_SECRET")
sub_account_service = client.sub_account()

Core Functionalities

The SubAccountService is organized into several logical groups of methods, each designed to handle a specific aspect of sub-account management.

Sub-Account Management

These methods provide the tools to create, list, and manage your sub-accounts.

Method	Description
create_sub_account(sub_account_string)	Creates a new sub-account.
get_sub_account_list(...)	Retrieves a list of your sub-accounts.
get_sub_account_assets(sub_uid)	Retrieves the assets of a specific sub-account.
update_sub_account_status(sub_account_string, status)	Enables or disables a sub-account.
get_all_sub_account_balances()	Retrieves the balances of all your sub-accounts.

API Key Management

These methods allow you to manage the API keys for your sub-accounts.

Method	Description
create_sub_account_api_key(...)	Creates a new API key for a sub-account.
query_api_key(sub_account_string)	Queries the API key information for a sub-account.
edit_sub_account_api_key(...)	Edits the permissions of a sub-account's API key.
delete_sub_account_api_key(sub_account_string, api_key)	Deletes a sub-account's API key.

Transfers and Deposits

These methods provide the functionality to move funds between your main account and sub-accounts, as well as manage deposits for your sub-accounts.

Method	Description
sub_account_internal_transfer(...)	Performs an internal transfer between your main account and a sub-account.
get_sub_account_internal_transfer_records(...)	Retrieves the history of internal transfers.
create_sub_account_deposit_address(coin, network, sub_uid)	Creates a deposit address for a sub-account.
get_sub_account_deposit_address(coin, sub_uid, network)	Retrieves the deposit address of a sub-account.
get_sub_account_deposit_history(...)	Retrieves the deposit history of a sub-account.