Skip to main content
The New DEX Pairs stream provides real-time updates when new liquidity pairs are created on decentralized exchanges (DEXes). 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
​
protocols
array<enum>
required
List of protocol name enums to filter events (e.g.,[UNISWAP_V2, RAYDIUM_AMM]); see supported DEXes for the full list.Available values: CLANKER_V3, JOE_V2, KUMBAYA_V1, METEORA_DAMM, METEORA_DBC, METEORA_DLMM, MOONSHOT, NAD_FUN, ORCA_WHIRLPOOL, PANCAKESWAP_V2, PANCAKESWAP_V3, PRISM_V1, PROJECT_X, PUMP_FUN, PUMP_FUN_AMM, QUICKSWAP_V2, QUICKSWAP_V3, RAYDIUM_AMM, RAYDIUM_CLMM, RAYDIUM_CPMM, RAYDIUM_LAUNCH_LAB, SHADOW_V2, SHADOW_V3, SUSHISWAP_V2, UNISWAP_V2, UNISWAP_V3, VIRTUALS_V2

​
Subscription

You can subscribe to the newPairs endpoint to receive events.

​
Basic Subscription Query

subscription {
  newPairs(chain_name: BASE_MAINNET, protocols: [UNISWAP_V2, UNISWAP_V3]) {
    chain_name
    protocol
    protocol_version
    tx_hash
    block_signed_at
  }
}

​
Complete Subscription Query

subscription {
  newPairs(chain_name: BASE_MAINNET, protocols: [UNISWAP_V2, UNISWAP_V3]) {
    chain_name
    protocol
    protocol_version
    pair_address
    deployer_address
    tx_hash
    block_signed_at
    liquidity
    supply
    market_cap
    event_name
    quote_rate
    quote_rate_usd
    base_token {
      contract_address
      contract_decimals
      contract_name
      contract_ticker_symbol
    }
    pair {
      contract_address
      contract_decimals
      contract_name
      contract_ticker_symbol
    }
    quote_token {
      contract_address
      contract_decimals
      contract_name
      contract_ticker_symbol
    }
  }
}

​
Response Format

Here’s an example of the response data structure: 
{
  "data": {
    "newPairs": [
      {
        "chain_name": "base",
        "protocol": "uniswap",
        "protocol_version": "3",
        "pair_address": "0xa7dfb58a6e0d675c19f76dfd3b8b80a3a4814728",
        "deployer_address": "0x33128a8fc17869897dce68ed026d694621f6fdfd",
        "tx_hash": "0x5374c0182580ff2b3e868f58bdce697f3e4256baebc6f6e8db008fadb32d6253",
        "block_signed_at": "2025-05-28T22:01:41Z",
        "liquidity": 177.50267302070574,
        "supply": 1000000000,
        "market_cap": 6153.261270529,
        "event_name": "PoolCreated",
        "quote_rate": 0.000006153261270529,
        "quote_rate_usd": 0.000006153261270529,
        "base_token": {
          "contract_address": "0x8ac05571b525dd555320df58a40a0c0ab6d807c7",
          "contract_decimals": 18,
          "contract_name": "GOAT",
          "contract_ticker_symbol": "GOAT"
        },
        "quote_token": {
          "contract_address": "0x1111111111166b7fe7bd91427724b487980afc69",
          "contract_decimals": 18,
          "contract_name": "Zora",
          "contract_ticker_symbol": "ZORA"
        },
        "pair": {
          "contract_address": "0xa7dfb58a6e0d675c19f76dfd3b8b80a3a4814728",
          "contract_decimals": 18,
          "contract_name": "GOAT-ZORA Pool",
          "contract_ticker_symbol": "GOAT-ZORA"
        }
      }
    ]
  }
}

​
Field Descriptions

​
chain_name
string
The blockchain network where the pair was created
​
protocol
string
DEX protocol name (e.g., “uniswap”, “pancakeswap”)
​
protocol_version
string
Version of the DEX protocol
​
pair_address
string
Address of the new pair contract
​
deployer_address
string
Address that deployed the pair contract
​
tx_hash
string
Transaction hash of the pair creation
​
block_signed_at
string
ISO timestamp of when the block was signed
​
liquidity
float
Initial liquidity amount (in USD)
​
supply
integer
Total supply of the pair token
​
market_cap
float
Market capitalization in USD
​
event_name
string
Name of the contract event (e.g., “PoolCreated”)
​
quote_rate
float
Exchange rate between base and quote tokens
​
quote_rate_usd
float
USD value of the quote rate
​
base_token
object
Metadata for the base token including contract address, decimals, name, and symbol
​
quote_token
object
Metadata for the quote token including contract address, decimals, name, and symbol
​
pair
object
Metadata for the pair including contract address, decimals, name, and symbol