How BlockShield totals an entity's on-chain holdings across chains: exact base units, unpriced tokens left NULL, and partial sweeps that can never erase.
The total on-chain value held by a named entity — an exchange, a treasury company, a fund — summed across every address claim that entity has been verified to control, on every chain we can read.
It measures what the tracked addresses hold. It is not a balance sheet: off-chain assets, custodial arrangements and addresses nobody has attributed are outside it by construction.
No paid dependency. Commercial multi-chain balance APIs are optional accelerators; the feature works with no key beyond a single free explorer key, falling back through free chain indexes and finally to a derived path that reads transfer logs and confirms balances with an on-chain multicall.
Sources fail over sequentially, never as an if-else chain. A present-but-invalid key must fall through to the next source — the branching version of this once blinded a whole token layer on a major exchange.
Sums are done in exact base units as integers. A 256-bit token amount silently loses precision in a float, so floats are display-grade only here.
NULL is not zero. A token nothing can price is listed as unpriced and excluded from the total, never carried at zero and never given a fabricated value. A spam token named after a stablecoin stays unpriced rather than being valued at a dollar.
Partial cannot erase. If any address failed, the sweep is stored incomplete and deletes nothing; pruning of vanished tokens happens only on complete sweeps. Violating that rule once turned a nine-figure portfolio into a much smaller one.
A price is only as big as the market behind it. Quotes taken from a decentralised pool are capped at twice the liquidity that priced them, and any non-native position above an implausible ceiling is treated as a pricing artifact until proven otherwise — a pre-minted pool token once valued an entity in the quadrillions.
A price needs a market to EXIST, which is a different question from how deep that market is. Contract-level pricing happily prices a contract nobody trades: one dead token was priced several times above the live asset it shared a name with, on a contract that had gone years without a transfer. A price survives only while some market can be shown for that exact contract.
Seeds are validated, never trusted. Placeholder, truncated and mis-filed address claims are rejected at import. One address may legitimately carry claims from more than one entity, so uniqueness is per claim, not per address.
Address attribution is the hard part and the honest limit. An entity's total is only as complete as the set of addresses that has been verified for it, and the address count is published beside the value for that reason.
An entity that has never been aggregated reads “no data yet”, not a zero-dollar portfolio. Those are different facts and every surface keeps them different.
Flows are computed as an AMOUNT delta valued at a price, never as a USD delta. In a week where the asset moved nineteen percent, a USD diff would fire on every holder in the market, while an amount diff on a pure price move sums to exactly zero.
Open the live Entities tab →