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

​
Returns

Price
Price

​
Arguments

address
String
The token contract address. Required unless you are on an enterprise plan including PriceFeed features.
networkId
Int
The network ID the token is deployed on.
sourcePairAddress
String
The pair contract address from which to get pricing. Defaults to the top pair for the token.
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.