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

# New DEX Pairs Stream

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.

<CardGroup cols={2}>
  <Card title="Credit Cost"> 1 per minute </Card>

  <Card title="Supported Chains">
    * `BASE_MAINNET`
    * `BSC_MAINNET`
    * `ETH_MAINNET`
    * `HYPEREVM_MAINNET`
    * `MEGAETH_MAINNET`
    * `MONAD_MAINNET`
    * `POLYGON_MAINNET`
    * `SOLANA_MAINNET`
  </Card>
</CardGroup>

<Tip>
  Estimate your monthly cost for this API using the [Pricing Calculator](/pricing-calculator?endpoint=%2Fapi-reference%2Fstreaming-api%2Fsubscriptions%2Fnew-dex-pairs-stream).
</Tip>

## Parameters

<ParamField body="chain_name" type="enum" required>
  Blockchain network to filter events

  Type: [`ChainName`](/api-reference/streaming-api/types/chain-name)
</ParamField>

<ParamField body="protocols" type="enum[]" required>
  DEX protocols to filter results by

  Type: [`UnifiedProtocol`](/api-reference/streaming-api/types/unified-protocol)
</ParamField>

## Subscription

You can subscribe to the `newPairs` endpoint to receive events.

```graphql theme={null}
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:

```json theme={null}
{
  "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

<ResponseField name="pair" type="object">
  Metadata for the pair including contract address, decimals, name, and symbol

  Type: [`TokenContractMetadata`](/api-reference/streaming-api/types/token-contract-metadata)

  <Expandable title="properties">
    <ResponseField name="contract_name" type="string">
      Name of the token contract
    </ResponseField>

    <ResponseField name="contract_address" type="string">
      Address of the token contract
    </ResponseField>

    <ResponseField name="contract_decimals" type="int">
      Number of decimal places for the token
    </ResponseField>

    <ResponseField name="contract_ticker_symbol" type="string">
      Ticker symbol of the token
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="liquidity" type="float">
  Initial liquidity amount in USD
</ResponseField>

<ResponseField name="tx_hash" type="string">
  Transaction hash of the pair creation
</ResponseField>

<ResponseField name="supply" type="float">
  Total supply of the pair token
</ResponseField>

<ResponseField name="pair_address" type="string">
  Address of the new pair contract
</ResponseField>

<ResponseField name="dev_holdings" type="float">
  Developer token holdings
</ResponseField>

<ResponseField name="base_token" type="object">
  Metadata for the base token including contract address, decimals, name, and symbol

  Type: [`TokenContractMetadata`](/api-reference/streaming-api/types/token-contract-metadata)

  <Expandable title="properties">
    <ResponseField name="contract_name" type="string">
      Name of the token contract
    </ResponseField>

    <ResponseField name="contract_address" type="string">
      Address of the token contract
    </ResponseField>

    <ResponseField name="contract_decimals" type="int">
      Number of decimal places for the token
    </ResponseField>

    <ResponseField name="contract_ticker_symbol" type="string">
      Ticker symbol of the token
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="protocol" type="string">
  DEX protocol name (e.g., uniswap, pancakeswap)
</ResponseField>

<ResponseField name="protocol_version" type="string">
  Version of the DEX protocol
</ResponseField>

<ResponseField name="market_cap" type="float">
  Market capitalization in USD
</ResponseField>

<ResponseField name="quote_rate" type="float">
  Exchange rate between base and quote tokens
</ResponseField>

<ResponseField name="quote_token" type="object">
  Metadata for the quote token including contract address, decimals, name, and symbol

  Type: [`TokenContractMetadata`](/api-reference/streaming-api/types/token-contract-metadata)

  <Expandable title="properties">
    <ResponseField name="contract_name" type="string">
      Name of the token contract
    </ResponseField>

    <ResponseField name="contract_address" type="string">
      Address of the token contract
    </ResponseField>

    <ResponseField name="contract_decimals" type="int">
      Number of decimal places for the token
    </ResponseField>

    <ResponseField name="contract_ticker_symbol" type="string">
      Ticker symbol of the token
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="quote_rate_usd" type="float">
  USD value of the quote rate
</ResponseField>

<ResponseField name="event_name" type="string">
  Name of the contract event (e.g., PoolCreated)
</ResponseField>

<ResponseField name="block_signed_at" type="string">
  Timestamp when the block was signed (ISO-8601)
</ResponseField>

<ResponseField name="deployer_address" type="string">
  Address that deployed the pair contract
</ResponseField>

<ResponseField name="chain_name" type="string">
  The blockchain network where the pair was created
</ResponseField>