---
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)

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.net/rivermarkets/apis/river-finance-api.md) · [All operations](https://skmtc.net/rivermarkets/apis/river-finance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rivermarkets/river-finance-api/revisions/0f4eceac44fb/schema)