> ## Documentation Index
> Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Rich Trading Metrics for UpdatePairs

*Published March 13, 2026*

![Rich Trading Metrics for UpdatePairs](https://www.datocms-assets.com/86369/1780001596-goldrush-post-2x-1780001582332.jpg)

The `updatePairs` streaming endpoint has been substantially rebuilt. Previously, it delivered real-time price updates for DEX pairs. Now it returns a full suite of trading metrics across four rolling time windows: **5 minutes, 1 hour, 6 hours, and 24 hours**.

## New fields per timeframe

Each time window (`last_5m`, `last_1hr`, `last_6hr`, `last_24hr`) now includes:

| Metric           | Description                                            |
| ---------------- | ------------------------------------------------------ |
| `price`          | Current price with percent change from previous window |
| `swap_count`     | Total number of swaps                                  |
| `volume_usd`     | Total volume in USD                                    |
| `buy_count`      | Number of buy transactions                             |
| `sell_count`     | Number of sell transactions                            |
| `buy_volume`     | Buy-side volume in USD                                 |
| `sell_volume`    | Sell-side volume in USD                                |
| `unique_buyers`  | Distinct buyer addresses                               |
| `unique_sellers` | Distinct seller addresses                              |

Every metric carries `current_value`, `previous_value`, and `pct_change` so you can track momentum without maintaining your own rolling windows.

## New endpoint: `updateTokens`

We've also launched `updateTokens`, which works the same way but takes **token addresses** instead of pair addresses. It automatically selects the highest-volume pool for each token, so you get the most liquid price feed without needing to look up pair addresses yourself.

```graphql theme={null}
subscription {
  updateTokens(
    chain_name: BASE_MAINNET
    token_addresses: ["0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b"]
  ) {
    quote_rate_usd
    market_cap
    liquidity
    last_5m {
      price { current_value pct_change }
      swap_count { current_value }
      volume_usd { current_value }
      unique_buyers { current_value }
      unique_sellers { current_value }
    }
    last_24hr {
      price { current_value pct_change }
      volume_usd { current_value }
    }
  }
}
```

## What this unlocks

* **Token screening dashboards**: Stream buy/sell ratios, unique trader counts, and volume trends to surface tokens gaining traction in real time.
* **Sniper and copy-trading bots**: React to sudden spikes in swap count or unique buyers within the 5-minute window.
* **Risk monitoring**: Track sell pressure via sell\_count and sell\_volume across multiple timeframes to detect distribution patterns early.
* **Simplified token tracking**: Use `updateTokens` to monitor any token by address without manually resolving which pool has the deepest liquidity.

## Supported chains

Both `updatePairs` and `updateTokens` are available on: Base, BNB Chain, Ethereum, HyperEVM, MegaETH, Monad, Polygon, and Solana.

[Learn more](https://goldrush.dev/docs/api-reference/streaming-api/subscriptions/update-pairs-stream)