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 Activity

Returns a chronological feed of on-chain trades, position splits, merges, and redemptions. Each row includes the transaction hash, block number, and scaled amounts.

For trades, market.token_id and market.outcome_label identify the specific outcome token. For splits, merges, and redemptions, these are null because the operation applies to the market as a whole.

At least one of user, token_id, or condition_id is required. Defaults to the last 24 hours when no time range is specified — provide start_time and end_time to query older data.

GET

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

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

Optional parameters

Name	Type	Description
user query	string · evm-address
token_id query	string	e.g. 53342136288932702007624506186417846874594504126387502748453102780630218207922
condition_id query	string	e.g. 0x9708334534b504e2025a5a6af92f8600808c10be577e5066f920c40625fbec16
event_type query	Enum · 4	Filter by event type tradesplitmergeredeem
start_time query	Datetime	UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
end_time query	Datetime	UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).
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": [
    {
      "event_type": "trade",
      "timestamp": "2026-04-02 16:51:31",
      "block_num": 85014327,
      "tx_hash": "0xf190865afd395e2f4b8f2e5f8ceb2c05a86d94a73ea411e8a8a3fc649924c420",
      "user": "0x38e598961dd0456a7fb2e758bd433d3e59fb8a4a",
      "amount": "3976744",
      "value": 3.98,
      "fee_amount": "526315",
      "fee_value": 0.53,
      "market": {
        "condition_id": "0xcb37916b953e6b37a5be32ceabc5a093614be15d9e6abb7668bf6400fbf36d46",
        "market_slug": "bitcoin-up-or-down-on-april-3-2026",
        "token_id": "3861173442961229042274748637211736540847931193208187121747580704941582603312",
        "outcome_label": "Down",
        "closed": false
      }
    },
    {
      "event_type": "split",
      "timestamp": "2026-04-02 16:54:27",
      "block_num": 85014415,
      "tx_hash": "0x144e86c0cd14880a6615dc1853e4438287efde3a9fb0ddca618a1b48d22d59bf",
      "user": "0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e",
      "amount": "680000",
      "value": 0.68,
      "fee_amount": "0",
      "fee_value": 0,
      "market": {
        "condition_id": "0xb03edede6288cd4e3af35e9aa2d8eeb1a8a0fcde8ba270cc2ae3677bd6dc44f0",
        "market_slug": "btc-updown-5m-1775148600",
        "token_id": null,
        "outcome_label": null,
        "closed": false
      }
    }
  ]
}