Documentation

The onchain running log.

Runner turns a trading session into a run. Paste a wallet, start the clock, trade, and stop — and the session becomes a clean, shareable PnL card. There is one rule underneath all of it: every number is correct, or it is absent. Nothing is estimated, and nothing is rounded toward drama.

stop running, find the runner.

Overview

What Runner is

A run is a timed trading session. You choose a wallet and a chain, press Start, and Runner captures a snapshot — a full read of every position in the wallet, each priced against independent market sources and resolved into a single trusted USD valuation. You trade for as long as you like. When you press Stop, Runner captures a second snapshot the same way and reports the change between them.

The wallet you track is the runner; Runner is the app that clocks it. A run is a stopwatch for a trading session — press Start, trade, press Stop, and walk away with a result worth posting.

Run any wallet. Paste an address and go — no signup, no keys — or connect to track your own wallets across sessions. Most traders keep more than one wallet, and Runner is built for that: run as many as you like, whenever you like.

The loop

How a run works

Five steps, start to shareable card.

  1. 01

    Paste a wallet, pick the chain

    Any Solana address. Read-only — you are pointing Runner at a wallet, not giving it access to one.

  2. 02

    Name it (optional)

    Give the run a name, or leave it blank and Runner drops in a default. It shows on the card and in your log.

  3. 03

    Start the clock

    Runner reads the wallet’s total value now. That first reading is the baseline everything is measured against.

  4. 04

    Trade

    Do whatever you were going to do. A live card follows along, coloured by your running P&L, with a trace of the session so far.

  5. 05

    Stop

    Runner reads the wallet again, settles the numbers server-side, and assembles your card. The result is frozen the moment you stop.

During the run the live card is theatre, not accounting — a visual pulse so the session feels alive. The number you post is computed fresh at stop, on the server, from its own reads. What ticks on screen never becomes the final result.

The model

How PnL is measured

A run is measured end to end: a trusted valuation at the start, your performance tracked live through the session, and a fresh valuation at the stop — settled to the dollar.

  1. 01

    The opening snapshot

    When you press Start, Runner reads the entire wallet — every token position — and prices each one against several independent market sources. Those prices are cross-checked against one another, spam and worthless tokens are filtered out, and what remains is a single trusted portfolio value in USD. That value is the baseline the whole run is measured against, and it is fixed the instant you start — it never moves again.

  2. 02

    Tracked through the session

    From that moment the run is tracked continuously. Runner re-reads the portfolio on a rolling basis, computes your P&L and ROI live, follows your peak — the best you were up at any point — and draws the trace of the session as it unfolds. Funds you move in mid-run are detected and netted out on the fly, so the curve is your trading, not your funding.

  3. 03

    The closing snapshot

    Press Stop and Runner values the wallet again — a fresh, authoritative read, priced and cross-checked the same way — then settles the result on the server at full precision. Deposits and withdrawals across the session are reconciled here, so carried-in capital never counts as profit and cashed-out capital never counts as a loss.

  4. 04

    The verdict

    Every valuation carries a confidence. If the numbers hold up you get your figure, your ROI, your peak, your pace, and your trace — frozen and immutable. If they don’t — a price that can’t be trusted, a movement that can’t be resolved — the card renders without a number rather than a wrong one.

PnL = value(stop) − value(start) − net transfers in

ROI = PnL ÷ value(start)

Topping up mid-run. If you run low and send funds in from another wallet, keep going — the gains you make trading that capital count in full. Only the amount you moved in is left out of your profit, because it was carried in, not earned: a $100 top-up is not $100 of profit, but the $30 you then make on it is.

The rule

Trust & accuracy

Correct or absent. Never plausible.

One viral screenshot with a bogus number would end the product's credibility for good, so accuracy is not a feature here — it is the whole constraint. Every data decision optimises for a number Runner can defend, or no number at all.

Each valuation carries a confidence. Independent price sources are cross-checked against one another; worthless and spam tokens are filtered out before they can inflate a total; and when sources disagree, Runner resolves conservatively rather than reaching for the flattering figure.

When confidence is too low to stand behind, the card renders without a figure — the time and chain, marked result unverified. That is the honest outcome, not an error state. Runner would rather show you nothing than show you a number it can't vouch for.

The output

The card

The card is the product's growth engine — the thing people actually post. It is designed to be worth posting whether the run won or lost.

One dark, composed layout, the same everywhere it lands. Your PnL leads; beneath it, four read-outs frame the session:

Distance

Time

Pace

Peak

A trace linedraws the shape of the session — the run's own chart, not a stock template. A gain and a loss get the same weight, the same composure, the same trace: no downward arrows, no red panic, no commentary. Roughly half of all cards will be losses, and a loss card that isn't as good as a win card would cost half the reach.

Alongside the card, a run produces three vertical story formats sized for Instagram and TikTok — a stats cut, a trace cut, and a minimal cut — so the result is ready to share as a reel or story without cropping or rebuilding it.

History

Runs & your log

Every run leaves a record.

A finished run is immutable. Once you stop, its numbers are frozen — re-opening an old run shows exactly what it showed the day you ran it, never silently re-priced. You can name runs, and give a card your own background image, so a session reads as yours at a glance.

Connect a wallet and your runs collect into a personal log — a grid of cards that grows as you run, so a season of trading becomes something you can scroll back through.

Optional

Connecting a wallet

Connecting is a signature, never a transaction. It proves the wallet is yours; it can't move anything.

Runner uses Sign-In With Solana: you sign a message, and that's the whole handshake. There is no approval, no allowance, no spend — nothing that could touch your funds. Decline it and everything except your own history still works.

What connecting unlocks is identity: your runs gather under you, your points accumulate, and your standing becomes yours to keep — every wallet you run, whether you paste it or switch between your own, stays tied to you. It is how a string of one-off runs turns into a profile.

Progression

Points & tasks

Runner keeps score. Points are earned through tasks and carried on your profile.

Some tasks are earned simply by running — distance milestones that add up as your sessions do. Others reward getting the product in front of people: posting a run as a reel on Instagram or TikTok, at rising tiers of reach.

Points that come from the runs themselves are non-forgeable — they derive from real, saved sessions. Points that come from sharing pass through a reviewfirst: you submit the link, it's checked, and the points land on approval. The score stays meaningful because it can't be faked.

What’s next

Roadmap

Where Runner is headed.

Forward-looking — directions, not commitments

This section describes where we'd like to take the product. Nothing here is dated, guaranteed, or a financial promise — it's how we're thinking about aligning Runner with the people who use it.

Leaderboards

A global standings board — and one just for your friends — ranking runners by the metrics that matter: PnL, ROI, consistency. Opt-in. Your card is already shareable; the leaderboard gives it a table to sit in.

Points for performance

Today points come from tasks and activity. We want the trading itself to count too — strong PnL and peak ROI earning points — so standing reflects skill, not just how often you show up.

A creator program

Sharing is the engine. Reels and posts that drive real reach could be recognised and rewarded, turning distribution into something the product formally values rather than takes for granted.

More chains

More chains are coming. Solana is live first because it already clears our accuracy bar; the majors follow as they meet the same standard. The direction is expansion — a growing roster of chains, each held to one bar and added when it’s ready.

Treasury & community rewards

In time Runner may run on a small product fee. We’re exploring a treasury funded that way, with a share routed back to the community — supporting top runners, the creators who bring people in, and the running of the product itself. Points are the natural yardstick for how community rewards could be shared.

Non-negotiables

Principles

The rules the product refuses to bend, even when it's inconvenient.

Correct or absent
A number Runner can’t defend is never shown. There is no “plausible” tier.
Run any wallet
Paste any address or track your own, and run as many wallets as you like. Connecting adds your identity — it never limits you to one.
Your funds stay untouched
Runner reads public balances and signs a message to prove a wallet is yours. It can never move anything.
Every run is permanent
A finished run is frozen. It always shows exactly what it showed the day you ran it.
One standard, every chain
No chain ships until it clears the same accuracy bar Solana did. Expansion never comes at the cost of a number we can’t defend.

Questions

FAQ

Can I run more than one wallet?
Yes — as many as you like. Paste any address to run it, or connect to keep your own wallets and history together. Connecting never locks you to a single wallet.
Do I need to connect a wallet?
No. Paste any address and run. Connecting is optional — it keeps your runs, wallets, and points together under you.
Can Runner move my funds?
No. It reads balances from a public address, and connecting is a signed message — Sign-In With Solana — with no approval or spend attached.
Which chains are supported?
Solana today, with more on the way. New chains are added as they meet the same accuracy standard.
What happens if the numbers can’t be trusted?
The card renders without a figure, marked “result unverified.” Runner shows nothing rather than a number it can’t stand behind.
Do old runs change over time?
No. A finished run is frozen. It always shows what it showed when you stopped it.