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

MCP Server Pro & Enterprise

Connect ForecastMind directly to Claude Desktop, Cursor, Windsurf, or any MCP-compatible AI client. Your AI model will have 12 live prediction market tools built in — search markets, fetch cross-venue gaps, get superforecaster consensus, and pull the daily research note without leaving your workflow.

The MCP server is available at https://api.forecastmind.org/mcp using the Streamable HTTP transport. Authenticate with your Pro or Enterprise API key.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "forecastmind": {
      "type": "http",
      "url": "https://api.forecastmind.org/mcp",
      "headers": {
        "Authorization": "Bearer fm_your_key_here"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP settings (.cursor/mcp.json or equivalent):

{
  "mcpServers": {
    "forecastmind": {
      "type": "http",
      "url": "https://api.forecastmind.org/mcp",
      "headers": {
        "Authorization": "Bearer fm_your_key_here"
      }
    }
  }
}

Available tools

Tool
search_markets(query, limit)
get_market(market_id)
list_markets(category, limit)
get_divergence(threshold, limit)
get_consensus(min_disagreement, limit)
get_wisdom(min_venues, limit)
get_trending(limit)
get_movers(limit)
get_breaking_news(limit, hours)
get_signals(limit, min_strength)
get_market_signals(market_id, question)
get_daily_briefing()

Need a Pro key? Email support@forecastmind.org or visit the pricing page.