Rich Trading Metrics for UpdatePairs - GoldRush API Documentation

Published March 13, 2026 Rich Trading Metrics for UpdatePairs

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.

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

​New fields per timeframe

​New endpoint: updateTokens

​What this unlocks

​Supported chains

New fields per timeframe

New endpoint: `updateTokens`

What this unlocks

Supported chains