Market data

Use this guide when you need the underlying market data rather than a derived index or rate. Adjacent returns markets, events, trades, quotes, and candles from Kalshi and Polymarket in one schema.

Every market_id and event_id is globally unique and prefixed with its platform (kalshi: / polymarket:). That prefix lets you pass an id from a list response directly into a detail or history request.

Set ADJ_TOKEN to an API key before running these examples; see Authentication.

A simple market workflow

Start with a filtered market list when you know the venue or category but not the exact market id. Pick an id from the response, then request the market detail to confirm its question, status, and close date.

Once you have the right market, choose the history that matches your question:

Use prices to chart how the implied probability changed.
Use trades to inspect individual executions.
Use quotes to inspect the bid and ask at a point in time.
Use candles to work with open, high, low, and close values.

Find markets

Filter by platform, category, probability, or volume. Results are paginated, so you can browse a large catalog without loading it all at once.

1curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets?platform=kalshi&category=Politics&probability_min=50&sort_dir=desc&per_page=10"

The response includes a data array and a meta object. Save the market_id from the market you want to inspect.

Follow one market

Use the saved id to fetch the market record. Then choose the history endpoint that matches your question.

1234567MARKET_ID="kalshi:KXPRESPARTY-2028-R"

curl -H "Authorization: Bearer $ADJ_TOKEN" \
  "https://api.adjacent.markets/api/v1/markets/$MARKET_ID"

curl -H "Authorization: Bearer $ADJ_TOKEN" \
  "https://api.adjacent.markets/api/v1/markets/$MARKET_ID/prices?interval=1hour&per_page=24"

Use the market record for labels and status. Use price history for charts. Use trades and quotes when you need to explain a price change.

Read a market

Market prices use a 0-100 scale. A price of 75 means an implied probability of 75%.

1curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXPRESPARTY-2028-R"

Follow a market over time

Use price history to chart a market, trades to see executions, quotes to inspect the latest bid and ask, and candles to work with OHLC data.

1234567891011# Bucketed price history
curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXPRESPARTY-2028-R/prices?interval=1hour&per_page=24"

# Recent trades
curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXPRESPARTY-2028-R/trades?per_page=20"

# Raw top-of-book bid/ask snapshots
curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXPRESPARTY-2028-R/quotes?per_page=20"

# OHLC candles (interval is the period length in minutes)
curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXPRESPARTY-2028-R/candles?interval=60"

Find similar markets

Use this when you know one market but want related markets. Results are ranked by embedding cosine similarity. Pass platform to rank only that venue (kalshi, polymarket, gemini).

123curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXPRESPARTY-2028-R/similar?per_page=5&min_similarity=0.7"

curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/markets/kalshi:KXNFLWINS-27MIN-10/similar?platform=gemini&per_page=5"

Browse events

Events group markets that resolve together, such as the markets for an election. Use an event when you want the full set of related markets.

12345# List events in a category
curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/events?category=Politics&per_page=10"

# Event detail with its markets
curl -H "Authorization: Bearer $ADJ_TOKEN" "https://api.adjacent.markets/api/v1/events/kalshi:KXPRESPARTY-2028"

See the API reference for full schemas.