Skip to main content
GET
/
v0
/
user
/
{address}
/
balances
# Hosted reads need: pmxt_api_key + wallet_address (private_key is only required for writes).
import pmxt

client = pmxt.Polymarket(
    pmxt_api_key="YOUR_PMXT_API_KEY",
    wallet_address="0xYourWallet",
)
balances = client.fetch_balance()
balance = balances[0]
print(balance.available, balance.currency)
{
  "currency": "USDC",
  "amount": 123
}
Available on: Polymarket, Opinion, Limitless. Other venues raise NotSupported in hosted mode — for those, run a local PMXT service.
Use any EVM private key. Your USDC sits in a non-custodial PreFundedEscrow on Polygon — the single funding location for every hosted venue (including Opinion, which PMXT settles cross-chain for you). PMXT cannot move funds without your EIP-712 signature.

Authorizations

​
Authorization
string
header
required

Required when calling the hosted API directly (curl, requests, fetch). SDK users pass credentials via constructor params instead.

Path Parameters

​
address
string
required

EVM wallet address (lowercase or checksum).

Response

Balance for the wallet.

Hosted-mode Balance shape. Returns USDC held inside the PMXT PreFundedEscrow contract.

​
currency
string
default:USDC
required

Currency code. Always USDC -- the only collateral accepted by the hosted escrow.

​
amount
number
required

Spendable USDC dollars held inside the PMXT PreFundedEscrow on Polygon (NOT the venue-native CLOB-proxy balance). Backs trading across every hosted venue, including Opinion.

​
venue
enum<string> | null

Set when the hosted backend returns a per-venue breakdown; null when balance is venue-agnostic.

Available options:
polymarket,
opinion