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

1 per minute

Supported Chains

  • BASE_MAINNET
  • BSC_MAINNET
  • ETH_MAINNET
  • HYPEREVM_MAINNET
  • MEGAETH_MAINNET
  • MONAD_MAINNET
  • POLYGON_MAINNET
  • SOLANA_MAINNET

​
Parameters

​
chain_name
enum
required
Blockchain network to filter eventsType: ChainName
​
protocols
enum[]
required
DEX protocols to filter results byType: UnifiedProtocol

​
Subscription

You can subscribe to the newPairs endpoint to receive events. 
subscription {
  newPairs(
    chain_name: BASE_MAINNET
    protocols: [
      UNISWAP_V2
      UNISWAP_V3
    ]
  ) {
    pair {
      contract_name
      contract_address
      contract_decimals
      contract_ticker_symbol
    }
    liquidity
    tx_hash
    supply
    pair_address
    dev_holdings
    base_token {
      contract_name
      contract_address
      contract_decimals
      contract_ticker_symbol
    }
    protocol
    protocol_version
    market_cap
    quote_rate
    quote_token {
      contract_name
      contract_address
      contract_decimals
      contract_ticker_symbol
    }
    quote_rate_usd
    event_name
    block_signed_at
    deployer_address
    chain_name
  }
}

​
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

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