Smart Money Positioning (Polymarket)

How smart-money wallets are positioned in a single market over the window: net buyers vs. sellers, buy/sell volume split, and volume-weighted entry prices, with a per-wallet breakdown. Pairs with Smart Activity Markets - discover a market there, then drill into it here. Cost-basis PnL/ROI fields are not yet computed and are returned as null.

GET/v2/polymarket/market/{condition_id}/smart-money

Plans All plansPlan rate limits apply

Parameters

condition_idstring (path)required

Market condition ID - must match ^0x[0-9a-f]{64}$.

windowstring

Optional. 1d (default), 7d, 30d, or all_time. Longer windows favor recently-active wallets.

Response

smart_wallet_criteriaobject

Thresholds defining a smart-money wallet for this response.

Show 2 fields

min_lifetime_pnl_usdnumber

Minimum lifetime PnL (USD) to count as smart money.

min_trade_notional_usdnumber

Minimum per-fill notional (USD) counted.

windowstring

Rolling window applied (1d, 7d, 30d, all_time).

condition_idstring

Market condition ID.

titlestring

Market title (null if not resolved).

market_slugstring

Market slug (null if not resolved).

smart_wallet_countinteger

Distinct smart wallets active in this market in the window.

net_buyersinteger

Smart wallets whose buy volume exceeds sell volume.

net_sellersinteger

Smart wallets whose sell volume exceeds buy volume.

neutralinteger

Smart wallets with balanced buy/sell volume.

net_buyers_pctnumber

net_buyers / smart_wallet_count (0–1).

total_smart_volumenumber

Total smart-money notional (USD).

total_smart_buy_volumenumber

Buy-side smart notional (USD).

total_smart_sell_volumenumber

Sell-side smart notional (USD).

avg_smart_buy_pricenumber

Volume-weighted average smart buy price (0–1).

avg_smart_sell_pricenumber

Volume-weighted average smart sell price (0–1).

total_smart_realized_pnlnumber

Realized PnL. Not yet computed - returned as null (see _meta.unavailable_fields).

total_smart_total_pnlnumber

Total PnL. Not yet computed - returned as null.

avg_smart_roinumber

Average ROI. Not yet computed - returned as null.

avg_smart_win_ratenumber

Average win rate. Not yet computed - returned as null.

smart_walletsarray

Top smart wallets in this market by volume (capped).

Show 4 fields

proxy_walletstring

Smart wallet (Polymarket proxy address).

lifetime_pnlnumber

Wallet lifetime PnL (USD).

smart_volumenumber

This wallet's notional in this market in the window (USD).

sidestring

buyer, seller, or neutral for this market in the window.

_metaobject

Source, data floor, and field-availability metadata.

Show 5 fields

sourcestring

Data source identifier.

data_available_fromstring

ISO timestamp; trade data is served from this point onward.

unavailable_fieldsarray

Fields returned as null pending per-wallet cost-basis accounting.

notestring

Which fields are exact vs. not yet available.

coverage_notestring

How smart-wallet coverage relates to the chosen window.