Asset Overview
Query master account or one subaccounts' total assets and detailed asset holdings across different accounts and product categories.
info
This endpoint does not support any regional account, e.g., Bybit KZ, GE, EU, etc.
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
}