Polymarket prediction market data endpoints, plus API documentation and monitoring.

Read-only preview

You're browsing the public OpenAPI spec. Sign in to send live requests with your team's API key.

Quickstart

Preview Polymarket activity with recent trade events for a market token. Swap in any token, condition, or event type from the endpoint catalog below.

Website

No API key on this team yet — sample shows <YOUR_JWT> placeholder.

cURL

1curl 'https://token-api.service.pinax.network/v1/polymarket/markets/activity?token_id=53342136288932702007624506186417846874594504126387502748453102780630218207922&event_type=trade&limit=10&page=1' \
2  -H 'Authorization: Bearer <YOUR_JWT>' \
3  -H 'Accept: application/json'

Polymarket Markets

Market Positions

Returns all user positions for a specific outcome token — a leaderboard view. Each row is one user's cumulative position: cost basis, PNL, shares held, and current value.

For a user's portfolio across all markets, use /v1/polymarket/positions instead.

GET

https://token-api.service.pinax.network/v1/polymarket/markets/positions

Requires bearer token — sign in to inject your team’s key.

Required parameters

Name	Type	Description
token_idrequired query	string	e.g. 53342136288932702007624506186417846874594504126387502748453102780630218207922

Optional parameters

Name	Type	Description
closed query	boolean
sort_by query	Enum · 7	position_valuerealized_pnlunrealized_pnltotal_pnlpnl_pcttransactionsavg_price
limit query	integer	Number of items* returned in a single request. *Plan restricted.
page query	integer	Page number to fetch. Empty `data` array signifies end of results.

Response

200 OK

{
  "data": [
    {
      "user": "0xe8dd7741ccb12350957ec71e9ee332e0d1e6ec86",
      "buy_cost": 235027.61,
      "sell_revenue": 0,
      "realized_pnl": -235027.61,
      "unrealized_pnl": 235202.69,
      "total_pnl": 175.08,
      "pnl_pct": -1,
      "net_position": 235910.42,
      "avg_price": 0.996,
      "current_price": 0.997,
      "position_value": 235202.69,
      "active": true,
      "buys": 4573,
      "sells": 0,
      "transactions": 4573,
      "market": {
        "condition_id": "0x6331a779482df72d904c3c1e12b6409ff836bc06f8c97945cba9b25ada2c605c",
        "market_slug": "will-the-portland-trail-blazers-win-the-2026-nba-finals",
        "token_id": "48262548906086150698299934962091284390063927164151224719187427455086357699251",
        "outcome_label": "No",
        "closed": false
      }
    }
  ]
}