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.

Guide

Website

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

1curl 'https://api.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'

Hyperliquid Outcomes

Outcomes Lookup

PREVIEW

Returns HIP-4 outcome markets with metadata and 24h trading rollup. Each outcome trades as two side coins (Yes/No or custom labels) under one collateralized market.

Filter with outcome_id for direct lookup, question_id to walk a multi-outcome question, or status to scope to live or settled outcomes. question.question_id IS NULL indicates a binary single-outcome market (no parent question grouping in HL outcomeMeta).

The two side coins are exposed in sides[]; use them with /v1/hyperliquid/outcomes/ohlc (per-leg) and /v1/hyperliquid/outcomes/trades (per-leg fills). Trade-shaped endpoints like /v1/hyperliquid/markets/* reject outcome coins.

GET

https://api.pinax.network/v1/hyperliquid/outcomes

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

Optional parameters

Name	Type	Description
outcome_id query	string · uint64	HIP-4 outcome id (UInt64). One outcome has two side coins, `#<id10>` and `#<id10+1>`. Single value or array of values* (separate multiple values with `,`) *Plan restricted. e.g. 172
question_id query	string · uint64	HIP-4 question id (UInt64). Groups multi-outcome questions (e.g. World Cup). Binary single-outcome markets have no question id. Single value or array of values* (separate multiple values with `,`) *Plan restricted. e.g. 32
status query	Enum · 3	`live` (still trading) or `settled` (resolution captured via `settledOutcome` probe). `all` returns both. livesettledall
quote_token query	string	Quote token for the outcome market (e.g. `USDC`, `USDH`). e.g. USDC
include_fallback query	boolean	When `true`, include each multi-outcome question's fallback row (the catch-all "none of the above" leg). Defaults to `false` so list responses match the named outcomes a UI would render. Explicit `outcome_id` lookups always return the requested rows regardless of this flag.
sort_by query	Enum · 3	`volume_24h` (default) sorts by combined Yes+No leg volume in last 24h, ties broken by `outcome_id`. `last_trade` sorts by recency. `outcome_id` sorts numerically ascending. volume_24hlast_tradeoutcome_id
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": [
    {
      "outcome_id": 173,
      "name": "Argentina",
      "description": "This outcome resolves to Yes if Argentina is officially declared the 2026 FIFA World Cup champion.",
      "side_specs": [
        "Yes",
        "No"
      ],
      "status": "live",
      "quote_token": "USDC",
      "settle_fraction": null,
      "settle_details": null,
      "sides": [
        {
          "label": "Yes",
          "coin": "#1730",
          "side_index": 0
        },
        {
          "label": "No",
          "coin": "#1731",
          "side_index": 1
        }
      ],
      "price_yes": 0.09604,
      "price_no": 0.90313,
      "price_yes_24h": 0.09425,
      "price_no_24h": 0.90575,
      "price_yes_24h_change": 0.018992,
      "price_no_24h_change": -0.002893,
      "volume_24h": 82430.17,
      "trades_24h": 93,
      "last_trade": "2026-06-16 15:50:51",
      "question": {
        "question_id": 32,
        "name": "2026 World Cup Champion",
        "description": "Each associated outcome corresponds to a team confirmed to be participating ...",
        "fallback_outcome_id": 171,
        "named_outcome_ids": [
          172,
          173,
          174
        ],
        "settled_outcome_ids": []
      }
    }
  ]
}