Skip to main content
GET
/
v1
/
markets
/
fetch_market_lineage
Fetch market lineage
curl --request GET \
  --url https://github.com/openpx-trade/openpx/v1/markets/fetch_market_lineage
{
  "market": {
    "exchange": "<string>",
    "market_type": "binary",
    "openpx_id": "<string>",
    "status": "active",
    "ticker": "<string>",
    "title": "<string>",
    "volume": 123,
    "best_ask": 123,
    "best_bid": 123,
    "close_time": "2023-11-07T05:31:56Z",
    "condition_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "event_ticker": "<string>",
    "last_trade_price": 123,
    "min_order_size": 123,
    "neg_risk": true,
    "neg_risk_market_id": "<string>",
    "numeric_id": "<string>",
    "open_time": "2023-11-07T05:31:56Z",
    "outcomes": [],
    "result": "<string>",
    "rules": "<string>",
    "settlement_time": "2023-11-07T05:31:56Z",
    "tick_size": 123,
    "volume_24h": 123
  },
  "event": {
    "ticker": "<string>",
    "title": "<string>",
    "category": "<string>",
    "description": "<string>",
    "end_ts": "2023-11-07T05:31:56Z",
    "last_updated_ts": "2023-11-07T05:31:56Z",
    "market_tickers": [],
    "mutually_exclusive": true,
    "numeric_id": "<string>",
    "open_interest": 123,
    "series_ticker": "<string>",
    "start_ts": "2023-11-07T05:31:56Z",
    "status": "<string>",
    "volume": 123
  },
  "series": {
    "ticker": "<string>",
    "title": "<string>",
    "category": "<string>",
    "fee_type": "<string>",
    "frequency": "<string>",
    "last_updated_ts": "2023-11-07T05:31:56Z",
    "numeric_id": "<string>",
    "settlement_sources": [],
    "tags": [],
    "volume": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.openpx.trade/llms.txt

Use this file to discover all available pages before exploring further.

Fetch a market plus its parent event and series in one call. The event and series fields are Option — a dangling parent reference returns None rather than failing the whole call. market_ticker is the unified Market.ticker (Kalshi market ticker or Polymarket slug).

Query Parameters

​
market_ticker
string
required

Response

Success.

A market plus the parent event and series that contextualize it.

event and series are Option because: - some markets have no parent event surface (Kalshi standalone markets); - the upstream lookup for the parent may legitimately 404 on a dangling reference. A dangling parent should not fail the whole call — the caller still gets the Market.

​
market
object
required

Unified prediction market model.

All exchanges produce this single type directly — no intermediate conversion.

Price Format

All prices are normalized to decimal format (0.0 to 1.0). Exchange-specific conversions are handled during parsing:

  • Kalshi: Fixed-point dollar strings parsed directly (post March 2026 migration). - Polymarket: Native prices already in decimal (0.0-1.0).
​
event
object

A grouping of related markets. On Kalshi, an Event is a single resolution (e.g. "Will Candidate X win State Y?") with one or more contracts. On Polymarket, an Event is the parent of one or more Markets sharing a common theme (e.g. "2028 US Presidential Election" with markets per candidate).

​
series
object

A recurring family of events. Examples: a weekly inflation reading, a monthly nonfarm payrolls release, a regular sports season. On Kalshi, a Series is identified by series_ticker (e.g. KXPRES). On Polymarket, a Series wraps multiple Events with shared metadata.