Polymarket Markets API

Live queryable Polymarket data. The /v1/polymarket REST namespace serves market discovery and detail, one token's tape summary, candles, order-book snapshots, the raw event tape and on-chain settlements, plus per-wallet positions and PnL and smart-money aggregation — the last two also as MCP tools.

Coverage: Markets, tape, order books, candles, settlements, wallet profiles and smart-money signals. Free — API key — delivered via MCP · API.

Data summary

Getting started

# Substring match on the market slug; active=true keeps open markets only.
curl -H "X-API-KEY: vk_..." \
  "https://data.vike.io/v1/polymarket/markets?query=bitcoin&active=true"

import requests

r = requests.get("https://data.vike.io/v1/polymarket/markets",
                 params={"query": "bitcoin", "active": "true"},
                 headers={"X-API-KEY": "vk_..."}, timeout=30)
r.raise_for_status()
for m in r.json():                 # a JSON array of markets
    print(m["slug"], m["condition_id"], m["token_ids"])

{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
 "params": {"name": "polymarket_smart_money",
            "arguments": {"mode": "flows", "hours": 24}}}

Example applications

• Smart-money screening

  If you believe historically profitable wallets are early on mispriced markets, polymarket_smart_money surfaces where they are concentrating before you commit research time to a market.

• Wallet due diligence

  If a wallet keeps showing up on the right side of resolutions, polymarket_wallet gives you its positions and PnL history — enough to separate skill from one lucky election.

• Market discovery for archive studies

  If you are about to replay a market from the L2 archive, /v1/polymarket/markets and its detail route resolve slugs, condition_ids and token ids — the join keys the Parquet files are organized by — and /settlements gives the on-chain resolution.

Access

FAQ

Related datasets