Prediction Markets OHLCV Data

OHLCV Time Series

OHLCV candles summarize prediction market activity over fixed time intervals by aggregating prices and traded volume into a single record. Instead of processing every individual trade, applications can use OHLCV data to analyze price movements, identify trends, visualize markets, and perform historical quantitative analysis.

FinFeedAPI provides standardized APIs for retrieving the latest OHLCV candles as well as historical OHLCV time series across supported prediction market exchanges. All candle data uses the same market identifiers and consistent response structure, making it easy to transition from live monitoring to long-term historical analysis.

Start with Free CreditsRead the Documentation

What Is Prediction Market OHLCV Data?

Prediction market OHLCV data aggregates individual trades into standardized time-based candles for a specific prediction market.

Each candle summarizes trading activity over a predefined interval by recording the opening price, highest traded price, lowest traded price, closing price, and total traded volume for that market. Instead of processing every individual transaction, applications can analyze the evolution of a prediction market through a compact time-series representation.

OHLCV candles are commonly used to visualize how market sentiment changes over time, compare historical price movements, identify trading patterns, and build quantitative models based on aggregated market data.

FinFeedAPI provides dedicated endpoints for retrieving both the latest OHLCV candles and historical OHLCV time series across supported prediction market exchanges.

Why Use Prediction Market OHLCV Data?

OHLCV candles provide an efficient way to analyze how prediction markets evolve over time without processing every individual trade.

Developers use prediction market OHLCV data to:

  • Build candlestick and OHLC charts for prediction markets
  • Analyze how market probabilities change over time
  • Compare historical price movements across markets
  • Study trading activity over different aggregation periods
  • Backtest quantitative models using standardized time-series data
  • Generate historical datasets for research and machine learning
  • Monitor multiple prediction markets through aggregated market data
  • Calculate custom indicators from historical price and volume data

Because every candle represents a fixed aggregation interval, OHLCV data provides a consistent foundation for charting, historical analysis, and quantitative research across supported prediction market exchanges.

What's Included in Prediction Market OHLCV Data?

Each OHLCV candle contains aggregated market statistics for a single time interval. The same OHLCV structure is used for both the latest candle endpoint and historical OHLCV time series, allowing applications to process latest and historical data using a consistent schema.

OHLCV candle fields

FieldDescription
time_period_startBeginning of the aggregation interval.
time_period_endEnd of the aggregation interval.
time_openTimestamp of the first trade included in the candle.
time_closeTimestamp of the last trade included in the candle.
price_openOpening price.
price_highHighest traded price.
price_lowLowest traded price.
price_closeClosing price.
volume_tradedTotal traded volume during the interval.

Available REST Endpoints

The Prediction Markets API exposes dedicated endpoints for the latest OHLCV candles and historical OHLCV time series. Every endpoint uses the same exchange_id, market_id, and period_id identifiers.

Latest OHLCV Candles

Returns the latest OHLCV candles for a prediction market. This endpoint is designed for applications that require the latest aggregated market data for charting, dashboards, and market monitoring.

Response includes
  • latest OHLCV candles
  • candle timestamps
  • open price
  • high price
  • low price
  • close price
  • traded volume
Parameters:exchange_id • market_id • period_id

Historical OHLCV Time Series

Returns historical OHLCV candles for a prediction market. Historical candles can be requested over custom time ranges, making the endpoint suitable for chart generation, historical research, quantitative analysis, and strategy backtesting.

Response includes
  • historical OHLCV candles
  • candle timestamps
  • open price
  • high price
  • low price
  • close price
  • traded volume
Parameters:exchange_id • market_id • period_id • time_start • time_end • limit

Supported OHLCV Time Periods

Historical and latest OHLCV endpoints support predefined aggregation periods. Each period_id determines how individual trades are grouped into OHLCV candles. Using standardized intervals allows applications to generate consistent charts, compare markets across identical timeframes, and build historical datasets using a uniform candle structure.

Available period identifiers

Applications specify the desired aggregation interval through the period_id parameter when requesting both the latest candles and historical OHLCV time series.

Time unitPeriod identifiers
Second1SEC, 2SEC, 3SEC, 4SEC, 5SEC, 6SEC, 10SEC, 15SEC, 20SEC, 30SEC
Minute1MIN, 2MIN, 3MIN, 4MIN, 5MIN, 6MIN, 10MIN, 15MIN, 20MIN, 30MIN
Hour1HRS, 2HRS, 3HRS, 4HRS, 6HRS, 8HRS, 12HRS
Day1DAY, 2DAY, 3DAY, 5DAY, 7DAY, 10DAY
Month1MTH, 2MTH, 3MTH, 4MTH, 6MTH
Year1YRS, 2YRS, 3YRS, 4YRS, 5YRS

Related Endpoints

OHLCV data integrates with other FinFeedAPI prediction market datasets, including:

  • Prediction Market Exchanges
  • Market Listings
  • Active Market IDs
  • Trades & Quotes
  • Order Book Data

Together, these APIs provide a complete workflow for discovering markets, monitoring live activity, analyzing historical price movements, and accessing raw market events.

How OHLCV Fits Into the FinFeedAPI Ecosystem

OHLCV data builds on individual trade activity by aggregating transactions into standardized time-series candles. Using consistent exchange_id, market_id, and period_id values across the API allows applications to combine aggregated market data with lower-level market activity when needed.

Typical integration workflow

  1. 1List supported exchanges
  2. 2Discover available markets
  3. 3Select exchange_id and market_id
  4. 4Retrieve latest OHLCV candles
  5. 5Load historical OHLCV time series
  6. 6Combine with trades, quotes, and order books

Example API Requests

Retrieve the latest OHLCV candles:

bash
curl -X GET \
  "https://api.prediction-markets.finfeedapi.com/v1/ohlcv/POLYMARKET/WILL-RAIN-YES/latest?period_id=1HRS" \
  -H "Authorization: YOUR_API_KEY"

Retrieve historical OHLCV time series:

bash
curl -X GET \
  "https://api.prediction-markets.finfeedapi.com/v1/ohlcv/POLYMARKET/WILL-RAIN-YES/history?period_id=1HRS&time_start=2025-01-01T00:00:00Z&time_end=2025-01-31T23:59:59Z" \
  -H "Authorization: YOUR_API_KEY"

Both endpoints use the same market identifiers and aggregation periods, making it straightforward to move between current market monitoring and historical analysis.

REST, MCP & JSON-RPC

Prediction market OHLCV data is available through every FinFeedAPI interface. Regardless of the interface, applications use the same exchange, market, and period identifiers.

MCP Server

The hosted Prediction Markets MCP server exposes dedicated tools for retrieving the latest OHLCV candles and historical OHLCV time series: ohlcv_list_periods, ohlcv_get_latest_market, and ohlcv_get_history_market. AI assistants and agent frameworks can access aggregated market data without implementing direct REST integrations.

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

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

JSON-RPC

Developers using JSON-RPC can access OHLCV data through the production proxy at https://api.prediction-markets.finfeedapi.com/jsonrpc.

JSON-RPC exposes the same OHLCV functionality while preserving the request and response model of the REST API. Set method to v1/ohlcv/{exchange_id}/{market_id}/latest or v1/ohlcv/{exchange_id}/{market_id}/history, and pass parameters through params. Successful JSON-RPC requests return the underlying REST payload in the result field.

Common Integration Patterns

Prediction market OHLCV data supports charting, monitoring, and quantitative research from the same candle schema.

Use CaseHow OHLCV Data Is Used
Financial ChartsDisplay candlestick and OHLC charts for prediction markets.
Market DashboardsMonitor aggregated price movements across markets.
Technical AnalysisCalculate indicators using standardized OHLCV candles.
Quantitative ResearchAnalyze historical price and volume trends.
BacktestingEvaluate trading strategies using historical OHLCV time series.
AI & Machine LearningBuild structured training datasets from aggregated market data.
Prediction Markets OHLCV Data

Start Building with Prediction Market OHLCV Data

Access the latest OHLCV candles and historical OHLCV time series through a unified API.

Build financial charts, monitor market trends, analyze historical price movements, and develop quantitative applications using standardized candle data across supported prediction market exchanges.

Start with Free CreditsRead the Documentation