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

# EnhancedSwapData

Real-time swap update with price, volume, and timeframe analytics

## Fields

<ResponseField name="trader" type="string">
  Address of the trader who initiated the swap
</ResponseField>

<ResponseField name="liquidity" type="float">
  Total liquidity in the pool
</ResponseField>

<ResponseField name="pair_address" type="string">
  The address of the DEX pair
</ResponseField>

<ResponseField name="base_token" type="object">
  Information about the base token in the pair

  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="last_5m" type="object">
  Aggregated trading metrics for the last 5 minutes

  Type: [`TimeframeMetrics`](/api-reference/streaming-api/types/timeframe-metrics)

  <Expandable title="properties">
    <ResponseField name="volume" type="object">
      Total volume in native/quote token (buy + sell)

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="unique_sellers" type="object">
      Number of unique seller addresses

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="sell_count" type="object">
      Number of sell transactions

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="price" type="object">
      Price: current\_value = current price, previous\_value = price at window start

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="buy_count" type="object">
      Number of buy transactions

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="sell_volume" type="object">
      Total sell volume in USD

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="volume_usd" type="object">
      Total volume in USD (buy + sell)

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="buy_volume" type="object">
      Total buy volume in USD

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="swap_count" type="object">
      Total number of swaps

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="unique_buyers" type="object">
      Number of unique buyer addresses

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="last_6hr" type="object">
  Aggregated trading metrics for the last 6 hours

  Type: [`TimeframeMetrics`](/api-reference/streaming-api/types/timeframe-metrics)

  <Expandable title="properties">
    <ResponseField name="volume" type="object">
      Total volume in native/quote token (buy + sell)

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="unique_sellers" type="object">
      Number of unique seller addresses

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="sell_count" type="object">
      Number of sell transactions

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="price" type="object">
      Price: current\_value = current price, previous\_value = price at window start

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="buy_count" type="object">
      Number of buy transactions

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="sell_volume" type="object">
      Total sell volume in USD

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="volume_usd" type="object">
      Total volume in USD (buy + sell)

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="buy_volume" type="object">
      Total buy volume in USD

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="swap_count" type="object">
      Total number of swaps

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="unique_buyers" type="object">
      Number of unique buyer addresses

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="market_cap" type="float">
  Market capitalization of the token pair
</ResponseField>

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

<ResponseField name="last_24hr" type="object">
  Aggregated trading metrics for the last 24 hours

  Type: [`TimeframeMetrics`](/api-reference/streaming-api/types/timeframe-metrics)

  <Expandable title="properties">
    <ResponseField name="volume" type="object">
      Total volume in native/quote token (buy + sell)

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="unique_sellers" type="object">
      Number of unique seller addresses

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="sell_count" type="object">
      Number of sell transactions

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="price" type="object">
      Price: current\_value = current price, previous\_value = price at window start

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="buy_count" type="object">
      Number of buy transactions

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="sell_volume" type="object">
      Total sell volume in USD

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="volume_usd" type="object">
      Total volume in USD (buy + sell)

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="buy_volume" type="object">
      Total buy volume in USD

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="swap_count" type="object">
      Total number of swaps

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="unique_buyers" type="object">
      Number of unique buyer addresses

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="last_1hr" type="object">
  Aggregated trading metrics for the last 1 hour

  Type: [`TimeframeMetrics`](/api-reference/streaming-api/types/timeframe-metrics)

  <Expandable title="properties">
    <ResponseField name="volume" type="object">
      Total volume in native/quote token (buy + sell)

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="unique_sellers" type="object">
      Number of unique seller addresses

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="sell_count" type="object">
      Number of sell transactions

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="price" type="object">
      Price: current\_value = current price, previous\_value = price at window start

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="buy_count" type="object">
      Number of buy transactions

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="sell_volume" type="object">
      Total sell volume in USD

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="volume_usd" type="object">
      Total volume in USD (buy + sell)

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="buy_volume" type="object">
      Total buy volume in USD

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="swap_count" type="object">
      Total number of swaps

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="unique_buyers" type="object">
      Number of unique buyer addresses

      Type: [`MetricValue`](/api-reference/streaming-api/types/metric-value)

      <Expandable title="properties">
        <ResponseField name="previous_value" type="float">
          Total value for the previous duration
        </ResponseField>

        <ResponseField name="pct_change" type="float">
          Percent change between current\_value and previous\_value
        </ResponseField>

        <ResponseField name="current_value" type="float">
          Total value for the most recent duration
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

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

<ResponseField name="sender" type="string">
  Address that sent the transaction
</ResponseField>

<ResponseField name="quote_token" type="object">
  Information about the quote token in the pair

  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="id" type="string">
  Unique identifier for this swap event
</ResponseField>

<ResponseField name="chain_name" type="enum">
  The blockchain network where the pair exists

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

<ResponseField name="direction" type="string">
  Swap direction: buy or sell
</ResponseField>

<ResponseField name="timestamp" type="string">
  Timestamp of the latest swap (ISO-8601)
</ResponseField>