Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hypernode-docs.polynode.dev/llms.txt

Use this file to discover all available pages before exploring further.

Returns time-series OHLCV bars for one side of a market, with volume in USDH and shares, trade count, VWAP, and implied probability close. Standard charting input.

​
Endpoint

GET /v1/markets/:id/candles

​
Query parameters

ParamTypeDefaultDescription
sideint0Side index — 0 (Yes) or 1 (No)
periodstring"1m"One of 1m, 5m, 15m, 1h, 4h, 1d
fromint—Lower bound bucket start, microseconds
toint—Upper bound, microseconds
limitint500Max bars (cap 5000)

​
Response

{
  "outcome_id": 0,
  "side_index": 0,
  "side_label": "Yes",
  "period": { "raw": "5m", "label": "5 minutes", "description": "...", "applies_to": "300" },
  "count": 3,
  "candles": [
    {
      "t": 1777745400000000,
      "iso": "2026-05-02T18:10:00+00:00",
      "o": "0.63354",
      "h": "0.63443",
      "l": "0.60329",
      "c": "0.60573",
      "v_shares": "10755.0",
      "v_usdh": "6711.991240",
      "trades": 150,
      "vwap": "0.62408100790330079033",
      "implied_prob_close": "0.60573"
    },
    {
      "t": 1777745100000000,
      "iso": "2026-05-02T18:05:00+00:00",
      "o": "0.64776",
      "h": "0.6504",
      "l": "0.62832",
      "c": "0.63653",
      "v_shares": "54215.0",
      "v_usdh": "34771.579480",
      "trades": 229,
      "vwap": "0.64136455741031079959",
      "implied_prob_close": "0.63653"
    }
  ]
}
FieldDescription
tBucket start timestamp in microseconds
isoBucket start as ISO 8601
o h l cOpen / high / low / close — first, max, min, last fill price in the bucket
v_sharesTotal share volume traded
v_usdhTotal USDH notional — SUM(px × sz)
tradesNumber of fills in the bucket
vwapVolume-weighted average price
implied_prob_closeSame as c — the probability the market assigned to this side at bucket close

​
Use cases

  • TradingView-style charts of implied probability over time.
  • Volatility backtests — feed o/h/l/c into standard OHLC indicators.
  • Resolution prep — chart the last hour before expiry to see how confident the market got.

​
Examples

# Last 24 5-minute bars for outcome 0 Yes side
curl -H "X-API-Key: hip4_live_..." \
  "https://hip4.polynode.dev/api/v1/markets/0/candles?period=5m&limit=24"

# 1-hour bars from a specific date
curl -H "X-API-Key: hip4_live_..." \
  "https://hip4.polynode.dev/api/v1/markets/0/candles?period=1h&from=1777680000000000"

​
Notes

  • Bars are returned newest-first.
  • A bar exists only if at least one fill occurred in the bucket.
  • For sides with no recent activity, the bar series will be sparse.