Skip to main content
GET /api/v1/price Returns normalized OHLCV candles for a market. Use it for recent price series, explicit historical windows, or a point-in-time lookup.
If you do not know the market identifiers yet, start with /markets. This endpoint accepts either parsec_id or exchange + market_id.

​
Error Semantics

  • 403 means your API key is not authorized for the request.
  • 503 means the upstream exchange is temporarily unavailable.

​
Parameters

​
parsec_id
string
Canonical selector. Provide either parsec_id or both exchange + market_id.
​
exchange
string
Exchange selector used with market_id.
​
market_id
string
Exchange-native market ID used with exchange.
​
outcome
string
default:"yes"
Outcome selector. For binary markets this is usually yes or no.
​
interval
string
default:"1h"
Candle interval. Supported values: 1m, 1h, 6h, 1d, 1w, max.
​
start_ts
number
Unix seconds start timestamp. Cannot be combined with at_ts.
​
end_ts
number
Unix seconds end timestamp. Cannot be combined with at_ts.
​
at_ts
number
Point-in-time lookup in Unix seconds. Cannot be combined with start_ts or end_ts.

​
Response

​
(root)
object

​
Examples

​
Default candle series

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parsecapi.com/api/v1/price?parsec_id=kalshi:KXPRESNOMD-28-JOSS&interval=1h"

{
  "parsec_id": "kalshi:KXPRESNOMD-28-JOSS",
  "exchange": "kalshi",
  "outcome": "Yes",
  "interval": "1h",
  "candles": [
    {
      "timestamp": "2026-03-10T18:00:00Z",
      "open": 0.51,
      "high": 0.54,
      "low": 0.49,
      "close": 0.52,
      "volume": 1234.0
    }
  ]
}

​
Explicit historical range

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parsecapi.com/api/v1/price?parsec_id=kalshi:KXPRESNOMD-28-JOSS&interval=1d&start_ts=1771113600&end_ts=1771718400"

​
Point-in-time lookup

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parsecapi.com/api/v1/price?parsec_id=kalshi:KXPRESNOMD-28-JOSS&interval=1h&at_ts=1771416000"