bybit-balance

n8n community node: overall Bybit balance per asset (Unified, Funding, Earn, Dual Asset, Crypto Loan)

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: Kirill Fedoseev

Available Nodes

Documentation generating…

Bybit Balance icon
Bybit Balance
Overall Bybit balance per asset: Unified, Funding, Earn, Dual Asset and Crypto Loan, in coin and USDT

Documentation

n8n-nodes-bybit-balance

n8n community node: общий баланс по активу на Bybit — сколько монеты лежит на всех
кошельках, в Earn и в криптозаймах, в монете и в USDT.

Установка

В self-hosted n8n: Settings → Community Nodes → Install → n8n-nodes-bybit-balance.

Credentials

Тип Bybit API: API Key, API Secret (HMAC, system-generated), Base URL
(по умолчанию https://api.bybit.com; для региональных аккаунтов — их хост,
например https://api.bybit.ae), Recv Window.

Права ключа (read-only достаточно): Wallet, Earn, Spot trade (последнее нужно
для позиции криптозайма). Без Earn источники Earn упадут — либо уберите их из
Sources, либо включите опцию Ignore Source Errors.

Параметры

  • Assets — группы через ; или перевод строки, монеты внутри группы через ,
    (суммируются): USDT, USDC; ETH, STETH; BTC. + тоже работает как ,.
    Можно JSON-массив (в т.ч. из выражения): ["BTC", ["USDT","USDC"], "ETH,STETH"]. * — все монеты с ненулевым балансом,
    каждая отдельной группой.
  • Sources — какие источники опрашивать (по умолчанию все).
  • Options
    • Output: один item на группу (по умолчанию) или один item со всеми группами и totalUsdt.
    • Include Zero Lines: показывать кошельки с нулём.
    • Ignore Source Errors: упавший источник не валит ноду, ошибка уходит в warnings.

Источники → кошельки в разбивке

Wallet Endpoint Что это
unified GET /v5/account/wallet-balance (UNIFIED) walletBalance
unified_borrow там же -spotBorrow (монеты, взятые в долг, уже сидят в unified)
unified_upnl там же unrealisedPnl
funding GET /v5/asset/transfer/query-account-coins-balance (FUND) walletBalance
earn_flexible GET /v5/earn/position?category=FlexibleSaving amount
earn_flexible_yield там же claimableYield — начислено, но ещё не выплачено
earn_onchain GET /v5/earn/position?category=OnChain amount
dual_asset GET /v5/earn/advance/position?category=DualAssets amount в investCoin
loan_collateral GET /v5/crypto-loan-common/position collateralList[].amount
loan_borrow там же -(fixedTotalDebt + flexibleTotalDebt)
loan_supply там же supplyList[].amount (выдано в fixed-rate займы)

Долги идут со знаком минус, total — нетто. unified + unified_borrow + unified_upnl
равно equity монеты в UTA (без стоимости опционов).

Цена в USDT — lastPrice публичного GET /v5/market/tickers?category=spot:
COINUSDT → COINUSDC × USDCUSDT → 1 / USDTCOIN. Нет пары — usdt: null
и предупреждение в warnings.

Не учитываются: старый Crypto Loan (/v5/crypto-loan/*), Launchpool, byUSDT,
боты, копитрейдинг, субаккаунты.

Выход (режим «один item на группу»)

{
  "assets": "USDT,USDC",
  "coins": ["USDT", "USDC"],
  "total": { "amount": 790.47, "usdt": 790.46 },
  "byCoin": {
    "USDT": { "amount": 665.37, "usdt": 665.37, "price": 1,
              "wallets": { "funding": { "amount": 50, "usdt": 50 }, "earn_flexible": { "amount": 300, "usdt": 300 } } },
    "USDC": { "amount": 125.1, "usdt": 125.09, "price": 0.9999, "wallets": { } }
  },
  "byWallet": { "funding": { "amount": 75.1, "usdt": 75.1 } },
  "breakdown": [ { "coin": "USDT", "wallet": "funding", "amount": 50, "usdt": 50 } ],
  "warnings": [],
  "fetchedAt": "2026-10-13T12:00:00.000Z"
}

total.amount — сумма количеств монет; осмысленна для похожих активов
(USDT, USDC или ETH, STETH). Для разнородных групп смотрите total.usdt.

Локальная разработка

npm install
npm run build
npm link
# в директории установки n8n:
npm link n8n-nodes-bybit-balance

Лицензия

MIT

Discussion