Skip to main content
Real-time price data from Chainlink Data Streams. Reports arrive approximately once per second per feed, streamed directly via WebSocket (not polling). Subscribe with "type": "chainlink" to receive price feed events.
{
  "type": "price_feed",
  "feed": "BTC/USD",
  "timestamp": 1772616170,
  "data": {
    "feed": "BTC/USD",
    "feed_id": "0x00039d9e45394f473ab1f050a1b963e6b05351e52d71e507509ada0c95ed75b8",
    "price": 71280.55,
    "bid": 71279.77,
    "ask": 71281.35,
    "timestamp": 1772616170,
    "source": "chainlink_data_streams"
  }
}

Subscribing

{"action": "subscribe", "type": "chainlink"}
With feed filter (only receive specific feeds):
{
  "action": "subscribe",
  "type": "chainlink",
  "filters": {
    "feeds": ["BTC/USD"]
  }
}
Omit the feeds filter to receive all available price feeds.

Response

{
  "type": "subscribed",
  "subscriber_id": "550e8400-e29b-41d4-a716-446655440000",
  "subscription_type": "chainlink"
}
Chainlink subscriptions do not include a snapshot — events start arriving with the next Chainlink report (~1 second).

Fields

type
string
required
Always "price_feed".
feed
string
required
Human-readable feed name (e.g. "BTC/USD").
timestamp
number
required
Chainlink observation timestamp in Unix seconds.
data
object
required

Available feeds

FeedFeed IDCadence
BTC/USD0x00039d9e...b8~1 report/second
More feeds will be added over time. Use the feeds filter to subscribe to specific ones.

Dual subscription

Chainlink price feeds run on the same WebSocket connection as settlement subscriptions. Send both subscribe messages to receive both:
{"action": "subscribe", "type": "settlements"}
{"action": "subscribe", "type": "chainlink"}
Events arrive interleaved. Use the type field ("settlement" vs "price_feed") to route them in your application.

Use cases

  • Portfolio valuation — combine BTC price with Polymarket positions for real-time PnL
  • Hedging signals — correlate BTC price moves with prediction market settlements
  • Dashboards — display live crypto prices alongside prediction market data
  • Trading bots — trigger Polymarket trades based on BTC price thresholds