---
title: "Match Markets Batch"
method: POST
path: "/v1/markets/match/batch"
tags: ["markets"]
---

# Match Markets Batch

`POST /v1/markets/match/batch`

## Request

- Base URL: `https://api.rivermarkets.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rivermarkets.com/v1/markets/match/batch`
- Auth: none declared

Batch-resolve many markets by exact Kalshi ticker and/or Polymarket slug in one request.

The single-market ``/match`` endpoint costs one round-trip per identifier, so resolving
thousands of mappings serially is slow. This endpoint takes lists of tickers and/or slugs
(send them together in one call) and returns a full market row — including ``river_id``,
``ticker``, ``slug`` and ``exchange_name`` — for every identifier that matched. Identifiers
with no match come back in ``unmatched_tickers`` / ``unmatched_slugs``.

## Request body

- MarketMatchBatchRequest: 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 `200`

Successful Response

- MarketMatchBatchResponse: 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[], required
    - `river_id` integer, required
    - `exchange_value` integer, required
    - `exchange_name` string, required
    - `ticker` string, nullable
    - `token_id_yes` string, nullable
    - `token_id_no` string, nullable
    - `slug` string, nullable
    - `tick_size_price` number, required
    - `tick_size_qty` number, required
    - `tick_structure` string
    - `minimum_order_size` number, required
    - `expiration_datetime` string, nullable: Market expiration datetime (UTC)
    - `start_datetime` string, nullable: Game/event start datetime (UTC). Populated for sports; null otherwise.
    - `open_datetime` string, nullable: When the exchange opened the market for trading (UTC).
    - `neg_risk` boolean, required
    - `neg_risk_id` string, nullable
    - `condition_id` string, nullable
    - `name` string, required
    - `subtitle` string, nullable
    - `description` string, nullable
    - `status` 'active' | 'closed' | 'inactive', required: Instrument status derived in instruments table 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
    - `category` string
    - `subcategory` string, nullable
    - `rank` number, nullable
    - `event_ticker` string, nullable
    - `event_title` string, nullable
    - `event_subtitle` string, nullable
    - `is_combo` boolean: True for parlays.
    - `flip` boolean, nullable: Generic-asset members only: true when this member's YES side is the opposite of the asset's outcome. NULL outside basket-member contexts.
    - `volume` integer, nullable
    - `volume_24h` integer, nullable
    - `series_ticker` string, nullable
    - `image` string, nullable
    - `last_price` number, nullable: Most recent YES price normalized to 0.0–1.0 (probability). Kalshi cents / 100; Polymarket already 0.0–1.0. NULL when no trade has been observed.
    - `primary_entity_name` string, nullable: Resolved display name of the canonical structured-target entity (player, team, competitor, …) referenced by the market. NULL for markets without a structured target. Kalshi only — Polymarket has no equivalent concept.
    - `event_market_count` integer, nullable: Total number of markets in this row's event. Only populated on the event-paginated path; when markets_per_event trims an event, this is how clients know more markets exist than were returned.
  - `unmatched_tickers` string[]
  - `unmatched_slugs` string[]

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `3732aea08430`: 1 info
  - added the optional property `results/items/open_datetime` to the response with the `200` status
- **2026-09-24** `5e27be09032e`: 1 info
  - added the optional property `results/items/event_subtitle` to the response with the `200` status
- **2026-08-28** `c3a987e5f6ab`: 1 info
  - added the optional property `results/items/flip` to the response with the `200` status
- **2026-08-05** `0f4eceac44fb`: 1 info
  - added the optional property `results/items/event_market_count` to the response with the `200` status

[Operation history](https://skmtc.dev/rivermarkets/apis/river-finance-api/changes/v1/markets/match/batch/post.md)

---

[API](https://skmtc.dev/rivermarkets/apis/river-finance-api.md) - [All operations](https://skmtc.dev/rivermarkets/apis/river-finance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rivermarkets/apis/river-finance-api/revisions/3732aea08430?raw)