Prediction Markets API

Real-Time & Historical Prediction Market Data

Access standardized prediction market data from leading centralized and decentralized prediction market exchanges through one unified API. Retrieve markets, trades, quotes, order books, OHLCV candles, and historical datasets using consistent schemas designed for trading systems, analytics platforms, AI applications, and quantitative research.

The FinFeedAPI Prediction Markets API normalizes data across multiple prediction market venues, eliminating the need to integrate different APIs, naming conventions, market identifiers, and data formats.

Real-Time + HistoricalUnified Market Data
5+Prediction Market Exchanges
REST • JSON-RPC • MCPMultiple Interfaces
100kIndividual data points

What Data Will You Get?

Prediction Market Exchanges

Access supported prediction market exchanges. Get exchange identifiers, venue descriptions, and official website details.

Market Listings

Retrieve full market records by exchange, including market IDs, titles, descriptions, outcome names, prices, status, exchange IDs, and outcome types.

Active Market IDs

Get compact lists of currently active market IDs for each exchange. This is useful when you need fast discovery before requesting full market details.

Latest Market Activity

Access the latest trade and latest quote for a specific market outcome. Use this data to monitor current price movement, bid/ask levels, and recent activity.

Recent Trades and Quotes

Retrieve recent batches of trades and quotes for a market. This helps analyze short-term activity, liquidity changes, and market movement.

Historical Trades and Quotes

Pull historical trade and quote data from flat files using a full-day date query or a bounded time range. Data is filtered by processing time and includes exchange event timing.

OHLCV Time Series

Retrieve open, high, low, close, volume, and trade count data for prediction markets. Historical OHLCV data is returned in ascending time order for backtesting and analysis.

Latest OHLCV Candles

Access the most recent OHLCV candles for a specific market and period. Supported periods range from seconds and minutes to hours, days, months, and years.

Order Book Data

Get current order book snapshots with bids and asks for a specific market outcome to analyze live liquidity, spreads, market depth, and top-of-book imbalance.

Historical Order Book Data

Retrieve raw historical limit order events (adds, updates, deletes) from flat files for custom order book reconstruction and market-replay analysis.

Global Coverage

Global Prediction Market Coverage

The Prediction Markets API brings together leading regulated, decentralized, and social prediction market exchanges through one standardized interface. Instead of integrating each venue separately, developers can discover markets, monitor liquidity, and retrieve historical data across multiple ecosystems using consistent identifiers, timestamps, and schemas.

Exchange TypeExamples
Regulated ExchangesKalshi, ForecastEx, Crypto.com, Gemini
Decentralized Prediction MarketsPolymarket, Myriad, Pascal
Social Prediction MarketsManifold
On-Chain Outcome MarketsHyperliquid Outcome Markets
Unique Capability

Built Around Markets, Not Prices

Most prediction market APIs expose prices. FinFeedAPI exposes the entire market. Each market can be explored from discovery to execution-quality analysis through a single API.

Developers can:

  • discover new markets automatically
  • retrieve complete market metadata
  • monitor trades and quotes
  • inspect live liquidity through order books
  • analyze historical market activity
  • build OHLCV time series
  • replay historical market behavior

Instead of stitching together multiple endpoints from different exchanges, every stage of the market lifecycle is available through one standardized data model.

AI Applications

Built for AI Applications with MCP

The Prediction Markets API is available through a hosted Model Context Protocol (MCP) server, allowing AI assistants and autonomous applications to discover exchanges, inspect markets, retrieve activity, analyze order books, and request historical data using self-describing tools. Rather than manually navigating API documentation, AI applications can identify available exchanges, enumerate active markets, retrieve market metadata, and query market activity through standardized MCP tools.

Prediction Markets MCP

json
{
  "mcpServers": {
    "FinFeedAPI-Prediction-Markets": {
      "url": "https://api.prediction-markets.finfeedapi.com/mcp",
      "headers": {
        "X-APIKey": "YOUR_API_KEY_HERE"
      }
    }
  }
}

The hosted MCP server currently provides tools for:

  • Exchange discovery (exchanges_list, exchanges_get)
  • Market discovery (markets_get_active, markets_get_history)
  • Live market activity (activity_get_current, activity_get_latest)
  • Historical trades and quotes (activity_get_trades_history, activity_get_quotes_history)
  • OHLCV time series (ohlcv_list_periods, ohlcv_get_latest_market, ohlcv_get_history_market, ohlcv_get_history_exchange)
  • Current order books (orderbook_get_current)
  • Historical order book updates (orderbook_get_history)

Compatible with Cursor, Claude Desktop, and other MCP-enabled AI applications.

Protocols & Interfaces

Multiple Access Interfaces

Choose the interface that best fits your application architecture. Every interface exposes the same standardized prediction market datasets, allowing teams to adopt the protocol that best matches their infrastructure.

InterfaceAuthentication HeaderBest For
REST APIAuthorization: YOUR_API_KEYTrading systems, dashboards, analytics, and production applications
JSON-RPC APIAuthorization: YOUR_API_KEYApplications that prefer RPC-style integrations while accessing the same datasets
Hosted MCP ServerX-APIKey: YOUR_API_KEYAI assistants, coding agents, research tools, and autonomous workflows
Platform Specifications

Engineering Standards

Built for production-grade prediction market applications:

Unified Data Model

Consistent schemas across supported exchanges.

Standardized Market Identifiers

Stable market IDs and outcome identifiers.

ISO 8601 UTC Timestamps

Consistent time handling across all endpoints.

Historical & Real-Time Data

Access live market state (snapshots, current quotes) and historical flat files.

Multiple Integration Options

REST, JSON-RPC, and MCP interfaces.

Secure Communication

Encrypted TLS/SSL endpoints with API key authentication.

Consistent Numeric Precision

Standardized decimal handling across market data (up to 19 digits with 9 decimal places).

Competitive Advantage

FinFeedAPI vs Direct Exchange Integrations

Prediction market exchanges continue to grow, but every venue exposes different APIs, market identifiers, response formats, and capabilities. Building direct integrations means maintaining separate implementations as exchanges evolve. FinFeedAPI provides one normalized interface across supported prediction market exchanges.

FeatureDirect Exchange APIsFinFeedAPI Prediction Markets API
Exchange IntegrationsOne exchange at a timeMultiple exchanges through one API
Market DiscoveryDifferent endpointsStandardized discovery workflow (/active & /history)
Trades & QuotesExchange-specific formatsUnified schemas
Order BooksDifferent implementationsLive snapshots & standardized historical event logs
OHLCV DataVaries by venueStandardized time series (seconds to years)
Historical DataDifferent retrieval methodsBounded S3 flat-file historical access
AI IntegrationTypically unavailableHosted MCP server (/mcp)
Engineering MaintenanceMultiple integrationsOne integration
Onboarding

Quickstart

Start retrieving prediction market data in minutes.

  1. 1Create a free FinFeedAPI account.
  2. 2Generate your API key.
  3. 3Discover supported exchanges.
  4. 4Browse available markets.
  5. 5Retrieve trades, quotes, order books, or OHLCV data.
  6. 6Expand to historical analysis or AI workflows through MCP.

The documentation includes implementation examples for REST, JSON-RPC, official SDKs (Python, Node.js, Go, C#, etc.), and MCP clients.

Example

Retrieve the latest market activity:

bash
curl -X GET \
  "https://api.prediction-markets.finfeedapi.com/v1/activity/POLYMARKET/WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_YES/current" \
  -H "Authorization: YOUR_API_KEY"

The response includes the latest trade together with the latest bid and ask for the selected prediction market.

The Challenge

Prediction Markets Are Fragmented

Prediction markets have expanded rapidly across regulated exchanges, decentralized protocols, and specialized event markets.

Each platform defines its own market identifiers, naming conventions, metadata, endpoints, and market structures. Even simple tasks like discovering active markets or retrieving historical trading activity require different implementations for every exchange.

One Consistent Platform

The Prediction Markets API removes this complexity by normalizing exchanges into one consistent platform.

Instead of maintaining multiple integrations, developers can access standardized market metadata, trades, quotes, order books, OHLCV data, and historical market activity through a single API designed specifically for prediction markets.

Use Cases

Common Applications

  • Prediction market analytics platforms
  • Trading dashboards
  • Quantitative research
  • AI-powered market research
  • Event probability monitoring
  • Liquidity analysis
  • Order book analytics
  • Historical market replay
  • Backtesting prediction market strategies
  • Academic and economic research

Start Building

Build applications on top of prediction markets instead of building infrastructure around them.

Access standardized prediction market data from multiple exchanges through one API designed for trading systems, analytics platforms, AI applications, and quantitative research. Retrieve live market activity, historical datasets, order books, OHLCV time series, and market metadata through a single, consistent integration.