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 Activity

PREVIEW

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

Returns the chronological composition-event feed for HIP-4 outcome positions — one row per (event, affected leg). Covers SETTLEMENT (resolution payouts), SPLIT_OUTCOME (mint Yes+No from collateral), MERGE_OUTCOME (redeem Yes+No to collateral), MERGE_QUESTION (redeem the full Yes-set of a multi-outcome question), and NEGATE_OUTCOME (convert a No-A holding into Yes-on-every-other-outcome under the same question).

BUY/SELL taker fills are not served by this endpoint — query /v1/hyperliquid/outcomes/trades for those. The direction enum here is restricted to the five composition tags; passing BUY/SELL returns 400.

Filters compose additively. Defaults to the last 24 hours when no time range is specified.

closed_pnl carries the realized USDC delta for the row's leg (settlement payouts on the winning leg are positive; merge/redeem rows carry the collateral-side delta). For position-level rollups see /v1/hyperliquid/outcomes/users; for current open share balances see /v1/hyperliquid/outcomes/users/positions.

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/activity

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
direction query	Enum · 5	Composition events only. `SETTLEMENT` is the resolution payout; the four `_OUTCOME`/`MERGE_QUESTION` tags are HIP-4 collateral reshapes. BUY/SELL not accepted — for taker fills query `/outcomes/trades`. Single value or array of values (separate multiple values with `,`) *Plan restricted. SETTLEMENTSPLIT_OUTCOMEMERGE_OUTCOMEMERGE_QUESTIONNEGATE_OUTCOME e.g. SETTLEMENT
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": [
    {
      "block_num": 1037754379,
      "timestamp": "2026-06-16 13:47:12",
      "transaction_hash": "0xb31e3ae0c464cc5cb497043ddae00b020c9700c65f67eb2e56e6e6338368a647",
      "event_index": 12,
      "user": "0xfcecc2a54724cf0502eb7c916e2717ef76a510ed",
      "side": "BID",
      "direction": "NEGATE_OUTCOME",
      "size": 26445,
      "closed_pnl": 0,
      "outcome": {
        "outcome_id": 353,
        "outcome_name": "Brazil",
        "question_id": 32,
        "question_name": "2026 World Cup Champion",
        "status": "live",
        "settle_fraction": null,
        "coin": "#3530",
        "side_index": 0,
        "side_label": "Yes"
      }
    }
  ]
}