GET /v1/balances — Query Subaccount Venue Balances

Retrieve cash and collateral balances for a subaccount across Demo, Polymarket, and Kalshi prediction market venues. Endpoint: GET /v1/balances.

Call client.portfolio.balances() to retrieve the current cash and collateral balances for a subaccount across all supported prediction market venues — Demo, Polymarket, and Kalshi. The response contains one balance record per venue that the subaccount holds funds at, giving you a consolidated view of available capital before placing orders.

Method

client.portfolio.balances(subaccount_id)

Endpoint: GET /v1/balances

Example

from molecule import Molecule

client = Molecule(
    base_url="https://api.molecule.trade",
    key_id="key_abc123",
    private_key="<base64-encoded-ed25519-seed>",
)

balances = client.portfolio.balances(subaccount_id="sa_abc123")

for balance in balances:
    print(balance)

Parameters

subaccount_id · string · required

The subaccount whose balances to retrieve.

Response

The endpoint returns a list of balance objects, one per venue. Common fields:

venue · string

The venue name. One of Demo, Polymarket, or Kalshi.

available · string

Available balance (not locked in open orders) as a decimal string.

total · string

Total balance including amounts locked in open orders, as a decimal string.

Notes

Subscribe to the /v1/ws/balances WebSocket stream to receive balance updates in real time as orders fill or funds settle. See the WebSocket overview for connection details.

Balances are reported at the subaccount level and denominated in the collateral currency of each venue.