API referencev2

Prediction Markets API.

Live JSON and CSV access to every widget on PredictionMarketsPicks — Kalshi and Polymarket data, plus The 7 Oracles' Monte Carlo simulations for the World Cup. Free tier needs no signup. Pro and Enterprise unlock per-key rate limits and origin allowlisting.

Quickstart

Fetch the latest US recession probability payload:

curl https://predictionmarketspicks.com/api/public/recession-tracker

Add your API key for the higher Pro / Enterprise limits:

curl -H "X-API-Key: pmp_v2_pro_..." \
  https://predictionmarketspicks.com/api/public/recession-tracker

Endpoints

GET/api/public/[slug]

JSON payload for any widget V2 slug. Returns latest snapshot, deduplicated by outcome.

curl -H "X-API-Key: pmp_v2_pro_..." \
  https://predictionmarketspicks.com/api/public/recession-tracker

GET/api/public/[slug]?format=csv

Same payload as JSON, encoded as CSV with a Content-Disposition attachment header. Browser-friendly download.

curl -H "X-API-Key: pmp_v2_pro_..." \
  "https://predictionmarketspicks.com/api/public/sp500-forecast?format=csv" -o sp500.csv

GET/embed/[slug]/[variant]

HTML embed (iframe-friendly). Supports ?theme=parchment|indigo and ?key=... for tier upgrades.

<iframe src="https://predictionmarketspicks.com/embed/recession-tracker/hero?key=pmp_v2_pro_..."
  width="560" height="300" loading="lazy"></iframe>

Edge Alerts API

A Pro-gated JSON feed of the edge alerts our models generate — weather, bitcoin/silver/gold/oil, and mispricings today; NFL and more to come. We are a signal publisher: every subscriber receives the identical, impersonal feed at the same time. We never touch, store, or ask for anyone's exchange keys.

A Pro or Enterprise key returns the feed in real time. No key (or a bad one) returns the same feed delayed 24 hours with the thesis stripped — it never errors, it downgrades. Pair the header form with Authorization: Bearer for agent runtimes.

GET/api/v1/alerts

The alert feed, newest first. Keyset-paginated.

curl -H "X-API-Key: pmp_v2_pro_..." \
  "https://predictionmarketspicks.com/api/v1/alerts?feed=weather,mispricing&tier=STRONG&limit=25"

GET/api/v1/alerts/[id]

A single alert by id.

Query parameters

Param	Description
feed	Comma-separated feeds to include: weather, bitcoin, silver, gold, oil, mispricing, sports_arb, nfl. Omit for all.
tier	Minimum confidence tier: SPECULATIVE, MODERATE, or STRONG. Returns that tier and above.
since	ISO-8601 timestamp — only alerts created after it. Mutually exclusive with cursor.
cursor	Opaque keyset token from a previous response’s next_cursor. Pages backward through (created_at, id).
limit	Page size, 1–100 (default 25).

Response envelope

{
  "as_of": "2026-07-24T14:02:11Z",
  "delayed": false,
  "count": 1,
  "next_cursor": "MjAyNi4uLnw...",
  "alerts": [{
    "id": "…", "created_at": "…", "feed": "weather", "tier": "STRONG",
    "platform": "Kalshi", "event_ticker": "KXHIGHNY-26JUL25",
    "title": "New York high above 92°F — market 34¢, model 51%, edge 17pp",
    "side": "YES", "price_cents": 34, "model_prob": 0.51, "edge_pp": 17,
    "thesis": "…", "resolves_at": "…", "meta": { "quarter_kelly": 0.04 },
    "market_url": "https://kalshi.com/markets/…?referral=…&m=true",
    "info_url": "https://predictionmarketspicks.com/tools/weather?utm_source=api&utm_medium=feed&utm_campaign=weather"
  }],
  "docs": "https://predictionmarketspicks.com/docs/api",
  "disclaimer": "…"
}

Rate limits: Pro 5,000/hr and Enterprise 100,000/hr per key; the delayed tier is 60/hr per IP. Responses are cacheable (s-maxage=30) — cache on your side and poll no faster than the alerts move.

Impersonal market analysis for informational purposes only. Not investment advice. All subscribers receive identical alerts simultaneously. Trade responsibly.

Authentication

Pass your API key as an X-API-Key header on every request. Query-string keys (?api_key=) are accepted only on the CSV format for browser-download convenience — JSON requests reject them so plaintext keys never end up in shared access logs.

An unrecognized key silently falls back to free-tier IP limits — a typo never breaks a CSV download of public data, but you pay the lower quota. Manage keys at /account/keys.

Tiers & rate limits

Tier	Price	Public API limit	Attribution	Origin allowlist
Free	$0	60 req/hr per IP	Required	Unlimited
Pro	$14.99/mo	5,000 req/hr per key	Required on embeds	1 primary
Enterprise	$499/mo	100,000 req/hr per key	Not required	Up to 10

Embed limits are separate and higher: free 600/hr per IP + 10k/hr per origin, Pro 50,000/hr per key, Enterprise 500,000/hr per key with a 5M-renders/mo fair-use cap reviewed monthly.

JavaScript example

async function getRecessionOdds() {
  const res = await fetch('https://predictionmarketspicks.com/api/public/recession-tracker', {
    headers: { 'X-API-Key': process.env.PMP_API_KEY },
    next: { revalidate: 60 }, // cache server-side for 60s
  })
  if (!res.ok) throw new Error(`PMP ${res.status}`)
  return res.json()
}

Origin allowlisting (Enterprise)

Lock an Enterprise key to specific hostnames so a leaked key from one site can't be replayed from another. Add up to 10 hostnames in /account/keys; requests from any other origin get a 403. An empty allowlist disables enforcement.

Enforcement key on the embed route: WIDGET_V2_ENFORCE_ORIGINS=1 (operator-controlled). Default-off for 48h post-launch so a misconfigured key never black-holes a customer.

Error codes

Status	Meaning	What to do
400	Malformed request — bad slug, query param on JSON path, or invalid origin	Fix the request shape; see the endpoint reference
401	Not used on the public API (free tier never rejects on auth)	N/A
403	Origin allowlist mismatch on an Enterprise key with origins set	Add the origin in /account/keys or remove the allowlist
404	Unknown slug	Check /widgets for the live catalog of supported slugs
429	Rate limit exceeded	Back off until Retry-After; increase cache TTL; upgrade tier
500	Server error — payload lookup failed	Retry with exponential backoff; check status if persistent

Available slugs

Every widget on /widgets is also an API slug.

recession-tracker
US Recession Probability Gauge
sp500-forecast
S&P 500 Year-End Forecast
fed-rate-tracker
FOMC Rate Decision Tracker
inflation-tracker
CPI Inflation Probability Tracker
macro-pulse
Macro Pulse — US Economic Health Score
economic-calendar
US Economic Calendar — Macro Events with Market Consensus
shutdown-tracker
Government Shutdown Probability Tracker
oracle-unpriced
Oracle Unpriced — Markets the News Hasn’t Caught
election-2028
2028 Presidential Election Tracker
midterms-2026
2026 Midterms Tracker
midterms-race
Tightest 2026 Senate Race — Live Odds
midterms-balance-of-power
Balance of Power 2026 — Congress Control Odds
tail-edge
Live Longshot Scanner
nfl-edges
NFL Edges — Rotating Model vs Kalshi
nfl-week-1
NFL Week 1 Edge — Model vs Kalshi
nfl-this-week
NFL This Week: Model vs Market Edge
nfl-power-rankings
NFL Power Rankings — PMP Model
nfl-model-line
NFL Model Line vs Market — PMP Model
nfl-edge-board
Where the NFL Model Disagrees — PMP vs Market
nfl-game
NFL Game Tile — Model vs Kalshi, per game
nfl-team-card
NFL Team Season Card — projected wins vs Kalshi
nfl-champion-odds
Super Bowl LXI — Champion Odds
epl-cross-venue
Premier League — Kalshi vs Polymarket US
sports-arb
Kalshi vs Polymarket — Live Sports Gaps
fight-edge
Fight Edge — MMA Tale of the Tape vs Market
fight-edge-ufc
Fight Edge (UFC) — Tale of the Tape vs the Market

FAQ

Which prediction markets are covered?

Kalshi is the primary source across most widgets (recession, Fed rates, inflation, S&P 500, elections, government shutdown). Polymarket provides secondary signal where Kalshi liquidity is thin. World Cup data combines Kalshi outright markets with The 7 Oracles' Monte Carlo simulation.

How do I get an API key?

Subscribe to Pro ($14.99/mo) or Enterprise ($499/mo). Two keys (Primary + Backup) are provisioned automatically and emailed at checkout. Manage them at /account/keys.

What's the difference between Pro and Enterprise?

Pro lifts you off the free tier (50,000/hr on embeds, 5,000/hr on the JSON+CSV API) but the "Powered by The 7 Oracles" attribution bar stays. Enterprise removes attribution, raises the public-API limit to 100,000/hr, and adds origin allowlisting + priority support.

How often is the data updated?

Most widget payloads refresh every 5 minutes. Macro feeds (Fed, inflation) update at FOMC and BLS release windows. World Cup match data refreshes hourly outside game days, every 5 minutes during the tournament.

Can I cache API responses on my side?

Yes — and you should. Responses include public Cache-Control: s-maxage=60. Caching for at least 60 seconds eliminates 90%+ of redundant requests against your quota.

What happens when I hit the rate limit?

A 429 response with X-RateLimit-Limit, X-RateLimit-Remaining, and a Retry-After header. The current window resets per the sliding-window algorithm — back off until the Retry-After deadline passes.

Can I redistribute the data?

Aggregate display (charts, tables, dashboards) is permitted on all tiers. Mass re-syndication (selling the raw feed to third parties) requires a separate agreement — email predictionmarketspicks@gmail.com.

Ready to build?

Free tier needs no signup. Upgrade when you need per-key limits.

See plans Manage your keys Email support