REST API - PolyNode

REST endpoints for crypto prediction market data. All endpoints require an API key.

Authentication

Pass your API key via query parameter or header:

# Query parameter
curl "https://api.polynode.dev/v1/crypto/markets?key=YOUR_API_KEY"

# Header
curl -H "x-api-key: YOUR_API_KEY" "https://api.polynode.dev/v1/crypto/markets"

GET /v1/crypto/markets

All crypto prediction markets with liquidity, volume, and open interest. Cache: 3 minutes

curl "https://api.polynode.dev/v1/crypto/markets?key=YOUR_API_KEY"

Show Response

{
  "events": [
    {
      "id": "238474",
      "slug": "what-price-will-bitcoin-hit-in-march-2026",
      "title": "What price will Bitcoin hit in March?",
      "startDate": "2026-03-01T05:20:27.791222Z",
      "endDate": "2026-04-01T04:00:00Z",
      "active": true,
      "volume": 88886711.74,
      "volume24hr": 5733750.73,
      "liquidity": 6074250.39,
      "openInterest": 12827944.10,
      "seriesSlug": "bitcoin-hit-price-monthly",
      "markets": [
        {
          "id": "1629442",
          "question": "$100,000?",
          "conditionId": "0x...",
          "outcomes": ["Yes", "No"],
          "outcomePrices": [0.045, 0.955],
          "volume": 24084104.74,
          "liquidity": 2028310.67,
          "active": true,
          "closed": false,
          "groupItemTitle": "↑ 150,000"
        }
      ]
    }
  ]
}

GET /v1/crypto/candles

5-minute OHLC candles from PolyNode’s live Chainlink tick archive. Returns ~2.5 hours of history (30 candles). Cache: ~5 seconds

Parameter	Required	Description
`symbol`	Yes	Asset symbol or feed name: `BTC`, `ETH`, `SOL`, `BNB`, `XRP`, `DOGE`, `HYPE`, or names like `BTC/USD`

curl "https://api.polynode.dev/v1/crypto/candles?symbol=BTC&key=YOUR_API_KEY"

REST candle symbols accept both bare asset symbols like BTC and feed names like BTC/USD. WebSocket Chainlink subscriptions use feed names such as BTC/USD.

Show Response

{
  "candles": [
    {
      "time": 1774665300,
      "open": 65954.03,
      "high": 65992.01,
      "low": 65947.14,
      "close": 65949.69
    }
  ]
}

GET /v1/crypto/ticks

Historical 1-second ticks for the same crypto feeds available on the price_feed WebSocket stream. Use this to backfill a chart window before switching to live WebSocket updates. Range: up to 24 hours per request

Parameter	Required	Description
`symbol`	Yes	Asset symbol: `BTC`, `ETH`, `SOL`, `BNB`, `XRP`, `DOGE`, `HYPE`
`from`	Yes	Start of range as Unix milliseconds
`to`	Yes	End of range as Unix milliseconds
`limit`	No	Max ticks to return. Default 10000, max 100000

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.polynode.dev/v1/crypto/ticks?symbol=BTC&from=1780458961000&to=1780459082000&limit=5"

Show Response

{
  "symbol": "BTC",
  "feed": "BTC/USD",
  "from": 1780458961000,
  "to": 1780459082000,
  "limit": 5,
  "count": 5,
  "truncated": true,
  "ticks": [
    {
      "id": "1780458962000-0",
      "type": "price_feed",
      "feed": "BTC/USD",
      "timestamp": 1780458962,
      "timestamp_ms": 1780458962000,
      "data": {
        "feed": "BTC/USD",
        "price": 65869.02124677686,
        "bid": 65865.65936734258,
        "ask": 65870.4120597498,
        "timestamp": 1780458962
      }
    }
  ]
}

If truncated is true, request a narrower range or increase limit.

GET /v1/crypto/price

Open and close price for a specific crypto market window. Use this to get the “price to beat” for a short-form market. Cache: 10 seconds

Parameter	Required	Description
`symbol`	Yes	Asset symbol: `BTC`, `ETH`, `SOL`, `BNB`, `XRP`, `DOGE`, `HYPE`
`window`	Yes	Unix epoch timestamp of the market window start
`interval`	No	Market interval variant (e.g. `5m`, `15m`, `1h`, `4h`)

curl "https://api.polynode.dev/v1/crypto/price?symbol=BTC&window=1774674000&key=YOUR_API_KEY"

Show Response

{
  "openPrice": 66285.01,
  "closePrice": 66238.61,
  "timestamp": 1774674466843,
  "completed": false,
  "incomplete": true,
  "cached": false
}

The openPrice is the oracle price at market open. closePrice updates in real time until the window completes. completed: true means the market has resolved.

GET /v1/crypto/active

Currently active 5-minute up-or-down markets for all 7 coins. Returns live market data with token IDs, outcomes, and current odds. Cache: 30 seconds

curl "https://api.polynode.dev/v1/crypto/active?key=YOUR_API_KEY"

Show Response

{
  "markets": [
    {
      "id": "312746",
      "slug": "btc-updown-5m-1774674300",
      "title": "Bitcoin Up or Down - March 28, 1:05AM-1:10AM ET",
      "active": true,
      "closed": false,
      "startDate": "2026-03-27T05:16:04.211285Z",
      "endDate": "2026-03-28T05:10:00Z",
      "markets": [
        {
          "question": "Bitcoin Up or Down - March 28, 1:05AM-1:10AM ET",
          "conditionId": "0x...",
          "outcomes": "[\"Up\", \"Down\"]",
          "outcomePrices": [0.465, 0.535],
          "tokenId": "12345...",
          "active": true,
          "closed": false
        }
      ]
    }
  ],
  "count": 7,
  "windowStart": 1774674300
}

The windowStart field is the epoch timestamp of the current 5-minute window. New markets rotate every 5 minutes.

Slug pattern is deterministic: {coin}-updown-5m-{windowStart}. You can compute the current window yourself with Math.floor(Date.now() / 1000 / 300) * 300. The SDK’s shortForm() method handles this automatically with auto-rotation, enriched market data, and settlement streaming. See Short-Form Markets for the interactive slug calculator and full reference.

GET /v1/crypto/series

Recurring crypto market series (5m, 15m, 1h, 4h, daily, weekly, monthly patterns). Cache: 5 minutes

curl "https://api.polynode.dev/v1/crypto/series?key=YOUR_API_KEY"

Show Response

{
  "series": [
    {
      "id": "10422",
      "slug": "xrp-up-or-down-15m",
      "title": "XRP Up or Down 15m",
      "recurrence": "15m",
      "active": true,
      "eventCount": null
    },
    {
      "id": "10065",
      "slug": "ethereum-neg-risk-weekly",
      "title": "Ethereum Neg Risk Weekly",
      "recurrence": "weekly",
      "active": true,
      "eventCount": null
    }
  ],
  "count": 7
}

​Authentication

​GET /v1/crypto/markets

​GET /v1/crypto/candles

​GET /v1/crypto/ticks

​GET /v1/crypto/price

​GET /v1/crypto/active

​GET /v1/crypto/series

Authentication

GET /v1/crypto/markets

GET /v1/crypto/candles

GET /v1/crypto/ticks

GET /v1/crypto/price

GET /v1/crypto/active

GET /v1/crypto/series