Skip to main content
Subscriptions (WebSockets) require a Growth or Enterprise plan. Learn more.

​
Returns

​
Arguments

subscription {
  onPriceUpdated(
    address: "So11111111111111111111111111111111111111112"
    networkId: 1399811149
  ) {
    address
    networkId
    priceUsd
    timestamp
    blockNumber
  }
}
Example Response
{
  "data": {
    "onPriceUpdated": {
      "address": "So11111111111111111111111111111111111111112",
      "networkId": 1399811149,
      "priceUsd": 126.7659247882934,
      "timestamp": 1769559478,
      "blockNumber": 396371407
    }
  }
}

​
Usage Guidelines

  • Provide address (token contract address) and networkId to subscribe to price updates for a specific token
  • priceUsd returns the current USD price of the token, updated with every on-chain swap
  • Optionally specify sourcePairAddress to get pricing from a specific liquidity pool instead of the default top pair
  • Use blockNumber to track which block the price update originated from
  • This subscription is ideal for simple price feeds — use onBarsUpdated if you need OHLCV candlestick data

​
Troubleshooting Tips

By default, the price is derived from the token’s top liquidity pair. You can override this by passing a sourcePairAddress to use a specific pool for pricing.
Updates are sent in real-time with every swap that affects the token’s price. High-volume tokens will produce more frequent updates.
Use onPriceUpdated for a simple, real-time price feed (e.g., displaying a live price ticker). Use onBarsUpdated when you need OHLCV candlestick data, volume breakdowns, or multiple time resolutions for charting.
These fields are deprecated. Pricing is no longer based on specific pools, so these values are no longer meaningful. Use blockNumber instead to track the source of price updates.