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

# UpnlItem

Token holder with balance and PnL information

## Fields

<ResponseField name="volume" type="string">
  Total volume of tokens transferred (string to avoid JS precision loss)
</ResponseField>

<ResponseField name="wallet_address" type="string">
  Wallet address of the token holder (lowercase with 0x prefix)
</ResponseField>

<ResponseField name="transactions_count" type="int">
  Total number of transactions
</ResponseField>

<ResponseField name="balance" type="string">
  Current token balance (string to avoid JS precision loss)
</ResponseField>

<ResponseField name="contract_metadata" type="object">
  Token contract metadata

  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="token_address" type="string">
  Token contract address (lowercase with 0x prefix)
</ResponseField>

<ResponseField name="pnl_realized_usd" type="float">
  Realized profit and loss in USD
</ResponseField>

<ResponseField name="pnl_unrealized_usd" type="float">
  Unrealized profit and loss in USD
</ResponseField>

<ResponseField name="marketcap_usd" type="string">
  Market capitalization in USD
</ResponseField>

<ResponseField name="balance_pretty" type="string">
  Human-readable token balance with proper decimal places
</ResponseField>