Polkyo API · v1

Polymarket's smart money,
as an API.

Who holds each side of every market, how good their records are, which markets the strategy picks right now, and how it has done. The data behind every page here, as JSON, refreshed every 5 minutes.

10 endpoints5 min refresh100,000 requests / month120 / minute

Get API access Read the reference

Markets ranked by smart money

$ curl https://polkyo.com/api/v1/markets \
    -H "X-API-Key: pw_live_…"

{
  "data": [{
    "conditionId": "0x9c1a…e4",
    "question": "Will the Fed cut rates in October?",
    "outcomes": ["Yes", "No"], "outcomePrices": [0.64, 0.36],
    "volumeUsd": 5532286, "endDate": "2026-10-28T18:00:00.000Z",
    "signal": {
      "snapshotAt": "2026-10-01T10:15:00.000Z",
      "sides": [
        { "price": 0.64, "holders": 812, "valueUsd": 1840210, "winrate": 0.58, "smart": 0.71, "coverage": 0.83 },
        { "price": 0.36, "holders": 640, "valueUsd": 990410, "winrate": 0.51, "smart": 0.34, "coverage": 0.77 }
      ],
      "smartShift24h": 6.2
    }
  }],
  "has_more": true, "next_offset": 50
}

Your access

Sign in to get API keys

API access is part of Pro: up to 5 keys, 100,000 requests a month and 120 a minute.

Try it

Endpoint

Every scanned Polymarket market, ranked by how differently profitable wallets hold its two sides. Decided markets (0¢ / 100¢) are left out. Each market carries both sides' price, holders, value, win rate, smart-money share and coverage, refreshed every 5 minutes.

sort smartfav | smart | shiftcategory stringsearch stringmin_coverage 0–1limit 1–100offset integerYour API key

curl "https://polkyo.com/api/v1/markets" \
  -H "X-API-Key: $POLKYO_API_KEY"

Example response

{
  "data": [{
    "conditionId": "0x9c1a…e4",
    "question": "Will the Fed cut rates in October?",
    "outcomes": ["Yes", "No"], "outcomePrices": [0.64, 0.36],
    "volumeUsd": 5532286, "endDate": "2026-10-28T18:00:00.000Z",
    "signal": {
      "snapshotAt": "2026-10-01T10:15:00.000Z",
      "sides": [
        { "price": 0.64, "holders": 812, "valueUsd": 1840210, "winrate": 0.58, "smart": 0.71, "coverage": 0.83 },
        { "price": 0.36, "holders": 640, "valueUsd": 990410, "winrate": 0.51, "smart": 0.34, "coverage": 0.77 }
      ],
      "smartShift24h": 6.2
    }
  }],
  "has_more": true, "next_offset": 50
}

Authentication & limits

Authenticate

Send your key with every request, in a header. Never in the URL, where logs keep it.

X-API-Key: pw_live_…
# or
Authorization: Bearer pw_live_…

Limits

100,000 requests per calendar month (UTC) and 120 per minute, shared by all your keys. Every response says where you stand:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42        # seconds
X-Quota-Remaining: 98160
X-Quota-Reset: 2026-11-01T00:00:00Z

Errors

Errors are JSON with a stable code:

401	`missing_key` · `invalid_key`
403	`plan_required`
429	`rate_limited` (see Retry-After) · `quota_exceeded`
400 / 404	bad parameter · unknown market or trader

Snapshots are taken every 5 minutes, so polling a market more often returns the same figures. For live picks, every 5 minutes is plenty. Base URL: https://polkyo.com/api/v1

Reference

GET/v1/markets

Markets ranked by smart money

Parameter	Type	Description
`sort` query	smartfav \| smart \| shift default smartfav	smartfav: smart money on the side the price favours (the pattern that has beaten its price). smart: biggest smart-money gap. shift: biggest move in the last 24 h.
`category` query	string	A Polymarket category or sub-category slug.
`search` query	string	Words in the question.
`min_coverage` query	0–1 default 0	Minimum share of the money whose holders are scored.
`limit` query	1–100 default 50	Markets per page.
`offset` query	integer default 0

GET/v1/markets/{condition_id}

One market

A scanned market's details, how much snapshot history is held for it, and its current signal.

Parameter	Type	Description
`condition_id`required	0x… (66 chars)	The market's condition id.

Example response

{ "data": { "condition_id": "0x9c1a…e4", "question": "…", "outcome_labels": ["Yes", "No"], "prices": [0.64, 0.36],
  "volume_usd": 5532286, "end_date": "…", "snapshots": { "first": "…", "last": "…", "snapshots": 1210 }, "signal": { … } } }

GET/v1/markets/{condition_id}/history

Signal history

Both sides' figures at every 5-minute snapshot: price, holders, value, scored value, profitable holders and value, win rates, median PnL.

Parameter	Type	Description
`condition_id`required	0x…	The market's condition id.
`days` query	1–365 default 7	How far back.

Example response

{ "data": [
  { "outcome_index": 0, "ts": "2026-10-01T10:15:00+00:00", "price": 0.64, "holders": 812, "value_usd": 1840210,
    "value_with_stats": 1527374, "profitable_value": 1084435, "value_weighted_winrate": 0.58 }, …
] }

GET/v1/markets/{condition_id}/holders

Top holders

The largest holders of each side right now, with each wallet's lifetime PnL, volume, closed markets and wins.

Parameter	Type	Description
`condition_id`required	0x…	The market's condition id.
`limit` query	1–200 default 25	Holders per side.

Example response

{ "data": [
  { "outcome_index": 0, "wallet": "0x56…7f", "shares": 120400, "value_usd": 77056, "name": "BreakTheBank",
    "pnl": 2612000, "closed_count": 468, "wins": 399 }, …
] }

GET/v1/markets/{condition_id}/activity

Holder moves

Recent entries, exits, adds and trims by holders, newest first, each with the wallet's record.

Parameter	Type	Description
`condition_id`required	0x…	The market's condition id.
`limit` query	1–500 default 50	How many moves.
`min_usd` query	number default 0	Only moves at least this large, in USD.

Example response

{ "data": [
  { "ts": "…", "outcome_index": 1, "wallet": "0x…", "kind": "enter", "prev_shares": 0, "shares": 5200, "price": 0.41,
    "delta_usd": 2132, "name": "…", "pnl": 91000, "closed_count": 210, "wins": 131 }, …
] }

GET/v1/traders

Trader leaderboard

Polymarket's profit or volume leaderboard for a period and category, or Polkyo's own all-time ranking by ROI or win rate, every row with our win rate and closed-market count.

Parameter	Type	Description
`period` query	day \| week \| month \| all default month	For profit and volume rankings.
`category` query	string default overall	overall, politics, sports, crypto, culture, economics, tech, finance, weather, mentions, esports.
`sort` query	pnl \| vol \| roi \| winrate default pnl	roi and winrate rank Polkyo's scored wallets, all time.
`min_closed` query	integer default 20	For winrate: minimum closed markets.
`search` query	string	A name or 0x address.
`offset` query	integer default 0	Pages of 50.

Example response

{ "data": [
  { "rank": 1, "address": "0x…", "name": "BreakTheBank", "pnl": 2612000, "volume": 36500000,
    "closedCount": 468, "winrate": 0.853 }, …
], "has_more": true }

GET/v1/traders/{address}

One trader

Profile, all-time and 30-day PnL and rank, volume, win rate, daily PnL series, open and recently closed positions, and the moves Polkyo recorded in scanned markets.

Parameter	Type	Description
`address`required	0x… (42 chars)	The wallet.

Example response

{ "data": { "address": "0x42b7…77dc", "name": "iceblue-", "rank": 9797, "pnl": 15636.55, "pnlMonth": 3132.12,
  "volume": 3233020.79, "winrate": 0.75, "closedCount": 270,
  "series": [{ "ts": 1727740800, "realized": 120.5, "unrealized": -30.2 }, …],
  "positions": […], "closed": […], "moves": […] } }

GET/v1/strategy/picks

Live strategy picks

Markets the strategy would buy right now: the same rule, entry window and filters as its backtest, from the latest snapshot. Poll every few minutes; a pick appears when a game enters its window and qualifies.

Parameter	Type	Description
`strategy` query	play \| favmid \| favmid2 \| play3h \| favmid3h \| heavyfav \| coinflip	One strategy; all of them when left out.

Example response

{ "data": [
  { "strategy": "play", "condition_id": "0x…", "question": "Islanders vs. Maple Leafs", "starts_at": "…", "hours_left": 2.4,
    "side": 1, "outcome": "Maple Leafs", "price": 0.555, "smart_lean": 0.41, "snapshot_at": "…" }
], "strategies": [{ "id": "play", "label": "The play", "entry_hours": { "minHours": 0.75, "maxHours": 4 } }, …] }

GET/v1/strategy/accuracy

Signal accuracy

How every signal and strategy has done on resolved markets (hit rate, implied chance and ROI after Polymarket's taker fee) by price band, day and category, plus each strategy replayed from its first qualifying snapshot.

Parameter	Type	Description
`hours` query	1 \| 6 \| 24 default 6	Snapshot taken this long before the market closed.
`category` query	string	Limit to one category.

Example response

{ "data": { "hours": 6, "stats": [{ "strategy": "play", "hours": 6, "n": 114, "hit_rate": 0.772, "roi": 0.191, "roi_gross": 0.207 }, …],
  "bot": [{ "strategy": "play3h", "n": 58, "roi": 0.162, … }], … } }

Polymarket's smart money,as an API.

Your access

Try it

Authentication & limits

Reference

Markets ranked by smart money

One market

Signal history

Top holders

Holder moves

Trader leaderboard

One trader

Live strategy picks

Signal accuracy

Your usage

Polymarket's smart money,
as an API.