Asset Overview
Query master account or one subaccounts' total assets and detailed asset holdings across different accounts and product categories.
HTTP Request
GET/v5/asset/asset-overviewRequest Parameters
| Parameter | Required | Type | Comments |
|---|---|---|---|
| memberId | false | string | User ID. When using master API key to query sub account assets, this field is required |
| valuationCurrency | false | string | Fiat currency for valuation. Defaults to USD if not passed |
| accountType | false | string | Account type. Returns all if not passed |
Response Parameters
| Parameter | Type | Comments |
|---|---|---|
| totalEquity | string | Total equity across all accounts, valued in the user's valuation currency |
| list | array | Account holdings list |
| > accountType | string | Account type |
| > totalEquity | string | Total equity of this account |
| > valuationCurrency | string | Valuation currency for this account |
| > snapshotTime | string | Data snapshot time, Unix timestamp (ms) |
| > coinDetail | array | Coin-level holdings. Returned for accounts without sub-categories |
| >> coin | string | Coin name |
| >> equity | string | Coin equity amount |
| > categories | array | Sub-category breakdown. Returned for accounts that have product sub-categories (e.g. Earn, TradingBot, CopyTrading) |
| >> category | string | Sub-category name |
| >> equity | string | Total equity of this sub-category |
| >> coinDetail | array | Coin-level holdings within this sub-category |
| >>> coin | string | Coin name |
| >>> equity | string | Coin equity amount |
| >>> extMap | object | Extended fields. Only returned when accountType=Alpha and category=farm |
| >>>> priceUpper | string | Upper price of the liquidity position range |
| >>>> priceLower | string | Lower price of the liquidity position range |
| >>>> equityUnit | string | Unit of the equity value, e.g. USD |
Request Example
- HTTP
- Python
- Node.js
GET /v5/asset/asset-overview HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1739433600000
X-BAPI-RECV-WINDOW: 5000
from pybit.unified_trading import HTTP
session = HTTP(
testnet=True,
api_key="xxxxxxxxxxxxxxxxxx",
api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.get_asset_overview())
Response Example
{
"retCode": 0,
"retMsg": "Success",
"result": {
"totalEquity": "7457023",
"list": [
{
"totalEquity": "20429.51",
"valuationCurrency": "USD",
"accountType": "CryptoLoans",
"coinDetail": [
{
"equity": "-0.00100377",
"coin": "BTC"
},
{
"equity": "50",
"coin": "MNT"
},
{
"equity": "20383.9175",
"coin": "USDT"
}
],
"snapshotTime": "1772449024908"
},
{
"totalEquity": "20888.1",
"valuationCurrency": "USD",
"accountType": "Earn",
"snapshotTime": "1772449024908",
"categories": [
{
"coinDetail": [
{
"equity": "0.3",
"coin": "BTC"
},
{
"equity": "100",
"coin": "MNT"
},
{
"equity": "200",
"coin": "USDT"
}
],
"category": "Easy Earn",
"equity": "20888.1"
}
]
},
{
"totalEquity": "120.53",
"valuationCurrency": "USD",
"accountType": "TradingBot",
"snapshotTime": "1772449024908",
"categories": [
{
"coinDetail": [
{
"equity": "4",
"coin": "USDT"
}
],
"category": "Futures Grid Bot",
"equity": "4"
},
{
"coinDetail": [
{
"equity": "101.5392",
"coin": "USDT"
}
],
"category": "Futures Combo Bot",
"equity": "101.53"
},
{
"coinDetail": [
{
"equity": "14.9923",
"coin": "USDT"
}
],
"category": "Futures Martingale Bot",
"equity": "14.99"
}
]
},
{
"totalEquity": "7175590.45",
"valuationCurrency": "USD",
"accountType": "FundingAccount",
"coinDetail": [
{
"equity": "100",
"coin": "AED"
},
{
"equity": "97.99999988",
"coin": "BTC"
},
{
"equity": "101",
"coin": "SOL"
},
{
"equity": "9950",
"coin": "MNT"
},
{
"equity": "10000",
"coin": "TON"
},
{
"equity": "98.9",
"coin": "ETH"
},
{
"equity": "12220.5558",
"coin": "USDT"
},
{
"equity": "100000",
"coin": "USDC"
},
{
"equity": "9000",
"coin": "NEAR"
},
{
"equity": "89490",
"coin": "ADA"
}
],
"snapshotTime": "1772449024908"
},
{
"totalEquity": "254.37",
"valuationCurrency": "USD",
"accountType": "BybitPayLater",
"coinDetail": [
{
"equity": "178",
"coin": "USDT"
},
{
"equity": "76.371564",
"coin": "USDC"
}
],
"snapshotTime": "1772449024908"
},
{
"totalEquity": "213399.38",
"valuationCurrency": "USD",
"accountType": "UnifiedTradingAccount",
"coinDetail": [
{
"equity": "37283.5394",
"coin": "USDT"
},
{
"equity": "399.6",
"coin": "AED"
},
{
"equity": "2.62897721",
"coin": "BTC"
},
{
"equity": "1",
"coin": "ETH"
}
],
"snapshotTime": "1772449024908"
},
{
"totalEquity": "4491.24",
"valuationCurrency": "USD",
"accountType": "CopyTrading",
"snapshotTime": "1772449024908",
"categories": [
{
"coinDetail": [
{
"equity": "1379.2463",
"coin": "USDT"
}
],
"category": "Copy Trading Classic",
"equity": "1379.24"
},
{
"coinDetail": [
{
"equity": "2111",
"coin": "USDT"
}
],
"category": "Copy Trading TradFi",
"equity": "2111"
},
{
"coinDetail": [
{
"equity": "1001",
"coin": "USDT"
}
],
"category": "Copy Trading Pro",
"equity": "1001"
}
]
},
{
"totalEquity": "8304.15",
"valuationCurrency": "USD",
"accountType": "CryptoLoans_legacy",
"coinDetail": [
{
"equity": "0.13",
"coin": "BTC"
},
{
"equity": "0.14",
"coin": "ETH"
},
{
"equity": "-1000.5547",
"coin": "USDT"
}
],
"snapshotTime": "1772449024908"
},
{
"totalEquity": "339.1",
"valuationCurrency": "USD",
"accountType": "Launchpool",
"coinDetail": [
{
"equity": "100",
"coin": "MNT"
},
{
"equity": "111",
"coin": "USDT"
}
],
"snapshotTime": "1772449024908"
},
{
"totalEquity": "13121.13",
"valuationCurrency": "USD",
"accountType": "TradFi",
"coinDetail": [
{
"equity": "13121.13",
"coin": "USDT"
}
],
"snapshotTime": "1772449024908"
},
{
"totalEquity": "85.02",
"valuationCurrency": "USD",
"accountType": "MarginStakedSOL",
"coinDetail": [
{
"equity": "34.05211088",
"coin": "SOL"
}
],
"snapshotTime": "1772449024908"
},
{
"totalEquity": "335.33",
"valuationCurrency": "USD",
"accountType": "Alpha",
"snapshotTime": "1773748881734",
"categories": [
{
"coinDetail": [
{
"equity": "112.46434565",
"coin": "TSLAx"
},
{
"equity": "43.36958077",
"coin": "PUMP"
}
],
"category": "trade",
"equity": "296.16"
},
{
"coinDetail": [
{
"extMap": {
"priceUpper": "139.24762909452249825",
"priceLower": "125.99709511942565098",
"equityUnit": "USD"
},
"equity": "3.4268",
"coin": "SOL-USDC"
},
{
"extMap": {
"priceUpper": "3.91780569",
"priceLower": "3.54499491",
"equityUnit": "USD"
},
"equity": "3.3879",
"coin": "JLP-USDC"
}
],
"category": "farm",
"equity": "39.16"
}
]
}
]
},
"retExtInfo": {},
"time": 1772449025426
}