Whale and distribution movements

EN source master · P09-L07 · 45 minutes estimated · needs_review

“Whale moved tokens” often bundles a quantity, an entity label and a prediction. Only the quantity may be directly supported. A transfer to a labelled exchange can be custody movement, an internal allocation or something else; it is not automatically a sale.

This lesson quantifies balance and distribution changes under an explicit threshold. It keeps movement, execution and market causality separate and produces no BUY/SELL signal.

Define whale as an analytical threshold

Whale is an informal label. Give it an operational meaning, such as an owner authority holding at least8% of the stated supply at a particular snapshot. The threshold is an analyst's convention, not a protocol fact or a measure of a person's wealth.

Choose aggregation unit: token account, owner authority or independently established entity. Solana owner-scoped enumeration requires a mint/program filter [S09-OWNERS]. Partial returned accounts can support a returned total without establishing all beneficial holdings.

Do not merge owner authorities because they share funding or labels. That would import an ownership hypothesis into the metric. A threshold classification can change when inventory moves, but human-control conclusions remain unresolved.

Pin asset, units and denominator

Identify exact mint/contract, network, decimals and supply context. Use the same asset in numerator and denominator. In the fixture, quantities are normalized and supply stays constant by explicit assumption.

A transfer rearranges holdings under the supplied standard model; it does not create or destroy units. If real supply changes during the window, compare matched snapshots and identify the changing denominator. A fall in percentage can result from redistribution, changed supply or both.

An aggregate row labelled Other is many unspecified holders, not one owner. It cannot be ranked as a single whale. If the composition is unknown, state the concentration information you cannot recover.

Separate gross flow and net inventory

Gross outgoing sums successful outward movements. Gross incoming sums inward movements. Net change is incoming minus outgoing. A return transfer can make net outflow smaller than gross outflow.

A claim “sold half the holdings” cannot be established by gross transfers alone. Even if the gross outgoing amount equals half the opening balance, a sale mechanism and economic execution remain separate evidence questions.

For the supplied closed window, final inventory follows opening plus inbound minus outbound. Reconcile all known addresses and unchanged aggregate inventory to total supply. If a real result fails, inspect coverage and transfer mechanics rather than invent a balancing counterparty.

Distinguish transfer from market execution

A token transfer can occur as part of a trade, but not every transfer is a trade. Seek decoded swap/execution records, asset pairs, results and balance effects if the question concerns buying or selling. Transaction result structures provide mechanism/effect views [S09-STRUCTURES]; the transfer view alone does not supply missing execution semantics.

A provider's exchange label does not authenticate destination identity. Even a genuinely verified exchange address would not reveal whether the recipient credited an internal account, whether an order executed or who beneficially controlled it.

A position/custody transfer can move an accounting claim without moving underlying assets in the same way. A report should avoid converting every visible motion into directional trading volume. Event count and transfer quantity are not exchange turnover.

Test causality separately

If a fictional price index falls after a transfer, temporal order is an observation. It does not establish that the transfer caused the price change. Multiple contemporaneous events, broader market moves and liquidity changes can be alternative explanations.

A causal claim requires a specified mechanism and analysis that addresses alternatives; a simple before/after chart does not do that. Even a verified swap's local price effect should not automatically be presented as the sole cause of a broader market move.

Do not use a selective time window to make the narrative fit. Preserve the full supplied sequence and avoid describing the index as a real token price. This lesson includes an invented index only to test the boundary between chronology and causality.

Compare distribution snapshots conservatively

Show before and after balances with the same scope. An address dropping from 10% to 6% changes by four percentage points, not4% relative. Its relative reduction is 40% of its initial holding. These are different quantities.

A threshold crossing from above8% to below8% follows the chosen convention. It does not mean the address stopped being influential or a person became less wealthy. Remaining liquidity and ownership may be unknown.

The largest known owner is not necessarily the largest owner globally when Other's composition is unavailable. Say “largest among supplied individual authorities” if appropriate and leave exhaustive ranking unresolved.

Write a movement report without a signal

A useful finding states gross outflow, gross inflow, net change, snapshot percentages, threshold and gaps. It separately records destination labels and market chronology.

Never append “therefore buy/sell” or a price target. A movement report supports further investigation, not a market instruction. No address identity, affiliation or motive should be attributed without enough independent evidence.

• Whale threshold: declared holding convention at a context.
• Gross outflow: total successful outward quantity.
• Net change: inflow minus outflow.
• Percentage-point change: difference between two percentages.
• Transfer volume: moved quantity, distinct from trading volume.
• Causality: explanatory claim beyond temporal sequence.

ILLUSTRATIVE — FIX-P09-07. SIM-CHAIN-A / TOKEN-D, supply 1,000,000 normalized tokens at S0/S1. Complete window movements; no fees in TOKEN-D, no mint/burn or other effects.

S0: W100,000; L50,000; X0; Y0; Other850,000 aggregated across unspecified holders. Threshold convention: at least8% of supplied total.

Invented pre-window index 100; not a real price or currency. Provider labels X “Exchange-X,” basis absent. No swap, order execution, beneficial-owner or market-cause evidence is supplied.

OBSERVED in fixture: Three transfers and index sequence are supplied; W receives a return10,000.

INFERRED: W outflow 50,000, inflow 10,000, net−40,000, final60,000. Holding share 10%→6%, down four points. W crosses the declared8% threshold.

UNKNOWN: Entity behind X/Y, trade execution, other holders' composition and causation.

INSUFFICIENT EVIDENCE: Transfers do not establish sales or BUY/SELL signals. A later index change does not prove the movement caused it. Other850,000 cannot be called one whale.

Calling gross outflow net reduction; interpreting provider-labelled exchange transfers as sales; treating percentage points as relative percent; ranking Other as one person; and inferring causality from a following price change.

Calculate gross/net flow and final balances for W/X/Y. Reconcile S1 supply. Compute W's initial/final shares, relative holding reduction and threshold status. Correct “W sold50% and caused a 10% market drop.”

• Define whale threshold and aggregation unit.
• Match asset, precision and supply context.
• Separate gross, net and final inventory.
• Reconcile known distribution without person merges.
• Require execution evidence for trade claims.
• Keep chronology separate from causality and signals.

Large movements can be quantified without claiming sales, motives or market causes. Distribution changes are account-level observations under declared conventions.

Transfer is not a trade. Net reduction differs from gross outgoing. Wallet movement and temporal price order do not establish financial signals or causality.

Paired S0/S1 distribution for W,L,X,Y and clearly aggregated Other; W10%→6%,8% threshold, gross 50k/in10k/net−40k. Separate invented index timeline from movement table with no causal arrow or signal; X label unverified.

Illustrative distribution movements; no sale, cause or BUY/SELL conclusion.

Use deterministic SVG/HTML or charts with units, evidence locators and text alternatives. Navy/black with restrained cyan, electric blue and violet; no decorative or fabricated explorer screenshots. At 390px stack annotations; verify 768px, desktop and Arabic RTL when assets are implemented. Keep identifiers LTR and factual time/edge/axis directions unchanged. Use only the official supplied ZECOIN mark. Both visual records remain specifications.

WALLET_INTELLIGENCE maps to read-only inspection of public address records, relationships and provenance. Verify supported network, exact identifiers, fields and coverage before any runtime integration; no live provider capability is claimed here. Use the embedded offline exercise if data or paid access is unavailable. No wallet connection, credentials, private key, signature or live trade is required. Missing data stays unknown. Academy progress, creator status, payments and referrals never alter Radar evidence.

• Solana getTokenAccountsByOwner — Owner-scoped holdings enumeration with mint/program filters. Checked 2026-09-30.
• Solana Assets — Mint, token account and owner-authority distinctions. Checked 2026-09-30.
• Solana RPC JSON Structures — Result metadata, fee, instructions and balances as distinct views. Checked 2026-09-30.

All example records are original ILLUSTRATIVE fixtures, not historical/live chain measurements. Documentation explains mechanisms, not invented amounts or labels. Synthetic chronology is explicitly bounded; observedAt=null is intentional. OBSERVED in an exercise means a supplied fixture record. Re-review documentation and deployed decoding before publication. Provider labels do not establish identity; address control and human attribution require distinct evidence.

P09-L08 after the worked exercise and question review.