Skip to main content
POST
Match Markets Batch

Authorizations

X-River-Key-Id
string
header
required

UUID of your API key (from Settings → API Keys).

X-River-Timestamp
string
header
required

Current unix seconds. Must be within 30s of server time.

X-River-Signature
string
header
required

Base64 Ed25519 signature over the canonical request: METHOD\nPATH\nSORTED_QUERY\nTIMESTAMP\nSHA256(body) hex. See /api-reference/authentication for the full recipe.

Body

application/json

Batch exact-match request: resolve many Kalshi tickers / Polymarket slugs at once.

tickers
string[]

Exact Kalshi tickers to resolve (e.g. KXNBA-26-DET).

slugs
string[]

Exact Polymarket / Polymarket-US slugs to resolve (e.g. will-the-denver-nuggets-win-the-2026-nba-finals).

Response

Successful Response

Batch exact-match response.

results holds a full market row (with river_id, ticker, slug and exchange_name) for every identifier that matched. Identifiers with no match are echoed back in unmatched_tickers / unmatched_slugs so callers can tell the difference between "not found" and a lookup they forgot to send.

results
MarketSearchResult · object[]
required
unmatched_tickers
string[]
unmatched_slugs
string[]