Siade WhalesDocs
/
Open app

How the numbers are calculated

The rules behind every figure on the platform — what counts as a trade, how value is established, and when a number is withheld.

Every number on the platform is produced by a rule, and the rules are the same everywhere. This page states them. The pages underneath go into the cases where they get difficult.

The reason for writing them down is simple enough: a portfolio tracker is a set of claims about your money, and a claim you cannot check is worth very little.

The starting problem

A self-custody wallet has no account history. An exchange knows what you bought because you bought it there — it recorded the order, the price and the fee.

A blockchain records none of that. It records transfers: an amount of something moved from one address to another at a particular block. Whether that was a purchase, a gift, a transfer between your own wallets, a bridge, a refund or an airdrop is not written down anywhere.

So every figure beyond your current balance is reconstructed. The rules below are how.

What counts as a trade

A purchase is value leaving your wallet and an asset arriving, in a way consistent with an exchange of one for the other.

A sale is the reverse.

Receiving is not buying. Tokens arriving with nothing going out are not a purchase at a price of zero. They have no cost basis, and treating them as free acquisitions would invent profit that does not exist.

Moving between your own wallets is not a trade. Nothing was bought or sold; the same holding is in a different place.

A bridge is not a trade. Assets leaving one network and arriving on another are the same position on a different chain.

Cost basis and P&L covers each of these, including where the detection is imperfect.

How positions are valued

Cost basis is calculated two ways. Average cost — buying the same asset repeatedly averages the prices, and selling part of a position realizes profit against that average — is used across the Wallet. FIFO — the first units bought are the first sold — is available in Transactions & P&L, because many tax authorities, Spain's among them, require it.

The platform does not attempt to be a tax calculation. The CSV export includes both methods so that whoever prepares your return has the source data.

Trades are priced at the moment they happened, using historical prices at daily resolution. Current value uses current prices.

When a number is withheld

Some figures depend on having the complete history of a wallet. Where that history cannot be rebuilt — an address with more transactions than the data source will return — the figures that depend on it are hidden and the reason is shown.

A wrong P&L is worse than a missing one, because it looks usable. Someone reading a plausible profit figure has no way to know it was calculated over a third of their history.

The movements themselves still appear. Only what depends on completeness is withheld.

When a price is not a price

An asset's value is what it can be sold for. A quoted price that comes only from a thin automated market maker pool is not that, and including it produces a portfolio total that cannot be realized.

Those holdings are kept out of your totals and shown separately, with their quoted value visible. Unlisted tokens explains how they are identified and why it matters more than it sounds — in one test wallet, a single such token accounted for 49% of the apparent portfolio.

What is excluded from totals

Watchlist addresses appear everywhere you can look at them and contribute to nothing you own. Adding a wallet covers the distinction.

Freshness

Numbers are stored with the time they were read and refreshed on their own schedule, rather than fetched when you open a page. Gas moves every twenty seconds; sector categories change once a month; both are treated accordingly.

Where the data comes from lists every source and every refresh interval.

In this section