Skip to content
How the numbers work

How fresh the figures are

Balances are read again when something happens on chain, prices on a cadence set by how much they matter, and every screen shows how old its figures are.

Nothing you open in Port_ waits on a data provider. Every screen reads our own copy of your port, which is why it opens at once, and that copy carries the time it was last read. The question is how that copy is kept current, and the answer is different for balances and for prices.

A wallet is read again when something happens to it, not on a clock. On most chains we read, a transfer in or out of your address reaches us within seconds as a notification, and that marks the wallet to be read again. A wallet that has not moved is not stale: it is correct.

Notifications can go missing, so every wallet also has an outer limit, set by what it holds on each chain. While you are using Port_, which means any time in the last two days, a wallet covered by notifications is read again after at most an hour on a chain where it holds three or more tokens, six hours where it holds fewer, and a day where it holds nothing, whether or not anything arrived. Priority sync makes that 30 minutes to 12 hours.

Once you have been away longer than that, a covered wallet waits at least six hours (three hours with priority sync), because nothing is looking at it, and the first screen you open reads anything older than the limits above straight away. An account nobody has used for seven days has no outer limit at all: its wallets are read when a notification says something moved, and otherwise wait until somebody opens a screen again, and that screen reads them.

Where no notification covers a wallet, because the chain has none or the wallet is not signed up for them yet, opening a screen re-reads it once its figures are older than the window your plan gives you:

  • Pro: a minute.
  • Free and a quick look: fifteen minutes.

A wallet you have only just added has nothing to show yet, so it is always read straight away.

Prices are kept apart from balances. There is one current price per token, shared by everybody who holds it, refreshed on a cadence set by how much it matters:

Price Asked again
A priced token on somebody’s screen right now Every minute
A counted price held by several wallets, or with a deep market behind it Every five minutes
Any other counted price Hourly
A price below the bar, in case a proper market has appeared Daily
A token nothing has priced yet Daily

A wallet read asks for a price only when the store has never priced a token before, so a token you added a minute ago still gets a figure without waiting for its turn.

A market that stops trading leaves its last price behind, and its source goes on quoting that last trade. So the age that matters is the age of the trade, not of our copy: a price whose market has not traded for two days stops counting, however deep that market was and however you came to hold the token. The row stays, labelled as having had no trades for two days, and folds with the tokens that have no market at all. If the market trades again, the row comes back on the next read.

While you are signed in and the tab is in front of you, the app asks for the current figures every thirty seconds and re-reads the whole port every five minutes. A change to a balance also arrives on a live stream once it has been read. A tab in the background asks for nothing, and so does a tab nobody has touched for an hour; touching it again brings it up to date.

An exchange you connected sends no notification when your balance changes, so it is read on a schedule instead: every five minutes while you are using Port_ (any screen in the last fifteen minutes), at most an hour apart when you are not, and not at all for an account nobody has used for seven days.