Event Format - PolyNode

Event payload

This example is an explicitly selected spot event. Default followers now receive 30-second and 60-second TWAP events with the same shape and different identity fields. See Chainlink Spot and TWAP Prices for the subscription filters.

{
  "type": "price_feed",
  "feed": "ETH/USD",
  "timestamp": 1774672089,
  "is_twap": false,
  "twap_window_seconds": null,
  "data": {
    "feed": "ETH/USD",
    "price": 1989.49,
    "bid": 1989.49,
    "ask": 1989.49,
    "timestamp": 1774672089,
    "is_twap": false,
    "twap_window_seconds": null
  }
}

Fields

string

required

Always "price_feed".

string

required

Feed name (e.g. "BTC/USD", "ETH/USD"). Top-level convenience field, same value as data.feed.

number

required

Observation timestamp in Unix seconds. Top-level convenience field, same value as data.timestamp.

boolean

required

true for a Chainlink-computed TWAP and false for a spot price.

30 | 60 | null

required

Chainlink TWAP lookback window. null on spot events.

object

required

Show data fields

string

required

Feed name (e.g. "BTC/USD").

number

required

Mid price in USD. This is the canonical price for this asset at this timestamp.

number

required

Bid price in USD.

number

required

Ask price in USD.

number

required

Observation timestamp in Unix seconds.

boolean

required

true for a TWAP event and false for a spot event.

30 | 60 | null

required

TWAP lookback window. null on spot events.

Notes

Update rate: approximately 1 update per second per feed.
No snapshot: unlike settlement subscriptions, price feed subscriptions do not include an initial snapshot. The first event arrives with the next price observation (~1 second after subscribing).
TWAP windows: when you subscribe to both windows, key state by feed and twap_window_seconds. See Chainlink Spot and TWAP Prices.
Deduplication: include feed, twap_window_seconds, and timestamp in a TWAP deduplication key.

​Event payload

​Fields

​Notes

Event payload

Fields

Notes