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

Outcome User Positions

PREVIEW

At least one of `user`, `coin`, `outcome_id`, or `question_id` is required — calls without any of these return 400.

Returns each user's current open share balance per outcome leg, derived from the full history of outcome_fills. HIP-4's side field encodes share-flow direction (BID = receive, ASK = release); the running sum across BUY/SELL/SETTLEMENT/SPLIT/MERGE/NEGATE composition events yields the user's current share count, in line with HL spotClearinghouseState.balances[].

Filters compose additively. When user is omitted the response is a holder list for the requested outcome / question / coin scope, sorted by share_balance descending.

Only currently-open long positions are returned (share_balance > 0). Settled outcomes naturally drop out via SETTLEMENT ASK fills that zero the running sum. Coverage caveat: a sink that has not been backfilled to a block predating the user's earliest activity will under-report by the shares acquired before the backfill horizon. Reconcile against HL spotClearinghouseState when authoritative numbers are required.

Every row embeds the compact outcome leg context (outcome_id, outcome_name, question_id, question_name, status, settle_fraction, coin, side_index, side_label). For full outcome metadata call /v1/hyperliquid/outcomes?outcome_id=....

GET

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

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

Optional parameters

Name	Type	Description
user query	string · evm-address	Filter by address Single value or array of values* (separate multiple values with `,`) *Plan restricted. e.g. 0xd8da6bf26964af9d7eed9e03e53415d37aa96045
coin query	string	Outcome coin (`#<outcome_id10 + side_index>`). Side index = 0 or 1. Bare digits accepted (auto-prefixed). Discover via `/v1/hyperliquid/outcomes`. Single value or array of values (separate multiple values with `,`) *Plan restricted. e.g. #1720
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
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": "0xfcecc2a54724cf0502eb7c916e2717ef76a510ed",
      "share_balance": 59601,
      "last_fill_time": "2026-06-17 14:00:35",
      "last_block_num": 1039020363,
      "outcome": {
        "outcome_id": 357,
        "outcome_name": "Argentina",
        "question_id": 32,
        "question_name": "2026 World Cup Champion",
        "status": "live",
        "settle_fraction": null,
        "coin": "#3570",
        "side_index": 0,
        "side_label": "Yes"
      }
    }
  ]
}