- Introduction
- Authentication
- Enums Definitions
- Terms Definitions
- SDK
- OpenClaw
- Rate Limit Rule (UTA)
- Rate Limit Rule (Classic)
- Change Log
- User Service
- UTA REST V2
- Introduction
- Market Data
- Get Announcements
- Get Currency
- Get Currencies
- Get Ticker
- Get Symbol
- Get Klines
- Get OrderBook
- Get Index Price
- Get Trades
- Get Position Tiers
- Get Collateral Ratio
- Get Borrowable Currencies
- Get Current Funding Rate
- Get History Funding Rate
- Get Futures Open Interest
- Get Interest Rate Index
- Get Max Order Quantity
- Platform 24h Market Statistics
- Get Call Auction Info
- Get Fiat Price
- Get Third-Party Custody Currencies
- Get Service Status
- Get KYC Regions
- Get Client IP Address
- Account Info
- Account & Funding
- Get Account Overview (UTA)
- Get Account Currency Assets (UTA)
- Get Account Currency Assets (Classic)
- Get Apikey Info
- Get Account Mode
- Set Account Mode
- Get Leverage (UTA)
- Modify Futures Leverage (UTA)
- Modify Cross Margin Leverage (UTA)
- Get Borrowing Rates and Limits
- Get Account Ledger
- Get Interest History (UTA)
- Get API Rate Limit
- Get All API Rate Limit
- Get API Rate Limit Cap
- Get Fee Rate
- KCS Fee Deduction Management
- Get Third-Party Custody Account Currency Limits
- Sub Account
- Deposit
- Transfer
- Withdraw
- Orders
- Positions
- VIP Lending
- UTA WebSocket V2
- Classic REST
- Account Info
- Account & Funding
- Get Account Summary Info
- Get Apikey Info
- Get Account Type - Spot
- Get Account List - Spot
- Get Account Detail - Spot
- Get Account - Cross Margin
- Get Account - Isolated Margin
- Get Account - Futures
- Get Account Ledgers - Spot/Margin
- Get Account Ledgers - Trade_hf
- Get Account Ledgers - Margin_hf
- Get Account Ledgers - Futures
- Sub Account
- Sub Account API
- Deposit
- Withdrawals
- Transfer
- Trade Fee
- Account & Funding
- Spot Trading
- Market Data
- Get Announcements
- Get Currency
- Get All Currencies
- Get Symbol
- Get All Symbols
- Get Ticker
- Get All Tickers
- Get Trade History
- Get Klines
- Get Part OrderBook
- Get Full OrderBook
- Get Call Auction Part OrderBook
- Get Call Auction Info
- Get Fiat Price
- Get 24hr Stats
- Get Market List
- Get Client IP Address
- Get Server Time
- Get Service Status
- Get KYC Regions
- Orders
- Add Order
- Add Order Sync
- Add Order Test
- Batch Add Orders
- Batch Add Orders Sync
- Cancel Order By OrderId
- Cancel Order By OrderId Sync
- Cancel Order By ClientOid
- Cancel Order By ClientOid Sync
- Cancel Partial Order
- Cancel All Orders By Symbol
- Cancel All Orders
- Modify Order
- Get Order By OrderId
- Get Order By ClientOid
- Get Symbols With Open Order
- Get Open Orders
- Get Open Orders By Page
- Get Closed Orders
- Get Trade History
- Get DCP
- Set DCP
- Add Stop Order
- Cancel Stop Order By ClientOid
- Cancel Stop Order By OrderId
- Batch Cancel Stop Orders
- Get Stop Orders List
- Get Stop Order By OrderId
- Get Stop Order By ClientOid
- Add OCO Order
- Cancel OCO Order By OrderId
- Cancel OCO Order By ClientOid
- Batch Cancel OCO Order
- Get OCO Order By OrderId
- Get OCO Order By ClientOid
- Get OCO Order Detail By OrderId
- Get OCO Order List
- Market Data
- Margin Trading
- Market Data
- Orders
- Add Order
- Add Order Test
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Cancel All Orders By Symbol
- Get Symbols With Open Order
- Get Open Orders
- Get Closed Orders
- Get Trade History
- Get Order By OrderId
- Get Order By ClientOid
- Add Stop Order
- Cancel Stop Order By OrderId
- Cancel Stop Order By ClientOid
- Batch Cancel Stop Orders
- Get Stop Orders List
- Get Stop Order By OrderId
- Get Stop Order By ClientOid
- Add OCO Order
- Cancel OCO Order By OrderId
- Cancel OCO Order By ClientOid
- Batch Cancel OCO Order
- Get OCO Order By OrderId
- Get OCO Order By ClientOid
- Get OCO Order Detail By OrderId
- Get OCO Order List
- Debit
- Credit
- Risk Limit
- Futures Trading
- Introduction
- Market Data
- Orders
- Add Order
- Add Order Test
- Batch Add Orders
- Add Take Profit And Stop Loss Order
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Batch Cancel Orders
- Cancel All Orders
- Cancel All Stop orders
- Get Order By OrderId
- Get Order By ClientOid
- Get Order List
- Get Recent Closed Orders
- Get Stop Order List
- Get Open Order Value
- Get Recent Trade History
- Get Trade History
- Positions
- Get Margin Mode
- Switch Margin Mode
- Batch Switch Margin Mode
- Get Position Mode
- Switch Position Mode
- Get Max Open Size
- Get Position Details
- Get Position List
- Get Positions History
- Get Max Withdraw Margin
- Get Cross Margin Leverage
- Modify Cross Margin Leverage
- Add Isolated Margin
- Remove Isolated Margin
- Get Cross Margin Risk Limit
- Get Cross Margin Requirement
- Get Isolated Margin Risk Limit
- Modify Isolated Margin Risk Limit
- Funding Fees
- Earn
- VIP Lending
- Affiliate
- Broker
- Introduction
- Broker Application
- Instructions
- Broker Pro
- Exchange Broker
- Introduction
- Get Broker Rebate
- Get Broker RebateV3
- Submit KYC
- Get KYC Status
- Get KYC Status List
- Get Broker Info
- Add sub-account
- Get sub-account
- Add sub-account API
- Get sub-account API
- Modify sub-account API
- Delete sub-account API
- Transfer
- Get Transfer History
- Get Deposit List
- Get Deposit Detail
- Get Withdraw Detail
- Set Markup Fee
- Get Markup Fee
- Copy Trading
- Introduction
- Add Order
- Add Order Test
- Add Take Profit And Stop Loss Order
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Get Max Open Size
- Get Max Withdraw Margin
- Add Isolated Margin
- Remove Isolated Margin
- Modify Isolated Margin Risk Limit
- Modify Isolated Margin Auto-Deposit Status
- Switch Margin Mode
- Modify Cross Margin Leverage
- Get Cross Margin Requirement
- Switch Position Mode
- Convert
- Account Info
- Classic WebSocket
- Web3 Wallet
- Error Code
- Abandoned Endpoints
- Introduction
- UTA REST
- Introduction
- Market Data
- Get Announcements
- Get Currency
- Get Currencies
- Get Symbol
- Get Ticker
- Get OrderBook
- Get Klines
- Get Trades
- Get Collateral Ratio
- Get Index Price
- Get Current Funding Rate
- Get History Funding Rate
- Get Position Tiers
- Get Futures Open Interest
- Get Service Status
- Get Third-Party Custody Currencies
- Get Borrowable Currencies
- Get KYC Regions
- Get Client IP Address
- Get Fiat Price
- Get Interest Rate Index
- Platform 24h Market Statistics
- Get max order quantity
- Get Call Auction Info
- Account
- Get Account Overview (UTA)
- Get Account Currency Assets (UTA)
- Get Account Currency Assets (Classic)
- Get Sub Account Currency Assets
- Get Transfer Quotas
- Flex Transfer
- Set Sub Account Transfer Permission
- Get Account Mode
- Set Account Mode
- Get Fee Rate
- Get Account Ledger
- Get Interest History (UTA)
- Modify Futures Leverage (UTA)
- Get Third-Party Custody Account Currency Limits
- Modify Cross Margin Leverage (UTA)
- Get Leverage (UTA)
- Get Borrowing Rates and Limits
- Get Apikey Info
- Add sub-account
- Get Sub-account List
- Get sub-account API List
- Add sub-account API
- Modify sub-account API
- Delete sub-account API
- Get Deposit Address
- Get Deposit History
- Get Withdrawal Quotas
- Withdraw
- Cancel Withdrawal
- Get Withdrawal History
- KCS Fee Deduction Management
- Get API Rate Limit Cap
- Set Sub Accounts API Rate Limit
- Get API Rate Limit
- Get All API Rate Limit
- Orders
- Positions
- VIP Lending
- UTA WebSocket
- PRO REST
- Classic
- Account & Funding
- Get Deposit Addresses (V2)
- Get Deposit Addresses - V1
- Add Deposit Address - V1
- Get sub-account List - Summary Info (V1)
- Get sub-account List - Spot Balance (V1)
- Sub-account Transfer
- Get Deposit History - Old
- Internal Transfer
- Get Futures Account Transfer Out Ledger
- Get Withdrawal History - Old
- Futures Account Transfer Out
- Futures Account Transfer In
- Withdraw - V1
- Spot Trading
- Margin Trading
- Futures Trading
- Affiliate
- Broker
- Account & Funding
- Developing
Get Sub Account Currency Assets
GET
https://api.kucoin.com/api/ua/v2/sub-account/balance
api-channel:Private
api-permission:General
api-rate-limit-pool:Management
sdk-service:UTA
sdk-sub-service:Account
sdk-method-name:getSubAccountBalance
api-rate-limit-weight:5
Description
Usage
subAccountType is a string and can be a symbol-like value for isolated margin, such as AAVE-USDT.Important
UNIFIED in the returned account type where applicable. Do not restrict subAccountType to a fixed enum.Request
Query Params
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.kucoin.com/api/ua/v2/sub-account/balance?uid=2400011001071395&pageSize=50&lastId=0'Responses
🟢200OK
application/json
Body
Example
{
"code": "200000",
"data": {
"ts": 1785234451817,
"userList": [
{
"uid": 2400011001071395,
"accounts": [
{
"accountType": "SPOT",
"subAccountType": null,
"currencies": [
{
"currency": "USDT",
"equity": null,
"balance": "201",
"available": "201",
"liabilityInterest": null,
"liability": null,
"unrealisedPnl": null,
"liabilityPrincipal": null,
"locked": "0"
}
]
},
{
"accountType": "FUNDING",
"subAccountType": null,
"currencies": [
{
"currency": "USDT",
"equity": null,
"balance": "101",
"available": "101",
"liabilityInterest": null,
"liability": null,
"unrealisedPnl": null,
"liabilityPrincipal": null,
"locked": "0"
}
]
},
{
"accountType": "CROSS",
"subAccountType": null,
"currencies": [
{
"currency": "USDT",
"equity": null,
"balance": "80",
"available": "80",
"liabilityInterest": null,
"liability": null,
"unrealisedPnl": null,
"liabilityPrincipal": null,
"locked": "0"
}
]
},
{
"accountType": "ISOLATED",
"subAccountType": "AAVE-USDT",
"currencies": [
{
"currency": "USDT",
"equity": null,
"balance": "8392",
"available": "8392",
"liabilityInterest": "0",
"liability": null,
"unrealisedPnl": null,
"liabilityPrincipal": "0",
"locked": "0"
}
]
},
{
"accountType": "FUTURES",
"subAccountType": null,
"currencies": [
{
"currency": "USDT",
"equity": "783",
"balance": "783",
"available": "783",
"liabilityInterest": null,
"liability": null,
"unrealisedPnl": null,
"liabilityPrincipal": null,
"locked": "0"
}
]
}
]
}
]
}
}Modified at 2026-08-27 07:52:25