Fetch Balance

Check the USDC available for trading. Returns the wallet’s balance inside the PMXT escrow on Polygon — not the wallet’s on-chain USDC balance.

Top up by depositing at pmxt.dev/dashboard/wallet.

GET /v0/user/{address}/balances

Python

Polymarket

# 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)

200

{
  "currency": "USDC",
  "amount": 123
}

{
  "error": {
    "message": "<string>",
    "retryable": true,
    "exchange": "<string>",
    "detail": {}
  }
}

{
  "error": {
    "message": "<string>",
    "retryable": true,
    "exchange": "<string>",
    "detail": {}
  }
}

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 — for Polymarket, Opinion, and Limitless. 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

200

application/json

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 on Polymarket, Opinion, and Limitless.

venue · enum<string> | null

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

Available options: polymarket, opinion, limitless