Struct TokenHolder 

pub struct TokenHolder {

    pub accu_cost: Option<String>,
    pub amount: String,
    pub amount_in_usd: String,
    pub avg_buy_price_usd: Option<String>,
    pub avg_cost_usd: Option<String>,
    pub avg_sell_price_usd: Option<String>,
    pub buy_amount_cur: Option<String>,
    pub buy_volume_native: Option<String>,
    pub buy_volume_usd: Option<String>,
    pub end_holding_at: Option<i64>,
    pub first_buy_time: Option<i64>,
    pub history_bought_cost: Option<String>,
    pub history_bought_fee: Option<String>,
    pub history_sold_fee: Option<String>,
    pub history_sold_income: Option<String>,
    pub history_transfer_in_amount: Option<String>,
    pub history_transfer_in_cost: Option<String>,
    pub history_transfer_out_amount: Option<String>,
    pub history_transfer_out_income: Option<String>,
    pub is_closed: Option<bool>,
    pub is_transfer_in: Option<bool>,
    pub last_active_at: Option<i64>,
    pub loss_count: Option<i64>,
    pub maker_token_tags: Vec<String>,
    pub native_balance: Option<String>,
    pub netflow_usd: Option<String>,
    pub percentage: String,
    pub position_cost_usd: Option<String>,
    pub realized_pnl_ratio: Option<String>,
    pub realized_profit: Option<String>,
    pub roi: Option<String>,
    pub sell_amount_cur: Option<String>,
    pub sell_amount_percentage: Option<String>,
    pub sell_volume_native: Option<String>,
    pub sell_volume_usd: Option<String>,
    pub start_holding_at: Option<i64>,
    pub tags: Vec<String>,
    pub total_buy_count: Option<i64>,
    pub total_cost_usd: Option<String>,
    pub total_profit: Option<String>,
    pub total_sell_count: Option<i64>,
    pub transfer_in_amount7d: Option<String>,
    pub transfer_in_count: Option<i64>,
    pub transfer_out_amount7d: Option<String>,
    pub transfer_out_count: Option<i64>,
    pub unrealized_profit: Option<String>,
    pub wallet_address: String,
    pub wallet_tag_v2: Option<String>,
    pub win_count: Option<i64>,
}

Token holder

JSON schema

{
 "description": "Token holder",
 "type": "object",
 "required": [
   "amount",
   "amountInUsd",
   "percentage",
   "walletAddress"
 ],
 "properties": {
   "accuCost": {
     "description": "Traceable position accumulated cost, USD (GMGN: accu_cost)",
     "type": "string"
   },
   "amount": {
     "description": "Token holding amount",
     "examples": [
       "1000000000000000000"
     ],
     "type": "string"
   },
   "amountInUsd": {
     "description": "Token holding value in USD",
     "examples": [
       "1000000000000000000"
     ],
     "type": "string"
   },
   "avgBuyPriceUsd": {
     "description": "Average buy price in USD per token (all-time)",
     "type": "string"
   },
   "avgCostUsd": {
     "description": "Average cost per token in USD (current position cost basis)",
     "type": "string"
   },
   "avgSellPriceUsd": {
     "description": "Average sell price in USD per token (all-time)",
     "type": "string"
   },
   "buyAmountCur": {
     "description": "Cumulative token quantity bought, all-time (GMGN: buy_amount_cur / history_bought_amount)",
     "type": "string"
   },
   "buyVolumeNative": {
     "description": "All-time total buy volume in native token",
     "type": "string"
   },
   "buyVolumeUsd": {
     "description": "All-time total buy volume in USD",
     "type": "string"
   },
   "endHoldingAt": {
     "description": "Timestamp when holder fully closed position (ms since epoch)",
     "type": "integer",
     "format": "int64"
   },
   "firstBuyTime": {
     "description": "Timestamp of first token purchase (ms since epoch)",
     "type": "integer",
     "format": "int64"
   },
   "historyBoughtCost": {
     "description": "Total DEX buy cost including fees, USD (GMGN: history_bought_cost)",
     "type": "string"
   },
   "historyBoughtFee": {
     "description": "Total DEX buy fees, USD (GMGN: history_bought_fee)",
     "type": "string"
   },
   "historySoldFee": {
     "description": "Total DEX sell fees, USD (GMGN: history_sold_fee)",
     "type": "string"
   },
   "historySoldIncome": {
     "description": "Total DEX sell income, USD (GMGN: history_sold_income)",
     "type": "string"
   },
   "historyTransferInAmount": {
     "description": "Cumulative transfer-in token qty (GMGN: history_transfer_in_amount)",
     "type": "string"
   },
   "historyTransferInCost": {
     "description": "Transfer-in USD cost basis (GMGN: history_transfer_in_cost)",
     "type": "string"
   },
   "historyTransferOutAmount": {
     "description": "Cumulative transfer-out token qty (GMGN: history_transfer_out_amount)",
     "type": "string"
   },
   "historyTransferOutIncome": {
     "description": "Transfer-out USD income (GMGN: history_transfer_out_income)",
     "type": "string"
   },
   "isClosed": {
     "description": "Whether the token position is fully closed (balance = 0)",
     "type": "boolean"
   },
   "isTransferIn": {
     "description": "Position acquired purely via transfers, no DEX buy (GMGN: transfer_in)",
     "type": "boolean"
   },
   "lastActiveAt": {
     "description": "Last active timestamp (ms since epoch)",
     "type": "integer",
     "format": "int64"
   },
   "lossCount": {
     "description": "Number of losing trades (PnL < 0)",
     "type": "integer",
     "format": "int64"
   },
   "makerTokenTags": {
     "description": "Per-token position/behaviour tags derived at query time.\nPossible values: \"top_holder\" (rank ≤ 10, first page only),\n\"whale\" (holding > $10,000 USD), \"diamond_hands\" (held > 30 days).",
     "type": "array",
     "items": {
       "type": "string"
     }
   },
   "nativeBalance": {
     "description": "Native chain token balance in lamports (SOL) or wei (EVM), as decimal string.\nFetched from RPC with a 10-second Redis cache.",
     "type": "string"
   },
   "netflowUsd": {
     "description": "Net USD inflow (buy_volume_usd − sell_volume_usd); positive = net buyer",
     "type": "string"
   },
   "percentage": {
     "description": "Percentage of total supply held",
     "examples": [
       "100"
     ],
     "type": "string"
   },
   "positionCostUsd": {
     "description": "Current open position cost in USD",
     "type": "string"
   },
   "realizedPnlRatio": {
     "description": "Realized PnL / total_cost ratio (GMGN: realized_pnl)",
     "type": "string"
   },
   "realizedProfit": {
     "description": "Realized PnL in USD (all-time)",
     "type": "string"
   },
   "roi": {
     "description": "Return on investment = total_pnl / total_cost_all (e.g. 0.25 = 25%)",
     "type": "string"
   },
   "sellAmountCur": {
     "description": "Cumulative token quantity sold, all-time (GMGN: sell_amount_cur / history_sold_amount)",
     "type": "string"
   },
   "sellAmountPercentage": {
     "description": "Sell quantity / buy quantity, capped 0–1 (GMGN: sell_amount_percentage)",
     "type": "string"
   },
   "sellVolumeNative": {
     "description": "All-time total sell volume in native token",
     "type": "string"
   },
   "sellVolumeUsd": {
     "description": "All-time total sell volume in USD",
     "type": "string"
   },
   "startHoldingAt": {
     "description": "Timestamp when holder first acquired the token (ms since epoch)",
     "type": "integer",
     "format": "int64"
   },
   "tags": {
     "description": "Trader classification tags (e.g. \"kol\", \"smart\", \"sniper\")",
     "type": "array",
     "items": {
       "type": "string"
     }
   },
   "totalBuyCount": {
     "description": "All-time total buy trade count",
     "type": "integer",
     "format": "int64"
   },
   "totalCostUsd": {
     "description": "All-time accumulated cost basis in USD (total_cost_all from pnl-sync)",
     "type": "string"
   },
   "totalProfit": {
     "description": "Total PnL in USD (realized + unrealized)",
     "type": "string"
   },
   "totalSellCount": {
     "description": "All-time total sell trade count",
     "type": "integer",
     "format": "int64"
   },
   "transferInAmount7d": {
     "description": "Inbound transfer volume in native token over last 7 days",
     "type": "string"
   },
   "transferInCount": {
     "description": "Number of token transfer-in events (GMGN: transfer_in_count)",
     "type": "integer",
     "format": "int64"
   },
   "transferOutAmount7d": {
     "description": "Outbound transfer volume in native token over last 7 days",
     "type": "string"
   },
   "transferOutCount": {
     "description": "Number of token transfer-out events (GMGN: transfer_out_count)",
     "type": "integer",
     "format": "int64"
   },
   "unrealizedProfit": {
     "description": "Unrealized PnL in USD (current position)",
     "type": "string"
   },
   "walletAddress": {
     "description": "Holder wallet address",
     "examples": [
       "0x1234567890abcdef"
     ],
     "type": "string"
   },
   "walletTagV2": {
     "description": "Global rank tag on this token when sorted by balance (e.g. \"TOP1\", \"TOP2\").\nOnly present on the first page of a balance-sorted query (no cursor).",
     "type": "string"
   },
   "winCount": {
     "description": "Number of winning trades (PnL > 0)",
     "type": "integer",
     "format": "int64"
   }
 }
}

Fields

accu_cost: Option<String>

Traceable position accumulated cost, USD (GMGN: accu_cost)

amount: String

Token holding amount

amount_in_usd: String

Token holding value in USD

avg_buy_price_usd: Option<String>

Average buy price in USD per token (all-time)

avg_cost_usd: Option<String>

Average cost per token in USD (current position cost basis)

avg_sell_price_usd: Option<String>

Average sell price in USD per token (all-time)

buy_amount_cur: Option<String>

Cumulative token quantity bought, all-time (GMGN: buy_amount_cur / history_bought_amount)

buy_volume_native: Option<String>

All-time total buy volume in native token

buy_volume_usd: Option<String>

All-time total buy volume in USD

end_holding_at: Option<i64>

Timestamp when holder fully closed position (ms since epoch)

first_buy_time: Option<i64>

Timestamp of first token purchase (ms since epoch)

history_bought_cost: Option<String>

Total DEX buy cost including fees, USD (GMGN: history_bought_cost)

history_bought_fee: Option<String>

Total DEX buy fees, USD (GMGN: history_bought_fee)

history_sold_fee: Option<String>

Total DEX sell fees, USD (GMGN: history_sold_fee)

history_sold_income: Option<String>

Total DEX sell income, USD (GMGN: history_sold_income)

history_transfer_in_amount: Option<String>

Cumulative transfer-in token qty (GMGN: history_transfer_in_amount)

history_transfer_in_cost: Option<String>

Transfer-in USD cost basis (GMGN: history_transfer_in_cost)

history_transfer_out_amount: Option<String>

Cumulative transfer-out token qty (GMGN: history_transfer_out_amount)

history_transfer_out_income: Option<String>

Transfer-out USD income (GMGN: history_transfer_out_income)

is_closed: Option<bool>

Whether the token position is fully closed (balance = 0)

is_transfer_in: Option<bool>

Position acquired purely via transfers, no DEX buy (GMGN: transfer_in)

last_active_at: Option<i64>

Last active timestamp (ms since epoch)

loss_count: Option<i64>

Number of losing trades (PnL < 0)

maker_token_tags: Vec<String>

Per-token position/behaviour tags derived at query time. Possible values: “top_holder” (rank ≤ 10, first page only), “whale” (holding > $10,000 USD), “diamond_hands” (held > 30 days).

native_balance: Option<String>

Native chain token balance in lamports (SOL) or wei (EVM), as decimal string. Fetched from RPC with a 10-second Redis cache.

netflow_usd: Option<String>

Net USD inflow (buy_volume_usd − sell_volume_usd); positive = net buyer

percentage: String

Percentage of total supply held

position_cost_usd: Option<String>

Current open position cost in USD

realized_pnl_ratio: Option<String>

Realized PnL / total_cost ratio (GMGN: realized_pnl)

realized_profit: Option<String>

Realized PnL in USD (all-time)

roi: Option<String>

Return on investment = total_pnl / total_cost_all (e.g. 0.25 = 25%)

sell_amount_cur: Option<String>

Cumulative token quantity sold, all-time (GMGN: sell_amount_cur / history_sold_amount)

sell_amount_percentage: Option<String>

Sell quantity / buy quantity, capped 0–1 (GMGN: sell_amount_percentage)

sell_volume_native: Option<String>

All-time total sell volume in native token

sell_volume_usd: Option<String>

All-time total sell volume in USD

start_holding_at: Option<i64>

Timestamp when holder first acquired the token (ms since epoch)

tags: Vec<String>

Trader classification tags (e.g. “kol”, “smart”, “sniper”)

total_buy_count: Option<i64>

All-time total buy trade count

total_cost_usd: Option<String>

All-time accumulated cost basis in USD (total_cost_all from pnl-sync)

total_profit: Option<String>

Total PnL in USD (realized + unrealized)

total_sell_count: Option<i64>

All-time total sell trade count

transfer_in_amount7d: Option<String>

Inbound transfer volume in native token over last 7 days

transfer_in_count: Option<i64>

Number of token transfer-in events (GMGN: transfer_in_count)

transfer_out_amount7d: Option<String>

Outbound transfer volume in native token over last 7 days

transfer_out_count: Option<i64>

Number of token transfer-out events (GMGN: transfer_out_count)

unrealized_profit: Option<String>

Unrealized PnL in USD (current position)

wallet_address: String

Holder wallet address

wallet_tag_v2: Option<String>

Global rank tag on this token when sorted by balance (e.g. “TOP1”, “TOP2”). Only present on the first page of a balance-sorted query (no cursor).

win_count: Option<i64>

Number of winning trades (PnL > 0)

Implementations

impl TokenHolder

pub fn builder() -> TokenHolder

Trait Implementations

impl Clone for TokenHolder

fn clone(&self) -> TokenHolder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TokenHolder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TokenHolder

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&TokenHolder> for TokenHolder

fn from(value: &TokenHolder) -> Self

Converts to this type from the input type.

impl From<TokenHolder> for TokenHolder

fn from(value: TokenHolder) -> Self

Converts to this type from the input type.

impl Serialize for TokenHolder

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<TokenHolder> for TokenHolder

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: TokenHolder) -> Result<Self, ConversionError>

Performs the conversion.