Skip to main content

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.

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:
MetricDescription
priceCurrent price with percent change from previous window
swap_countTotal number of swaps
volume_usdTotal volume in USD
buy_countNumber of buy transactions
sell_countNumber of sell transactions
buy_volumeBuy-side volume in USD
sell_volumeSell-side volume in USD
unique_buyersDistinct buyer addresses
unique_sellersDistinct 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