Skip to main content
Use GET /polymarket/slug/{slug} with any resolved market slug below. Slugs match Polymarket’s own identifiers — pass the full slug string from the market URL or our S3 layout.

Top-level categories

We record two Polymarket families under polymarket/:
CategoryS3 prefixWhat we record
Cryptopolymarket/crypto/Up/down and price-target crypto markets on fixed intervals
Sportspolymarket/sports/All live sports markets Polymarket lists, grouped by sport/league

Crypto

Up/down markets

For each asset we record 5-minute, 15-minute, 4-hour, hourly, and daily up-or-down markets. Assets: BTC, ETH, SOL, XRP, DOGE, BNB, HYPE
TimeframeSlug pattern (examples)
5 minbtc-updown-5m-{epoch}, eth-updown-5m-{epoch}, …
15 minbtc-updown-15m-{epoch}, eth-updown-15m-{epoch}, …
4 hourbtc-updown-4h-{epoch}, eth-updown-4h-{epoch}, …
1 hourbitcoin-up-or-down-1h-{epoch}, ethereum-up-or-down-1h-{epoch}, …
Dailybitcoin-up-or-down-1d-{epoch}, ethereum-up-or-down-1d-{epoch}, …
{epoch} is the market window start as a Unix timestamp in seconds (e.g. btc-updown-5m-1780536000). Hourly and daily series use the full asset name (bitcoin, ethereum, solana, …) instead of the ticker prefix.

Price-target markets

We also record daily “what price will X hit?” markets and hourly “X above Y” strike markets:
TypeSeries slug prefixAssets
Daily price targetwhat-price-will-{asset}-hit-…BTC, ETH, SOL, XRP
Hourly above strike{asset}-above-hourly-…BTC, ETH
Each event expands into multiple outcome slugs (one per strike level).

Sports

We record all sports markets that Polymarket publishes. Discovery is automatic — there is no fixed allowlist of events. Each market is stored under:
polymarket/sports/{category}/{event_slug}/{market_slug}/
The API slug is the market slug (the innermost identifier), for example:
  • wta-xu-mandlik-2026-06-08 — match winner
  • wta-xu-mandlik-2026-06-08-match-total-21pt5 — totals prop
  • cs2-big5-b8-2026-06-09-game3-round-total-21pt5 — esports round total

Sport / league categories

Categories come from Polymarket’s sport label on each event. Examples we regularly record: Major leagues
  • mlb, nba-2026, nhl-2026, wnba, mls-2025, cfl, kbo
Tennis
  • atp, wta, atp-doubles, wta-doubles, itf
Soccer
  • la-liga-2, chinese-super-league, brazil-serie-b, primera-division, norway-eliteserien, and other league codes
Esports
  • counter-strike, valorant, league-of-legends, dota-2, call-of-duty, rainbow-six-siege, mobile-legends-bang-bang, overwatch, starcraft-2
Other
  • ufc, pga-tour, international-cricket, t20-blast, rugby-premiership, super-rugby-pacific, and more
New leagues appear as Polymarket adds them; if a category shows up on Polymarket near game time, we record it.

Finding a slug

  1. Open the market on polymarket.com — the URL path contains the slug.
  2. Or browse our S3 layout under polymarket/crypto/ or polymarket/sports/{category}/… in the chinolabs-historical-data bucket.
Once a market has resolved and been compressed, GET /polymarket/slug/{slug} returns the full orderbook history.