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

# NewPairItem

A newly created DEX trading pair with market data

## Fields

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