Market by 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

Overview

V3 Data API

Wallet P&L

Wallet Activity

Credits

Identity

Fees

Combos

Rewards

Markets & Search

Orderbook

Leaderboard & Tags

Builders

Polymarket Profiles

Global

Tokens

Perps

Perps Market Data

Perps Wallets

Perps Analytics

Perps On-Chain

Perps Streaming

Crypto

Sports

BYOL

Backtesting

Market Card

System

Search & Context

Onchain V2 (legacy)

Trades by slug

Query parameters

Example

Positions by slug

Query parameters

Example

Response fields

​Trades by slug

​Query parameters

​Example

​Positions by slug

​Query parameters

​Example

​Response fields

Trades by slug

Query parameters

Example

Positions by slug

Query parameters

Example

Response fields