Skip to main content
GET
/
v1
/
markets
/
match
Match Market
curl --request GET \
  --url https://api.rivermarkets.com/v1/markets/match \
  --header 'x-api-key: <api-key>'
{
  "river_id": 123,
  "exchange_value": 123,
  "exchange_name": "<string>",
  "tick_size_price": 123,
  "tick_size_qty": 123,
  "minimum_order_size": 123,
  "neg_risk": true,
  "name": "<string>",
  "status": "active",
  "ticker": "<string>",
  "token_id_yes": "<string>",
  "token_id_no": "<string>",
  "slug": "<string>",
  "expiration_datetime": "2023-11-07T05:31:56Z",
  "neg_risk_id": "<string>",
  "condition_id": "<string>",
  "description": "<string>",
  "category": "Other",
  "rank": 123
}

Authorizations

x-api-key
string
header
required

API key for programmatic access. Generate one at app.rivermarkets.com under Settings → API Keys.

Query Parameters

ticker
string | null

Exact Kalshi ticker (e.g. KXNBA-26-DET)

slug
string | null

Exact Polymarket slug (e.g. will-the-denver-nuggets-win-the-2026-nba-finals)

Response

Successful Response

Schema for a single market search result.

river_id
integer
required
exchange_value
integer
required
exchange_name
string
required
tick_size_price
number
required
tick_size_qty
number
required
minimum_order_size
number
required
neg_risk
boolean
required
name
string
required
status
enum<string>
required

Instrument status derived in mv_instruments from exchange-specific fields.

Kalshi: maps from kalshi_markets.status - 'active' -> ACTIVE - everything else (closed, determined, finalized, settled, amended, inactive, initialized) -> CLOSED

Polymarket: maps from polymarket_markets.closed and polymarket_markets.active booleans - closed=true -> CLOSED - active=true (and not closed) -> ACTIVE - else (active=false, closed=false) -> INACTIVE

Available options:
active,
closed,
inactive
ticker
string | null
token_id_yes
string | null
token_id_no
string | null
slug
string | null
expiration_datetime
string<date-time> | null

Market expiration datetime (UTC)

neg_risk_id
string | null
condition_id
string | null
description
string | null
category
string
default:Other
rank
number | null