Skip to main content
The client.data namespace mirrors Polymarket’s classic data service. It is split into two segments:
  • Core — portfolio-focused endpoints (client.data.core.*).
  • Misc — supporting analytics (client.data.misc.*).
Guaranteed shape: Every request and response is validated with Zod before data reaches your application. Schema mismatches surface immediately with descriptive errors.

Positions

Token balances, cash/percent PnL, redeemable/mergeable flags.

Trades

Historical fills with filters for user, market IDs, and trade side.

Activity

Chronological feed of trades, rewards, splits, merges, and conversions.

Holders

Outcome-level holder breakdowns with profile metadata.

Portfolio Value

Aggregate USDC exposure per wallet, with optional market filtering.

Open Interest

Token-level open interest snapshots and global aggregates.

Live Volume

Real-time volume for individual events, including per-market totals.

Traded Markets

Count how many markets a wallet has traded historically.

​
Version compatibility

The SDK targets https://data-api.polymarket.com. When the upstream API evolves, validation errors will highlight mismatched fields. Capture the new payload and submit a PR to keep schemas aligned.