Testnet on Base Sepolia: 1 ZRO here is 0.0001 test ETH.
Docs · Leaderboard and portfolios

Docs · For traders

Leaderboard and portfolios

The Leaderboard ranks the best traders, the best creators and the most points. Every wallet also has a portfolio page with its profit, its positions and its record. All of them count profit the same way, from sales, by average cost.

The three boards

BoardRanked byOver
TradersProfit locked in by selling, then volume24 hours, 7 days, 30 days or all time
CreatorsThe creator's part of the fees their coins paid, then others' volume on their coins24 hours, 7 days, 30 days or all time
PointsPoints: trading through Submarine, others trading your coins, and trading on other launchpadsAll time only

Each board shows the top 100 and, when you have a wallet, your own place however far down it is. A board is worked out again at most once a minute. Submarine's own contracts and other launchpads' contracts trade for people, so they never rank themselves.

How profit is counted

Profit is realised by selling. Each buy adds its coins and the ZRO it cost to your position in that coin. Each sale realises what it brought, less what the coins sold cost at the position's average price, and takes that cost out of the position. So a sale today counts against buys from last week, and the window only decides which sales count.

  • Paper gains don't count on the traders' board. A position can be marked up by its holder's own second wallet; a sale has to find a real buyer.
  • Coins that were sent to you rather than bought have no cost, so selling them realises nothing either way.
  • A creator's trades in their own coin are left out. Buying your own launch in its first block and selling it to the crowd is not trading.
  • A wins count is the coins sold at a profit in the window, and each row shows the coin that made the wallet the most.

Example: you buy 1,000,000 tokens for 40 ZRO, then 1,000,000 more for 60 ZRO, so they cost 50 ZRO per million on average. You sell 1,000,000 for 90 ZRO. That sale realises 40 ZRO. The other million is still open at a cost of 50 ZRO.

The creators' board

A creator is on the board once someone else has traded one of their coins in the window, or it paid them. Their figure is the creator's part of every fee, on the curve and on the pool, as the launchpad reports it. Each row shows their launches, how many graduated, others' volume on their coins, and their biggest coin by market cap now.

Dumping your own coin takes you off the board for good. A creator who has let go of more than half of what they bought of one of their own coins, sold or sent to another wallet, is removed from the creators' board, however much they earned before. The board says how many creators have been removed so far.

Your portfolio

Portfolio is your wallet as one dashboard, read top to bottom:

  • Total profit, and what it is on what you spent, split into realised, from sales by average cost, and unrealised, on what you hold now at today's price.
  • Profit over time, beside a calendar of your trading days.
  • What there is to collect: creator fees and referral earnings, each with its claim button.
  • Your coins a tab at a time: open positions, closed ones, activity, orders, launches, and the copy vault.
  • Your rank card, adding ZRO, sending, your key, invites and settings.

Anyone's page

Every wallet has a page at /traders/<address>, the same dashboard as your portfolio. In place of your own controls it has following and copying, and its record by period: profit, win rate, holding time, buy sizes and best coins. Click any wallet on the board, in a trade list or among a coin's holders to open it.

From code

GET /api/v1/leaderboard?kind=traders|creators|points&window=1d|7d|30d|all, with limit up to 200 and address for that wallet's row. A wallet's profit by coin and in total is /api/v1/wallet/:address/pnl, and every holder's profit on one coin is /api/v1/tokens/:address/holders/pnl. See Public API.

Profit here is worked out from events, in ZRO, and leaves out gas. It is for reading, not for settling.