Latest Prediction Market Activity

Latest Market Activity

FinFeedAPI provides a standardized API for retrieving recent trading activity from supported prediction market exchanges.

Access recent trades and quote updates for a selected market_id through one consistent response model. The endpoint returns batches of market events rather than only identifying which markets have activity, making it suitable for monitoring recent price changes, executed transactions, bid and ask updates, and available quoted volume.

What Is Latest Prediction Market Activity?

Latest prediction market activity is a recent batch of trades and quotes associated with a specific prediction market.

Trades describe executed transactions. Each trade includes the market identifier, execution price, quantity, timestamp, outcome, and trade side.

Quotes describe recent bid and ask updates. Each quote includes its entry and receipt timestamps, bid and ask prices, and the available volume associated with both sides.

Together, these records show what has recently happened inside a market rather than only indicating that the market has been active.

Why Use Latest Market Activity?

The Latest Market Activity endpoint returns a recent batch of market events for one prediction market. This makes it useful for examining short-term price movement, recent transaction flow, quote changes, and the sequence of market updates without retrieving flat-file history.

Developers commonly use latest market activity to:

  • inspect recent trades for a selected market
  • retrieve recent bid and ask updates
  • monitor short-term market activity
  • analyze recent transaction prices and quantities
  • compare recent executed trades with quoted prices
  • populate market activity feeds

What's Included in Latest Market Activity?

The response contains two collections: trades and quotes. These fields provide both executed transaction data and quoted market conditions in one response.

Trade Fields

FieldDescription
idIdentifier assigned to the trade.
market_idCanonical identifier of the prediction market outcome.
pricePrice at which the transaction occurred.
quantityQuantity executed in the transaction.
timestampTimestamp associated with the trade.
outcomeOutcome represented by the traded market.
sideTransaction side, such as Buy.

Quote Fields

FieldDescription
entry_timeTimestamp associated with the quote entry.
recv_timeTimestamp when the quote was received.
askCurrent ask price in the quote update.
bidCurrent bid price in the quote update.
ask_volumeQuoted volume available at the ask price.
bid_volumeQuoted volume available at the bid price.

Available REST Endpoint

The Prediction Markets API provides a market-scoped endpoint for retrieving a recent batch of trades and quotes for one exchange and one market_id.

Retrieve Latest Market Activity

Returns recent trades and recent quotes for a selected prediction market. The endpoint is scoped to one exchange and one market. It does not require date-range or pagination parameters in the documented interface.

Response includes
  • recent trade records
  • recent quote records
  • execution prices and quantities
  • trade timestamps
  • trade outcomes and sides
  • bid and ask prices
  • quoted bid and ask volumes
  • quote entry and receipt timestamps

How Latest Market Activity Compares

Active Market IDs and Current Market Activity serve different purposes from Latest Market Activity. Use discovery endpoints to find markets, Current Activity for the freshest signal, and Latest Activity for a recent batch of events.

Latest Market Activity vs. Active Market IDs

The Active Market IDs endpoint is a lightweight discovery endpoint. It does not return trade prices, quantities, timestamps, or quote values.

DatasetWhat it returnsPrimary purpose
Active Market IDsA list of market_id values derived from recent quotes and transactions.Discover which markets have recent activity.
Latest Market ActivityRecent trade and quote records for one selected market_id.Inspect what recently happened in that market.

The Latest Market Activity endpoint requires a specific exchange and market identifier and returns the underlying recent events for that market.

Latest Activity vs. Current Activity

The Prediction Markets API provides two endpoints for recent market state.

EndpointResponse
/currentThe single latest trade and the single latest quote for a market.
/latestA recent batch of trades and quotes for a market.

Use Current Market Activity when an application only needs the freshest available trade and quote. Use Latest Market Activity when an application needs multiple recent records to examine short-term market behavior or display a recent activity feed.

The MCP documentation similarly describes activity_get_current as the freshest market activity signal and activity_get_latest as the option for retrieving more than one trade and quote.

How Latest Market Activity Fits Into the FinFeedAPI Ecosystem

Latest Market Activity follows exchange and market discovery. Applications first retrieve a supported exchange, discover a valid market identifier, and then request recent activity for that market.

Typical integration workflow

  1. 1Retrieve supported exchanges
  2. 2Discover market listings or active market IDs
  3. 3Select an exchange_id and market_id
  4. 4Retrieve recent trades and quotes
  5. 5Build feeds, monitoring systems, or analytics

Applications that only need the single freshest event can use Current Market Activity. Applications requiring longer time ranges can continue into the historical trade and quote endpoints.

Example API Request

Retrieve recent trades and quotes for a selected prediction market.

bash
curl -X GET \
  "https://api.prediction-markets.finfeedapi.com/v1/activity/POLYMARKET/WILL-RAIN-YES/latest" \
  -H "Authorization: YOUR_API_KEY"
json
{
  "trades": [
    {
      "id": "string",
      "market_id": "WILL-RAIN-YES",
      "price": 0.1,
      "quantity": 0.1,
      "timestamp": "2019-08-24T14:15:22Z",
      "outcome": "Yes",
      "side": "Buy"
    }
  ],
  "quotes": [
    {
      "entry_time": "2019-08-24T14:15:22Z",
      "recv_time": "2019-08-24T14:15:22Z",
      "ask": 0.1,
      "bid": 0.1,
      "ask_volume": 0.1,
      "bid_volume": 0.1
    }
  ]
}

The response separates executed trades from quote updates while keeping both datasets associated with the selected market.

REST, MCP, and JSON-RPC Access

Latest Market Activity is 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 the endpoint through the activity_get_latest tool, using the X-APIKey header. The tool requires exchange_id and market_id. It is intended for workflows that need more than the single latest trade and quote but do not require historical flat-file retrieval.

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 market activity through the production proxy at https://api.prediction-markets.finfeedapi.com/jsonrpc.

JSON-RPC follows the same REST endpoint structure and exposes current, latest, and historical market activity methods through the proxy interface. Set method to v1/activity/{exchange_id}/{market_id}/latest and pass exchange_id and market_id through params. Successful JSON-RPC requests return the underlying REST payload in the result field.

Common Integration Patterns

Latest Market Activity is commonly used as a short-term event layer after market discovery and before historical retrieval.

WorkflowHow Latest Market Activity is used
Recent Activity FeedsDisplay recent trades and quote updates for a selected prediction market.
Price MonitoringTrack recent transaction prices together with changes in bid and ask quotes.
Short-Term AnalyticsExamine recent price, quantity, spread, and quoted-volume changes.
Market Detail PagesAdd a recent activity section to individual prediction market pages.
Agent WorkflowsAllow MCP-compatible agents to inspect recent market events without requesting flat-file history.
Historical Data RoutingUse recent activity first, then request historical trades or quotes when a longer analysis window is needed.
Latest Prediction Market Activity

Start Building with Latest Market Activity

Retrieve recent trades and quotes for prediction markets through one standardized API.

Use canonical exchange and market identifiers to inspect recent transactions, monitor quote changes, and connect short-term market activity with current state, order books, OHLCV, and historical datasets through REST, MCP, or JSON-RPC.