Prediction Market Trades and Quotes

Trades & Quotes Data

Prediction market trades and quotes represent the individual market events that drive price discovery and liquidity. Every executed trade records a transaction between market participants, while every quote reflects the current bid and ask prices available in the market.

FinFeedAPI provides standardized APIs for retrieving prediction market activity across supported exchanges. Applications can access the latest market state, inspect recent activity, or retrieve historical trades and quote updates using a consistent data model and market identifiers.

Start with Free CreditsRead the Documentation

What Are Prediction Market Trades & Quotes?

Prediction market activity consists of two complementary datasets.

Trades represent completed transactions between buyers and sellers. Each trade records the execution price, traded quantity, timestamp, selected market outcome, and transaction side.

Quotes represent the current bid and ask prices together with the available quoted volume. As market participants submit or cancel orders, quote updates provide a continuous view of market liquidity and pricing.

Together, trades and quotes describe how a prediction market evolves over time. Applications can use them to monitor live markets, reconstruct historical activity, measure liquidity, calculate custom indicators, or build quantitative and machine learning models. FinFeedAPI exposes these datasets through dedicated endpoints for current market activity, recent market activity, historical trades, and historical quotes.

Why Use Prediction Market Trades & Quotes?

Trade and quote data provides the foundation for analyzing prediction market behavior at every time horizon.

Developers use prediction market activity to:

  • Monitor live market conditions
  • Analyze executed transactions
  • Measure bid and ask spread dynamics
  • Track liquidity over time
  • Backtest quantitative trading strategies
  • Build historical research datasets
  • Train AI and machine learning models
  • Calculate proprietary market indicators

Because every endpoint uses the same exchange_id and market_id, applications can seamlessly move between current, recent, and historical market activity without changing their integration.

What's Included in Prediction Market Trades & Quotes?

The same trade and quote structures are used consistently across current, recent, and historical activity endpoints, allowing applications to process market activity using a unified data model.

Trade Data

FieldDescription
idTrade identifier.
market_idCanonical prediction market identifier.
priceExecuted trade price.
quantityExecuted quantity.
timestampTrade timestamp.
outcomeMarket outcome associated with the trade.
sideBuy or sell side of the transaction.

Quote Data

FieldDescription
entry_timeQuote entry timestamp.
recv_timeTimestamp when the quote was received.
bidCurrent bid price.
askCurrent ask price.
bid_volumeAvailable bid volume.
ask_volumeAvailable ask volume.

Available REST Endpoints

The Prediction Markets API exposes dedicated endpoints for the latest market state, recent activity batches, historical trades, and historical quotes. Every endpoint uses the same exchange_id and market_id identifiers.

Current Market Activity

Returns the latest trade and latest quote for a prediction market. This endpoint is designed for applications that need the latest available trade and quote without retrieving additional market history.

Response includes
  • latest trade
  • latest quote
  • trade price and quantity
  • trade timestamp
  • trade outcome and side
  • current bid and ask prices
  • current bid and ask volumes
Parameters:exchange_id • market_id

Latest Market Activity

Returns recent trades and recent quotes for a prediction market. This endpoint is useful when applications need more than the latest market state while avoiding retrieval of larger historical datasets.

Response includes
  • recent trades
  • recent quotes
  • trade prices and quantities
  • trade timestamps
  • trade outcomes and sides
  • bid and ask prices
  • quoted bid and ask volumes
Parameters:exchange_id • market_id

Historical Trades

Returns historical trade executions for a prediction market. Retrieves historical trade data from flat files stored in external storage. Historical trades can be requested for an entire day or for a custom time range, making the endpoint suitable for backtesting, quantitative research, market replay, and historical analytics.

Response includes
  • historical trades
  • trade identifiers
  • execution prices
  • traded quantities
  • trade timestamps
  • market outcomes
  • transaction sides
Parameters:exchange_id • market_id • date • time_start • time_end • limit

Historical Quotes

Returns historical bid and ask quote updates for a prediction market. Retrieves historical quote updates from flat files stored in external storage. Applications can request a complete trading day or a custom time range to analyze historical liquidity, bid-ask spreads, and quote dynamics.

Response includes
  • historical bid prices
  • historical ask prices
  • bid volumes
  • ask volumes
  • quote timestamps
Parameters:exchange_id • market_id • date • time_start • time_end • limit

Historical Data Retrieval

Historical trade and quote endpoints support two retrieval methods. Historical datasets are retrieved from flat files stored in external storage.

Retrieval methods

Retrieval MethodDescription
Daily RetrievalReturns all historical trades or quotes for a specified date.
Custom Time RangeReturns historical activity between time_start and time_end.

According to the API documentation, filtering is performed using time_coinapi, while each returned record also includes the original exchange timestamp (time_exchange) for reference.

Related Prediction Market APIs

Prediction Market Trades & Quotes work together with other FinFeedAPI datasets, including:

  • Prediction Market Exchanges
  • Market Listings
  • Active Market IDs
  • OHLCV Data
  • Order Book Data

Together, these APIs provide a complete workflow for discovering markets, monitoring live activity, and analyzing historical prediction market data.

How Trades & Quotes Fit Into the FinFeedAPI Ecosystem

Prediction market trades and quotes integrate with the rest of the FinFeedAPI ecosystem through a common market identifier model. Using consistent exchange_id and market_id values across all endpoints allows applications to move between live monitoring and historical analysis without additional mapping.

Typical integration workflow

  1. 1List supported exchanges
  2. 2Discover available markets
  3. 3Select exchange_id and market_id
  4. 4Retrieve current or recent market activity
  5. 5Load historical trades and quotes
  6. 6Combine with OHLCV and order book data

Example API Requests

Retrieve the latest market state:

bash
curl -X GET \
  "https://api.prediction-markets.finfeedapi.com/v1/activity/POLYMARKET/WILL-RAIN-YES/current" \
  -H "Authorization: YOUR_API_KEY"

Retrieve recent market activity:

bash
curl -X GET \
  "https://api.prediction-markets.finfeedapi.com/v1/activity/POLYMARKET/WILL-RAIN-YES/latest" \
  -H "Authorization: YOUR_API_KEY"

Retrieve historical trades:

bash
curl -X GET \
  "https://api.prediction-markets.finfeedapi.com/v1/activity/POLYMARKET/WILL-RAIN-YES/history/trades?date=2025-01-01" \
  -H "Authorization: YOUR_API_KEY"

Retrieve historical quotes:

bash
curl -X GET \
  "https://api.prediction-markets.finfeedapi.com/v1/activity/POLYMARKET/WILL-RAIN-YES/history/quotes?time_start=2025-01-01T00:00:00Z&time_end=2025-01-01T12:00:00Z" \
  -H "Authorization: YOUR_API_KEY"

REST, MCP & JSON-RPC

Prediction market trades and quotes are available through every FinFeedAPI interface. Regardless of the interface, applications use the same exchange and market identifiers.

MCP Server

The hosted Prediction Markets MCP server exposes dedicated tools for retrieving current activity, recent activity, historical trades, and historical quotes: activity_get_current, activity_get_latest, activity_get_trades_history, and activity_get_quotes_history. AI assistants and agent frameworks can access prediction market activity 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 trades and quotes through the production proxy at https://api.prediction-markets.finfeedapi.com/jsonrpc.

JSON-RPC provides access to the same functionality while preserving the request and response structure of the REST API. Set method to v1/activity/{exchange_id}/{market_id}/current, /latest, /history/trades, or /history/quotes, and pass parameters through params. Successful JSON-RPC requests return the underlying REST payload in the result field.

Common Integration Patterns

Prediction market trades and quotes support live monitoring, historical research, and model training from the same identifiers.

Use CaseHow Trades & Quotes Are Used
Trading ApplicationsMonitor the latest trades and bid/ask prices for active markets.
Market AnalyticsAnalyze transaction history and quote updates over time.
Liquidity ResearchStudy historical bid, ask, spread, and quoted volume dynamics.
BacktestingReplay historical market activity for strategy evaluation.
AI & Machine LearningBuild training datasets from historical trades and quote updates.
Market MonitoringTrack recent activity across prediction markets.
Prediction Market Trades and Quotes

Start Building with Prediction Market Trades & Quotes

Access prediction market trades and quote updates through a unified API.

Retrieve the latest market activity for live applications, analyze recent market events, or load historical trade and quote datasets for quantitative research, backtesting, and AI workflows using consistent market identifiers across the FinFeedAPI ecosystem.

Start with Free CreditsRead the Documentation