---
title: "Current state for N markets in one call"
method: GET
path: "/market/batch"
tags: ["Markets"]
---

# Current state for N markets in one call

`GET /market/batch`

## Request

- Base URL: `https://foresea.ink` (the document declares no server; this is the origin it was published from)
- URL: `https://foresea.ink/market/batch`
- Auth: none declared

Fetch current price/volume for up to 50 markets in one call, so a watchlist
check doesn't need N sequential tool calls. Every quote carries `fetched_at`
and `age_seconds` -- the freshness signal to make your own trust call on,
since both venues rate-limit hard and a quote can otherwise look fresh when
it isn't. One bad ref returns an error on that entry only; the rest of the
batch still succeeds.

## Query parameters

- `refs` string[], required: Repeat this param per market: "platform:ident" or "platform:ident:extra" (extra = Kalshi series_ticker or Polymarket CLOB token_id, adds order book + candles). Up to 50 refs.

## Response `200`

Successful Response

- BatchQuoteResponse
  - `quotes` BatchQuoteItem[], required
    - `platform` string, required
    - `ident` string, required
    - `question` string, nullable
    - `probability` number, nullable
    - `market_url` string, nullable
    - `volume` number, nullable
    - `close_time` string, nullable
    - `order_book` object, nullable: Present only when the ref included its extra id (Kalshi series_ticker / Polymarket token_id).
    - `candles` object[], nullable: Present only when the ref included its extra id.
    - `fetched_at` string, nullable: ISO 8601 UTC time the price/volume fields were fetched.
    - `age_seconds` number, nullable: How old fetched_at is, in seconds -- the trust signal.
    - `error` string, nullable: Set (with other fields empty) when this one ref failed.
  - `count` integer, required
  - `truncated` boolean: True if more than _MAX_BATCH_REFS refs were requested; the extras were dropped, not silently merged.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/foresea/apis/foresea-intelligence-api.md) · [All operations](https://skmtc.dev/foresea/apis/foresea-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/foresea/apis/foresea-intelligence-api/revisions/b03e49f4385d?raw)