---
title: "Get Prices"
method: GET
path: "/v1/prices/{river_id}"
tags: ["prices"]
---

# Get Prices

`GET /v1/prices/{river_id}`

Get price data for a market.
Returns either candlestick OHLC data or simple price history based on the `type` parameter.
The endpoint automatically determines the exchange and fetches data accordingly.

- **Kalshi**: Returns real OHLC candlestick data with volume
- **Polymarket**: Returns price history (candlesticks will have synthetic OHLC where all values equal the price)

Kalshi and Polymarket markets whose trade history River has fully captured are
served from River's own data (real OHLC for both); the rest come from the exchange
while a backfill of their history is queued.

All prices are normalized to 0-1 range.

## Path parameters

- `river_id` integer, required — River market ID

## Query parameters

- `type` 'candlesticks' | 'history' — Response type
- `interval` '1d' | '1w' | '1m' | 'max' — Time range
- `fidelity` integer — Minutes per data point (for Polymarket history)

## Response `200`

Successful Response

- PriceResponse — Response for price queries.
  - `river_id` integer, required
  - `exchange` string, required
  - `type` 'candlesticks' | 'history', required
  - `has_ohlc` boolean
  - `candlesticks` PriceCandlestick[], nullable
    - `timestamp` integer, required
    - `open` number, required
    - `high` number, required
    - `low` number, required
    - `close` number, required
    - `volume` integer, nullable
  - `history` PricePoint[], nullable
    - `timestamp` integer, required
    - `price` number, required

## Other responses

- `422` — Validation Error

---

[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/0f3134d38e5c?raw)