New DEX Pairs Stream - GoldRush API Documentation

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

Estimate your monthly cost for this API using the Pricing Calculator.

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

Show properties

contract_name

string

Name of the token contract

contract_address

string

Address of the token contract

contract_decimals

int

Number of decimal places for the token

contract_ticker_symbol

string

Ticker symbol of the token

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

Show properties

contract_name

string

Name of the token contract

contract_address

string

Address of the token contract

contract_decimals

int

Number of decimal places for the token

contract_ticker_symbol

string

Ticker symbol of the token

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

Show properties

contract_name

string

Name of the token contract

contract_address

string

Address of the token contract

contract_decimals

int

Number of decimal places for the token

contract_ticker_symbol

string

Ticker symbol of the token

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

Credit Cost

Supported Chains

​Parameters

​Subscription

​Response Format

​Field Descriptions

Parameters

Subscription

Response Format

Field Descriptions