ForecastMind

ForecastMind API

Programmatic access to cross-venue prediction market data. Base URL: https://forecastmind.org/api/v1

Get a free API key

100 requests/day, no credit card required. Key is sent to your email and returned once.

Need more? See Pro and Business plans →

Authentication

Pass your key as a request header. Unauthenticated requests work for public endpoints but consume your daily quota.

X-API-Key: fm_your_key_here

Rate limits

TierDaily limitPer-minute limit
Free100 req/day10/min
Pro ($79/mo)1,000 req/day60/min
Business ($299/mo)Unlimited200/min
EnterpriseUnlimitedCustom

Quick start

Python

import requests

API_KEY = "fm_your_key_here"
BASE = "https://forecastmind.org/api/v1"

headers = {"X-API-Key": API_KEY}

# Get divergence alerts
alerts = requests.get(f"{BASE}/divergence", params={"threshold": 8}, headers=headers).json()
for alert in alerts[:5]:
    print(f"{alert['poly_question']}: Poly {alert['poly_yes_price']:.0%} vs {alert['venue']} {alert['other_yes_price']:.0%} (gap {alert['divergence_pct']:.1f}pp)")

curl

# Register for a free key
curl -X POST https://forecastmind.org/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com"}'

# Use your key
curl https://forecastmind.org/api/v1/divergence?threshold=8 \
  -H "X-API-Key: fm_your_key_here"

Endpoints

MethodPath
GET/api/v1/markets
GET/api/v1/markets/{id}
GET/api/v1/markets/{id}/stats
GET/api/v1/markets/{id}/history
GET/api/v1/markets/{id}/history/export.csvkey required
GET/api/v1/markets/{id}/probability
GET/api/v1/markets/{id}/signals
GET/api/v1/markets/{id}/canonical
GET/api/v1/divergence
GET/api/v1/divergence/{slug}
GET/api/v1/divergence/{slug}/history
GET/api/v1/canonical
GET/api/v1/canonical/{id}
GET/api/v1/trending
GET/api/v1/movers
GET/api/v1/closing-soon
GET/api/v1/consensus
GET/api/v1/wisdom
GET/api/v1/accuracy
GET/api/v1/resolutions
GET/api/v1/search
GET/api/v1/clusters
GET/api/v1/contradictions
GET/api/v1/daily
GET/api/v1/crypto
GET/api/v1/briefings/latest
GET/api/v1/news/impacts
POST/api/v1/auth/register
GET/api/v1/auth/mekey required
POST/api/v1/alerts/subscribe

Full OpenAPI spec: /api/v1/openapi.json