Get Lightning Balance

Retrieve your Lightning wallet balance from BitGo to view inbound, outbound, and on-chain funds. See the Guide.

You retrieve your Lightning wallet balance by calling the Get Wallet By ID endpoint. The response includes both Lightning channel balances (inbound and outbound liquidity in millisatoshis) and on-chain Bitcoin balances (in satoshis). Your total owned balance is balanceString + outboundBalance.

API Reference

// 1. Get Lightning Balance from BitGo
export BITGO_EXPRESS_HOST="<YOUR_LOCAL_HOST>"
export WALLET_ID="<YOUR_WALLET_ID>"
export ACCESS_TOKEN="<YOUR_ACCESS_TOKEN>"

curl -X GET \
  http://$BITGO_EXPRESS_HOST/api/v2/wallet/$WALLET_ID \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

// 1. Get Lightning Balance from BitGo
const { BitGo } = require('bitgo');
const accessToken = '<YOUR_ACCESS_TOKEN>';

// Initialize the SDK
const bitgo = new BitGo({
  accessToken: accessToken,
  env: 'test',
  customRootURI: 'https://app.bitgo-test.com',
});

// Enter your Lightning wallet
const walletId = '<YOUR_WALLET_ID>'
const existingWallet = await bitgo.coin('tlnbtc').wallets().get({ id: walletId });
console.dir(existingWallet);

Response

// 1. Get Lightning Balance from BitGo Response
{
  "id": "7b4a9deb…a3d71b8c",
  "users": [
    {
      "user": "7b3c6a28…b2f0042f",
      "permissions": ["admin", "spend", "view"]
    }
  ],
  "coin": "tlnbtc",
  "label": "my-lightning-wallet",
  "m": 1,
  "n": 1,
  "keys": ["7b4a9deb…e7bce339"],
  "keySignatures": {},
  "enterprise": "7b3c6a2b…5600fc94",
  "organization": "7b3c6a2b…b28e59df",
  "bitgoOrg": "BitGo Trust",
  "tags": [
    "7b4a9deb…a3d71b8c",
    "7b3c6a2b…5600fc94"
  ],
  "disableTransactionNotifications": false,
  "freeze": {},
  "deleted": false,
  "approvalsRequired": 1,
  "isCold": false,
  "coinSpecific": {
    "watchOnlyAccounts": null,
    "keys": [
      "7b4a9deb…73ebfea7",
      "7b4a9deb…70dcd04f"
    ]
  },
  "admin": {
    "policy": {
      "date": "2026-01-15T10:22:34.000Z",
      "id": "7b4a9deb…bf38c3fb",
      "label": "default",
      "rules": [],
      "version": 0,
      "latest": true
    }
  },
  "clientFlags": [],
  "walletFlags": [],
  "allowBackupKeySigning": false,
  "recoverable": true,
  "startDate": "2026-01-15T10:22:34.000Z",
  "type": "hot",
  "buildDefaults": {},
  "customChangeKeySignatures": {},
  "hasLargeNumberOfAddresses": false,
  "hasReceiveTransferPolicy": false,
  "creator": "7b3c6a28…b2f0042f",
  "walletFullyCreated": true,
  "subType": "lightningCustody",
  "config": {},
  "offchain": {
    "inboundBalance": "500000000",
    "inboundPendingBalance": "0",
    "inboundUnsettledBalance": "0",
    "outboundBalance": "1000000000",
    "outboundPendingBalance": "0",
    "outboundUnsettledBalance": "0",
    "outboundLockedBalance": "0",
    "outboundReservedBalance": "100000000",
    "outboundSpendableBalance": "900000000"
  },
  "balanceString": "15000000",
  "confirmedBalanceString": "15000000",
  "spendableBalanceString": "15000000",
  "pendingApprovals": []
}