---
title: "Fetch Balance"
method: GET
path: "/v0/user/{address}/balances"
tags: ["Orders & Positions"]
---

# Fetch Balance

`GET /v0/user/{address}/balances`

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](https://pmxt.dev/dashboard/wallet).

## Path parameters

- `address` string, required

## Response `200`

Balance for the wallet.

- BalanceV0 — Hosted-mode `Balance` shape. Returns USDC held inside the PMXT `PreFundedEscrow` contract.
  - `currency` string, 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` 'polymarket' | 'opinion' | 'limitless', nullable — Set when the hosted backend returns a per-venue breakdown; null when balance is venue-agnostic.

## Other responses

- `401` — Invalid or missing PMXT API key.
- `503` — Catalog or escrow indexer temporarily unavailable.

## Changes

- **2026-06-24** `6784cc7c8376` — 1 warning
  - added the new `limitless` enum value to the `venue` response property for the response status `200`
- **2026-06-09** `6c1e54fea3a3` — 2 info
  - api tag `Orders & Positions` added
  - api tag `Orders & Positions (Hosted)` removed

[Change history](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api/changes/v0/user/:address/balances/get.md)

---

[API](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api.md) · [All operations](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pmxt-dev/pmxt-hosted-router-api/revisions/9ee3cbe2dc87/schema)