Active Market IDs

FinFeedAPI provides a standardized API for discovering active prediction market identifiers across supported exchanges.

Retrieve the current set of active market_id values before requesting market activity, OHLCV data, order books, or other market-level datasets. The Active Market IDs endpoint is optimized for lightweight market discovery by returning only canonical market identifiers rather than complete market metadata. Active market discovery is available through REST, MCP, and JSON-RPC.

Start with Free Credits Read the Documentation

What Are Active Market IDs?

Active Market IDs are the canonical identifiers of prediction markets that currently have recent quotes or transactions on a supported exchange.

Unlike full market listings, which return descriptive metadata such as titles, descriptions, prices, and statuses, the Active Market IDs endpoint returns only market identifiers. This provides an efficient way to discover markets that are currently active while minimizing response size.

Applications commonly use these identifiers as the first step in downstream workflows. After selecting a market, developers can retrieve market activity, historical data, OHLCV candles, or order book information using the returned market_id.

FinFeedAPI standardizes active market discovery across supported prediction market exchanges through a consistent API and identifier model.

Why Use Active Market IDs?

Many applications need to discover currently active markets without downloading complete market metadata.

Returning only identifiers significantly reduces payload size, making Active Market IDs suitable for synchronization jobs, monitoring systems, automated discovery workflows, and applications that already maintain local market metadata.

Developers commonly use Active Market IDs to:

discover currently active prediction markets
synchronize active market coverage
build market monitoring pipelines
identify markets with recent activity

When descriptive metadata is required, applications can retrieve complete market objects using the Market Listings endpoint.

What's Included in Active Market IDs?

The Active Market IDs endpoint intentionally returns a compact response containing only prediction market identifiers.

Field	Description
market_id	Canonical identifier of an active prediction market outcome.

Related Endpoints

Active Market IDs are one component of the FinFeedAPI Prediction Markets API. After discovering active markets, applications can continue integrating additional prediction market datasets.

Prediction Market Exchanges
Market Listings
Market Activity
Order Book Data
OHLCV Data

Together, these APIs provide a complete workflow that begins with exchange discovery, continues through active market discovery, and extends into latest and historical market data.

Available REST Endpoint

The Prediction Markets API provides a lightweight endpoint for discovering currently active market identifiers on a selected exchange, without returning complete market objects.

List Active Market IDs

Returns active prediction market identifiers for a selected exchange. This endpoint returns only market identifiers rather than complete market objects. Results support pagination through the limit and page parameters, allowing applications to synchronize active markets efficiently.

Response includes

active market_id values

How Active Market IDs Fit Into the FinFeedAPI Ecosystem

Active market discovery follows exchange discovery and precedes market-level data retrieval. Applications first identify a supported exchange, retrieve active market identifiers, and then use those identifiers to request market activity, OHLCV timeseries, order book snapshots, or other datasets.

Typical integration workflow

1Retrieve supported exchanges
2Select a prediction market exchange
3Retrieve active market IDs
4Select a market_id
5Retrieve market activity, OHLCV, or order book data

Applications that require descriptive market metadata can use the Market Listings endpoint before or after active market discovery.

Example API Request

Retrieve active prediction market identifiers for a supported exchange.

bash

curl -X GET \
  "https://api.prediction-markets.finfeedapi.com/v1/markets/POLYMARKET/active" \
  -H "Authorization: YOUR_API_KEY"

json

[
  "WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_YES",
  "WILL-TRUMP-SELL-10K-25K-GOLD-CARDS-IN-2025_NO",
  "NFL-PIT-CAR-2025-08-21-SPREAD-AWAY-5PT5_YES",
  "NFL-PIT-CAR-2025-08-21-SPREAD-AWAY-5PT5_NO",
  "CRYPTO-BTC-PRICE-ABOVE-100K-BY-EOY-2025_YES"
]

The response provides canonical market identifiers that can be used directly with market activity, OHLCV, and order book endpoints.

REST, MCP, and JSON-RPC Access

Active market discovery is available through every FinFeedAPI interface. Regardless of the interface, applications receive the same canonical market identifiers.

MCP Server

The hosted Prediction Markets MCP server exposes active market discovery through the markets_get_active tool, using the X-APIKey header. Developers can enumerate active prediction markets without implementing custom API 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 active market identifiers through the production proxy at https://api.prediction-markets.finfeedapi.com/jsonrpc.

JSON-RPC acts as a thin transport wrapper over the REST API. Set method to v1/markets/{exchange_id}/active and pass parameters through params. Authentication, identifiers, and response structure stay identical to REST.

Common Integration Patterns

Active Market IDs are commonly used as a lightweight discovery layer before retrieving richer prediction market datasets.

Workflow	How Active Market IDs are used
Market Discovery	Discover currently active prediction markets without downloading complete market objects.
Monitoring Systems	Refresh the list of active markets before polling activity or order book endpoints.
Synchronization Jobs	Keep local market catalogs synchronized with active markets available on each exchange.
Pipeline Initialization	Retrieve valid market_id values before collecting trades, quotes, or candles.
Agent Workflows	Enumerate active markets through MCP before requesting additional market information.
Market Analytics	Build dynamic workflows that focus on markets with recent activity.

Active Market IDs

Start Building with Active Market IDs

Discover active prediction markets through a lightweight, standardized API.

Retrieve canonical market identifiers, synchronize active market coverage, and use those identifiers as the starting point for integrating market activity, OHLCV, order books, and other prediction market datasets through REST, MCP, or JSON-RPC.