Docs · For traders
Points
Trading through Submarine and launching coins on it earns points. The Points page counts them from what is already on the chain, for any address, with nothing to sign or connect. They decide each wallet's part of the airdrop: 20% of the Submarine token's supply, whose live value is on the Airdrop page.
How points are counted
| What | Points per ZRO | Counted from |
|---|---|---|
| Trading through Submarine | 10 | Every buy and sale through the router, on any token it reaches |
| Others trading coins you launched on Submarine | 1 | Every trade by another wallet on a token you launched on Submarine's launchpad |
| Trading on other launchpads on Zero | 5 | Trades made straight on another launchpad's contract, not through Submarine |
A wallet's points start to count once it has traded 40 ZRO through Submarine. Before that the Points page shows what it has, marked as not counting yet, and how much more it needs to trade.
A worked example
A wallet trades 1,200 ZRO through Submarine, launched a coin that others traded for 8,000 ZRO, and traded 800 ZRO on another launchpad.
| Part | ZRO | Points |
|---|---|---|
| Trading here, 1,200 × 10 | 1,200 | 12,000 |
| Your coins, 8,000 × 1 | 8,000 | 8,000 |
| Elsewhere, 800 × 5 | 800 | 4,000 |
| In all | 24,000 |
Looking up an address
Paste any address on the Points page to see its points, each part with the ZRO behind it, its place on the board and its share of all points. The board lists the wallets with the most points and moves with every trade.
From code
| Route | What it answers |
|---|---|
GET /api/v1/points/rules | The rules: perZroTraded, perZroOnYourCoins, perZroElsewhere and minVolume |
GET /api/v1/points/leaders?limit=50 | The wallets whose points count, by points, up to 200, with the total and how many wallets there are |
GET /api/v1/points/:address | One address: points, each part, whether it counts yet, its place and its share of all points |
ts
const me = await fetch('<Submarine API URL>/api/v1/points/0xYourAddress').then((r) => r.json());
console.log(me.points, me.live ? `place ${me.place} of ${me.wallets}` : 'not counting yet');The figures are worked out at most every 30 seconds. More routes are on Public API.
Good to know
- Points are counted by Submarine's indexer from chain events, not kept by a contract.
- Your own trades on a coin you launched count as trading, not as trading on your coins.
- Limit orders and copy-vault copies and exits count as your trading: those contracts trade through the router in your name. The contracts themselves never score.
- Points and volume ranks are separate. Ranks are kept by the router and lower your fee. Points are only a count.
Not final yet. The airdrop is 20% of the Submarine token's supply, split by points. When and how it is sent gets announced before it happens, and the rules may change before then.