Market by Slug

Get trades and positions for a market by its URL slug.

Look up a market by its slug (the URL path on Polymarket) and get trades or positions across all outcomes.

Trades by slug

GET /v3/markets/slug/{slug}/trades

Query parameters

Parameter	Type	Default	Description
after	integer	—	Start of time range (Unix timestamp)
before	integer	—	End of time range
limit	integer	100	Max 300
offset	integer	0	Pagination offset

Example

curl "https://api.polynode.dev/v3/markets/slug/dota2-aur1-liquid-2026-05-13/trades?limit=1"

Returns the same enriched trade format as Wallet Trades.

Positions by slug

GET /v3/markets/slug/{slug}/positions

Returns every wallet holding (or that has ever held) any outcome of this market, across V1 + V2, with realized P&L computed from the V2 adapter pipeline.

Query parameters

Parameter	Type	Default	Description
limit	integer	100	Max 300
offset	integer	0	Pagination offset
sort	string	realized_pnl	One of amount, volume, realized_pnl, pnl
status	string	—	open (current holders only) or closed (zeroed-out positions only). Omit to return all.

For this market-scoped endpoint, status is a holder-state filter on the current raw balance. open means amount > 0; closed means amount = 0. It is not the wallet/global lifecycle status split, where resolved nonzero positions are redeemable and resolved zero-balance positions are redeemed.

Example

curl "https://api.polynode.dev/v3/markets/slug/dota2-aur1-liquid-2026-05-13/positions?limit=1"

{
  "data": [
    {
      "user": "0xca70278943df14029a0f819f9baf060f67860908",
      "token_id": "2241710011255999173993483096156975147842635212627942653724495466212043852479",
      "amount": "0",
      "avg_price": "500000",
      "total_bought": "2000000",
      "realized_pnl": "998000"
    }
  ],
  "rows_returned": 1,
  "has_more": true,
  "offset": 0,
  "limit": 1,
  "elapsed_ms": 179
}

Response fields

Field	Type	Description
user	string	Wallet address (lowercased)
token_id	string	Outcome token ID this row is about
amount	string	Current balance in raw 6-decimal USDC (0 if fully exited)
avg_price	string	Time-weighted average buy price in raw 6-decimal USDC (500000 = $0.50)
total_bought	string	Cumulative cost-basis of all purchases in raw 6-decimal USDC
realized_pnl	string	Realized P&L on closed-out portion of the position in raw 6-decimal USDC