chain.nativePrices - Metastreams API

{
  "action": "subscribe",
  "channel": "chain.nativePrices",
  "filters": {
    "chains": ["solana", "bsc"]
  }
}

{
  "type": "update",
  "channel": "chain.nativePrices",
  "subscriptionId": "8c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "data": {
    "chain": "solana",
    "asset": "SOL",
    "price": { "native": "1", "usd": "178.42" },
    "observedAt": 1789632015120
  }
}

{
  "action": "subscribe",
  "channel": "chain.nativePrices",
  "filters": {
    "chains": ["solana", "bsc"]
  }
}

{
  "type": "update",
  "channel": "chain.nativePrices",
  "subscriptionId": "8c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "data": {
    "chain": "solana",
    "asset": "SOL",
    "price": { "native": "1", "usd": "178.42" },
    "observedAt": 1789632015120
  }
}

Streams the USD price of each chain’s gas asset: SOL on solana, ETH on base and robinhood, BNB on bsc. Subscribe on an open stream connection. See WebSocket streams for connections, frames and reconnection.

Filters

string[]

Chain slugs whose prices to send. Omit it or send [] to include every chain. arc is accepted, but its gas asset is USDC, so it receives no updates.

{} sends the price of every chain. Each subscription uses one unit of the address limit, whatever its chains.

Message format

Each update’s data is the price of one whole unit of one chain’s gas asset. It has the same row shape that Native prices returns, and price.native is always "1". An update is sent for each chain about every 10 seconds, whether or not the price changed. Each update counts against the organization’s credits, so a {} subscription uses about one credit per chain every 10 seconds. List only the chains you need. Keep one price per chain, choosing the row with the later observedAt.

Initial snapshot

Subscribe.
Read Native prices with chains set to the subscription’s chains.
Merge the REST response and the updates using the rule above.

A chain with no price yet has no row in the REST response. Its price is sent with the next update.

Errors

Code	When
`UNSUPPORTED_CHAIN`	Unsupported slug in `chains`
`VALIDATION_ERROR`	An unknown filter field; an exceeded subscription limit

{
  "action": "subscribe",
  "channel": "chain.nativePrices",
  "filters": {
    "chains": ["solana", "bsc"]
  }
}

{
  "type": "update",
  "channel": "chain.nativePrices",
  "subscriptionId": "8c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
  "data": {
    "chain": "solana",
    "asset": "SOL",
    "price": { "native": "1", "usd": "178.42" },
    "observedAt": 1789632015120
  }
}

​Filters

​Message format

​Initial snapshot

​Errors

Filters

Message format

Initial snapshot

Errors