Skip to content
How the numbers work

Prices, confidence and liquidity

Every price in Port_ carries where it came from, how deep the market behind it is and how sure we are of it. Only a price we can stand behind goes into a total.

How much you hold and what it is worth are two separate questions in Port_, answered by two separate reads. The amount comes from the chain, for your wallet. The price comes from our own price store, which holds one current price per token and is shared by everybody who holds it. Your figure is the one multiplied by the other.

Every price in the store carries three things besides the number:

  • A source: where the quote came from.
  • A liquidity figure: how much money sits in the market behind it, when the source says. A source that reports none is recorded as having none, never given a figure we made up.
  • A confidence: a score from 0 to 1 for how far we would stand behind it.

The confidence is what decides whether a price goes into a total.

Where the price came from Confidence
A market with at least $10,000 of liquidity behind the quote 1
A protocol pricing its own token from its own contracts, such as a lending market’s oracle or a vault’s share price 0.9
A chain’s own coin that no market answered for, such as Bitcoin, quoted market wide by its ticker 0.7
SafeTrade’s own order book, for a coin held there that no chain we read carries, with a bid behind it 0.7
The same, with no bid behind it 0.4
A source that gives a price and no liquidity figure at all 0.4
A market with less than $10,000 behind it 0.3

The bar is 0.5. A price at or above it counts towards your net worth. A price below it stays out of every headline total. Its row carries a label saying why, and it may be folded out of the list by one of the switches described in What is not counted and why: counted at the foot of the list, one switch away, never deleted.

Apart from a chain’s own coin, which no contract can claim to be, and a coin held on SafeTrade that no chain carries, a ticker is never used: it is exactly what an impersonator copies, so tokens are always matched by contract address.

A row whose price is not counted says so under the token’s name, in the app’s own words:

  • thin pool, shown not counted for a market we measured and found shallow.
  • no pool behind it, shown not counted for a source that quoted a price and reported no market behind it. That is not the same claim as thin: it means we have no depth figure at all, not a small one.
  • no trades for two days, shown not counted for a price whose market has stopped trading. See How fresh the figures are.
  • no market, still held for a token nothing has ever priced.

A token that is a claim on a protocol, such as a lending receipt or a liquidity position, is redeemed against that protocol rather than traded, so it is labelled as a receipt rather than as missing a market: a Pendle position the protocol has not priced yet reads Pendle receipt, no price from the protocol yet.

Two sources can disagree about the same token. When a new quote arrives, it replaces the stored price only if it is at least as well grounded, meaning its confidence is the same or higher. Without that rule the same wallet could read a different total depending on which read happened to run last. There is one exception: after six hours, any current quote replaces a stored one however good the old one was, so a source that has gone quiet cannot hold a price in place.

A move no real market makes is not counted until something agrees with it. A new quote more than ten times above or below the stored price is kept, and its confidence drops to 0.4, so it shows on the row and stays out of the total.

  • We never invent a liquidity figure or let a price we cannot vouch for pass as a firm one.
  • We never back-fill a historical price from today’s quote. A cost from the past taken off a current price is a guess wearing a fact’s label, and your PnL would inherit it.
  • We never price a protocol receipt off a market. Any pool quoting a receipt is an accident, so a receipt is valued from what its protocol says it redeems for.

For what stays out of the total besides a low-confidence price, see What is not counted and why.