Skip to main content
The Update Pairs stream provides real-time updates on the prices, volumes, market cap and liquidity of one or many token pairs. This documentation follows our standard streaming API structure.

Credit Cost

TBD

Supported Chains

  • BASE_MAINNET
  • BSC_MAINNET
  • ETH_MAINNET
  • HYPEREVM_MAINNET
  • MEGAETH_MAINNET
  • MONAD_MAINNET
  • POLYGON_MAINNET
  • SOLANA_MAINNET
  • SONIC_MAINNET
This stream is currently in Beta. It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. No API credits are currently charged.We welcome your feedback so please reach out to us directly to report issues or request features.

​
Parameters

​
chain_name
enum
required
Chain name to filter events (e.g. BASE_MAINNET, ETH_MAINNET, BSC_MAINNET, SOLANA_MAINNET)Available values: BASE_MAINNET, BSC_MAINNET, ETH_MAINNET, HYPERCORE_MAINNET, HYPEREVM_MAINNET, MEGAETH_MAINNET, MONAD_MAINNET, POLYGON_MAINNET, SOLANA_MAINNET
​
pair_addresses
array<string>
required
Array of pair addresses on supported DEXes and chains to track

​
Subscription

You can subscribe to the updatePairs endpoint to receive the events.

​
Basic Subscription Query

subscription {
  updatePairs(
    chain_name: BASE_MAINNET
    pair_addresses: ["0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"]
  ) {
    chain_name
    pair_address
    timestamp
    quote_rate
    quote_rate_usd
    market_cap
    liquidity
    last_5m {
      price { current_value pct_change }
      volume_usd { current_value }
      swap_count { current_value }
    }
  }
}

​
Complete Subscription Query

subscription {
  updatePairs(
    chain_name: BASE_MAINNET
    pair_addresses: [
      "0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"
      "0x4b0Aaf3EBb163dd45F663b38b6d93f6093EBC2d3"
    ]
  ) {
    chain_name
    pair_address
    timestamp
    quote_rate
    quote_rate_usd
    market_cap
    liquidity
    base_token {
      contract_name
      contract_address
      contract_decimals
      contract_ticker_symbol
    }
    quote_token {
      contract_name
      contract_address
      contract_decimals
      contract_ticker_symbol
    }
    last_5m {
      price { current_value previous_value pct_change }
      swap_count { current_value previous_value pct_change }
      volume_usd { current_value previous_value pct_change }
      buy_count { current_value }
      sell_count { current_value }
      unique_buyers { current_value }
      unique_sellers { current_value }
    }
    last_1hr {
      price { current_value previous_value pct_change }
      swap_count { current_value previous_value pct_change }
      volume_usd { current_value previous_value pct_change }
    }
    last_6hr {
      price { current_value previous_value pct_change }
      swap_count { current_value previous_value pct_change }
      volume_usd { current_value previous_value pct_change }
    }
    last_24hr {
      price { current_value previous_value pct_change }
      swap_count { current_value previous_value pct_change }
      volume_usd { current_value previous_value pct_change }
    }
  }
}

​
Response Format

Here’s an example of the response data structure: 
{
  "data": {
    "updatePairs": {
      "chain_name": "BASE_MAINNET",
      "pair_address": "0x9c087Eb773291e50CF6c6a90ef0F4500e349B903",
      "timestamp": "2025-08-13T12:34:56Z",
      "quote_rate": 0.0002962,
      "quote_rate_usd": 1.39,
      "market_cap": 1250000.50,
      "liquidity": 850000.25,
      "base_token": {
        "contract_name": "Virtual",
        "contract_ticker_symbol": "VIRTUAL",
        "contract_address": "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b",
        "contract_decimals": 18
      },
      "quote_token": {
        "contract_name": "Wrapped Ether",
        "contract_ticker_symbol": "WETH",
        "contract_address": "0x4200000000000000000000000000000000000006",
        "contract_decimals": 18
      },
      "last_5m": {
        "price": {
          "current_value": 1.39,
          "previous_value": 1.37,
          "pct_change": 1.46
        },
        "swap_count": {
          "current_value": 10,
          "previous_value": 8,
          "pct_change": 25.0
        },
        "volume_usd": {
          "current_value": 975.52,
          "previous_value": 820.10,
          "pct_change": 18.95
        }
      },
      "last_1hr": {
        "price": {
          "current_value": 1.39,
          "previous_value": 1.36,
          "pct_change": 2.21
        },
        "swap_count": {
          "current_value": 100,
          "previous_value": 85,
          "pct_change": 17.65
        },
        "volume_usd": {
          "current_value": 12500.00,
          "previous_value": 10200.00,
          "pct_change": 22.55
        }
      }
    }
  }
}

​
Field Descriptions

​
chain_name
string
The blockchain network where the pair exists
​
pair_address
string
The address of the DEX pair
​
timestamp
string
ISO-8601 timestamp of the update
​
quote_rate
float
Exchange rate between base and quote tokens
​
quote_rate_usd
float
Exchange rate between base and quote tokens in USD
​
market_cap
float
Market capitalization of the token pair
​
liquidity
float
Total liquidity in the pool
​
base_token
object
Information about the base token in the pair
​
quote_token
object
Information about the quote token in the pair
​
last_5m / last_1hr / last_6hr / last_24hr
object
Aggregated trading metrics for each timeframe window (TimeframeMetrics)