Skip to main content

Documentation Index

Fetch the complete documentation index at: https://polynode.mintlify.app/llms.txt

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

Stream real-time crypto prices over WebSocket. 7 feeds, ~1 update per second each.

​
Connection

wss://ws.polynode.dev/ws?key=YOUR_API_KEY
This is the same WebSocket endpoint used for settlements and orderbook. If you already have a connection open, you don’t need a new one.

​
Available feeds

FeedPairUpdate rate
BTC/USDBitcoin / US Dollar~1/second
ETH/USDEthereum / US Dollar~1/second
SOL/USDSolana / US Dollar~1/second
BNB/USDBNB / US Dollar~1/second
XRP/USDXRP / US Dollar~1/second
DOGE/USDDogecoin / US Dollar~1/second
HYPE/USDHyperliquid / US Dollar~1/second

​
Quick start

Connect and subscribe to all 7 feeds: 
const WebSocket = require("ws");

const ws = new WebSocket(
  "wss://ws.polynode.dev/ws?key=YOUR_API_KEY"
);

ws.on("open", () => {
  ws.send(JSON.stringify({
    action: "subscribe",
    type: "chainlink"
  }));
});

ws.on("message", (data) => {
  const msg = JSON.parse(data);
  if (msg.type === "price_feed") {
    console.log(`${msg.data.feed}: $${msg.data.price}`);
  }
});

​
Filter to specific feeds

Only receive the feeds you care about: 
{
  "action": "subscribe",
  "type": "chainlink",
  "filters": {
    "feeds": ["BTC/USD", "ETH/USD"]
  }
}
Omit feeds to get all 7.

​
Event format

Every price update arrives as a price_feed event: 
{
  "type": "price_feed",
  "feed": "BTC/USD",
  "timestamp": 1774672588,
  "data": {
    "feed": "BTC/USD",
    "price": 66225.49,
    "bid": 66221.69,
    "ask": 66229.46,
    "timestamp": 1774672588
  }
}
See Event Format for the full field reference.

​
Combining with other streams

Crypto prices run on the same WebSocket connection as settlements, orderbook, and oracle streams. Send multiple subscribe messages: 
// Settlements + crypto prices on the same connection
ws.on("open", () => {
  ws.send(JSON.stringify({ action: "subscribe", type: "settlements" }));
  ws.send(JSON.stringify({ action: "subscribe", type: "chainlink" }));
});

ws.on("message", (data) => {
  const msg = JSON.parse(data);
  if (msg.type === "price_feed") {
    // crypto price tick
    console.log(`${msg.data.feed}: $${msg.data.price}`);
  } else if (msg.type === "settlement") {
    // polymarket settlement
    console.log(`${msg.data.market_title}: ${msg.data.outcome}`);
  }
});
Use the type field ("price_feed" vs "settlement") to route events.

​
REST Endpoints

In addition to the WebSocket stream, crypto data is available via REST. See the REST API reference for full details.
EndpointDescription
GET /v1/crypto/marketsAll crypto prediction markets
GET /v1/crypto/candles?symbol=BTC5-min OHLC candles from Chainlink oracle
GET /v1/crypto/price?symbol=BTC&window={epoch}Open/close price for a market window
GET /v1/crypto/activeCurrently active 5-minute markets for all 7 coins
GET /v1/crypto/seriesRecurring crypto market series
All endpoints require an API key via ?key= or x-api-key header.

​
Short-Form Crypto Markets

These prices power prediction markets. All 7 coins have active 5-minute, 15-minute, and 1-hour “Up or Down” prediction markets on Polymarket. The Chainlink price feed determines the opening price (price-to-beat), and the closing price at window end decides the outcome. Hundreds of trades happen every minute on these markets.
Here’s how it works: a BTC 5-minute market opens at 10:00 with BTC at 66,800.IfBTCisabove66,800. If BTC is above 66,800 at 10:05, “Up” wins. If it’s below, “Down” wins. A new market opens at 10:05 with the new price as the target. This repeats every 5 minutes, 15 minutes, and every hour, across all 7 coins.

​
What you can do with this

StreamWhat it gives youHow to get it
Chainlink pricesUnderlying asset price at ~1/secsubscribe('chainlink') on the main WS
Short-form settlementsEvery trade on 5m/15m/1h marketsSDK shortForm('15m') auto-rotates between windows
Short-form orderbookBid/ask depth on crypto marketsOrderbookEngine with clobTokenIds from rotation
Price-to-beatChainlink opening price per windowIncluded in SDK rotation events
Odds & liquidityMarket-implied probabilitiesIncluded in SDK rotation events

​
Quick example

Track BTC price alongside 15-minute market odds: 
import { PolyNodeWS } from 'polynode-sdk';

const ws = new PolyNodeWS('pn_live_...', 'wss://ws.polynode.dev/ws');

// Live BTC price from Chainlink
const prices = await ws.subscribe('chainlink')
  .feeds(['BTC/USD'])
  .send();

prices.on('price_feed', (msg) => {
  console.log(`BTC: $${msg.price}`);
});

// 15-minute market rotation + settlements
const stream = ws.shortForm('15m', { coins: ['btc'] });

stream.on('rotation', (r) => {
  const m = r.markets[0];
  console.log(`Window: beat $${m.priceToBeat} | ${(m.upOdds * 100).toFixed(0)}% up | ${r.timeRemaining}s left`);
});

stream.on('settlement', (e) => {
  console.log(`Trade: ${e.outcome} $${e.taker_size}`);
});
The SDK handles market discovery, slug computation, token resolution, and automatic rotation between windows. See Short-Form Markets for the full reference including the interactive slug calculator, all 14 market fields, and how to connect the orderbook.

​
Market slug patterns

Slugs are deterministic, based on the window’s Unix epoch timestamp:
IntervalPatternExample
5 min{coin}-updown-5m-{epoch}btc-updown-5m-1775399100
15 min{coin}-updown-15m-{epoch}eth-updown-15m-1775397600
1 hourHuman-readablebitcoin-up-or-down-april-5-2026-10am-et
The epoch timestamp is always aligned to the interval boundary: Math.floor(now / intervalSeconds) * intervalSeconds.

​
Use cases

  • Short-form market trading — track the underlying asset price alongside 5m/15m/1h crypto markets
  • Portfolio valuation — combine real-time crypto prices with Polymarket positions for live PnL
  • Hedging signals — correlate crypto price moves with prediction market settlements
  • Dashboards — display live crypto prices alongside prediction market data
  • Trading bots — trigger Polymarket trades based on crypto price thresholds