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.

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
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
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