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

Docs · For traders

Calls and clans

A call says "this coin" in public, from your wallet, and gives you a link to share. For seven days, buys made through that link pay you 30% of Submarine's cut, at no cost to the buyer. A clan is a trading group of up to 50 wallets, ranked together by what its members make.

Calls

Make a call on the Calls page: pick the coin, add a note of up to 200 characters if you like, and sign. Signing is free and sends no transaction. The call gets its own link, which opens the coin with the call remembered:

A call's link
/tokens/<coin address>?call=<call id>

Anyone who opens the coin through that link has the call remembered in their browser until its seven days are over. Their buys of that coin from that browser then go through the router's buyPartner with you as the partner, kind 1, and the router pays you your share as part of the same buy. If they open several calls on one coin, the newest one counts.

What a call earns

You get 30% of Submarine's cut of every buy that came through your link, the same partner share a builder gets. The buyer pays exactly what any buy costs, and the coin's creator, holders and burn get the same.

  • 400 ZROA buy through your link, by a wallet without a rank
    • 1.6Submarine's 0.4%
      • 0.48Yours, 30%, paid in the same transaction
      • 1.12The treasury, shared with a referrer if the buyer has one
Figure 1. Sales pay nothing to a call, and neither do buys of a coin that trades on another launchpad's own contract, outside the router.

A ranked buyer pays a smaller cut, so your share is smaller too, and a fee-free buyer pays none, so it earns you nothing, though the buy still counts toward the call's figures. Your own buys never pay you: the router refuses a partner that is the trader.

How a call is measured

FigureWhat it is
Market cap at the callThe coin's price when you called it, times its supply then
Now and peakThe market cap now, and the highest since the call, from the highest trade price after it
Peak and now multiplePeak, or now, over the market cap at the call. 2x means it doubled
Buyers and boughtWallets that bought through the link in its seven days, and the ZRO they spent
EarnedWhat the router paid you for those buys
Caller soldWhether you sold the coin after calling it

The Calls page has tabs for the latest calls, the ones that brought the most buying, calls by callers you follow, and your own, each over a day, 7 days, 30 days or all time.

The best callers

Callers are ranked on their calls over the window, 30 days unless you pick another: first by the average of their calls' peak multiples, then by the share of their calls that went 2x or more, then by how many calls they made. Each row shows the caller's best call, the buyers their links brought and what they earned. The board is worked out again at most every 30 seconds.

Rules for calls

  • One live call per coin. A second call on the same coin waits until the first one's seven days are over, so every payment belongs to one call.
  • One call every 20 seconds per wallet.
  • The coin must be indexed and have a price, or there is nothing to measure the call from.
  • A note is one line of at most 200 characters.
  • A call can't be edited or taken back. Calling a coin and selling it shows on the call as Caller sold.
A call is not advice. Anyone can call anything. Look at a caller's record, and whether they sold, before you buy through their link.

Clans

On the Clans page, make a clan with a tag, a name and a picture, and you own it. Others ask to join, and you let them in or not. Members leave whenever they like, and you can remove anyone. The clan's page lists its members with their own figures, and the requests waiting.

Rules for clans

WhatRule
Tag2 to 5 letters or digits, shown in capitals. One clan per tag
Name2 to 32 letters, digits, spaces, dots, dashes or underscores
PictureAn https link of at most 300 characters, or none
MembersAt most 50, the owner included
Your clansOne at a time. Leave yours before you make or join another
RequestsOne open at a time. Asking to join another clan replaces it
Owner leavesThe clan passes to the member who has been in it longest. A clan with nobody left is gone
Owner's powersChange the name and picture, let people in, turn them down, remove members

How clans are ranked

A clan's figures are its members' added up, over 7 days, 30 days or all time:

FigureWhat it counts
ProfitRealised profit from selling, by average cost, the same way as the traders' leaderboard. The default order
VolumeZRO traded in the window, and in the last 24 hours
HoldingsWhat the members hold now, at today's prices
MembersHow many

A sale realises against what the member paid on average for that coin over their whole history, so selling coins bought last month counts. Coins that were sent rather than bought realise nothing, a creator's trades in their own coin are left out, and Submarine's own contracts never count as members. See How profit is counted. The ranking is worked out again at most every 30 seconds.

Signing, for builders

Calls and clan changes are signed off chain with personal_sign, like profiles, and sent to the API. The time in the text has to be within 10 minutes of now and later than the last change that wallet signed, so a change can't be sent twice. A wallet made here signs them for you; any wallet that signs plain messages works.

What a wallet signs for a call: POST /api/v1/calls with address, token, note, time and signature
Submarine call
Wallet: <address, lowercase>
Token: <coin address, lowercase>
Note: <note, or (none)>
Time: <unix seconds>
What a wallet signs for a clan change: POST /api/v1/clans with the same fields and the signature
Submarine clan
Action: <create | edit | join | cancel | approve | reject | kick | leave>
Wallet: <address, lowercase>
Clan: <TAG>
Member: <the wallet acted on, lowercase, or ->
Name: <name, or ->
Image: <https link, or ->
Time: <unix seconds>

The routes

GET /api/v1/calls, /api/v1/calls/top and /api/v1/calls/:id, and GET /api/v1/clans, /api/v1/clans/:tag and /api/v1/clans/of/:address. Parameters are on Public API. What a caller has been paid is also in /api/v1/partners/:address.