Exchange Balance

curl --request GET \
     --url 'https://api.finrock.io/dac/v1/exchange-balance?exchange=Binance' \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

[
  {
    "asset": "BTC",
    "asset_ticker": "BTC",
    "balance": 0.025,
    "balance_in_usd": 1675.25
  },
  {
    "asset": "ETH",
    "asset_ticker": "ETH",
    "balance": 0.5,
    "balance_in_usd": 1250.00
  }
]

GET

dac

exchange-balance

curl --request GET \
     --url 'https://api.finrock.io/dac/v1/exchange-balance?exchange=Binance' \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

[
  {
    "asset": "BTC",
    "asset_ticker": "BTC",
    "balance": 0.025,
    "balance_in_usd": 1675.25
  },
  {
    "asset": "ETH",
    "asset_ticker": "ETH",
    "balance": 0.5,
    "balance_in_usd": 1250.00
  }
]

MCP scope: dac.read Once you have connected an exchange account to your Finrock workspace, use this endpoint to fetch the current asset balances held on that exchange. Specify the exchange name in the query string and the API returns a breakdown of all asset balances available on the connected account, giving you real-time visibility without leaving the Finrock platform.

Query Parameters

Method: GET URL: https://api.finrock.io/dac/v1/exchange-balance

string

required

The name of the connected exchange whose balance you want to retrieve. Must match one of the exchange names returned by the List Exchange Accounts endpoint (e.g., Binance, Coinbase, OKX, KuCoin, Bybit).

curl --request GET \
     --url 'https://api.finrock.io/dac/v1/exchange-balance?exchange=Binance' \
     --header 'Authorization: Bearer {JWT}' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

Response

The response is an array with one entry per asset on the exchange account, including assets with a zero balance.

string

Asset ID, the id value from Supported Assets, for example BTC or USDT_TRX.

string

Ticker symbol of the asset, for example BTC, ETH, or USDT.

float

Amount of the asset held on the exchange account, in units of the asset.

float

Value of balance in US dollars.

[
  {
    "asset": "BTC",
    "asset_ticker": "BTC",
    "balance": 0.025,
    "balance_in_usd": 1675.25
  },
  {
    "asset": "ETH",
    "asset_ticker": "ETH",
    "balance": 0.5,
    "balance_in_usd": 1250.00
  }
]

Balances reflect what Finrock last retrieved from the exchange. If you need the freshest data, call this endpoint immediately before initiating a transfer rather than relying on cached values.