Docs · For traders
Calls and clans
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:
/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
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
| Figure | What it is |
|---|---|
| Market cap at the call | The coin's price when you called it, times its supply then |
| Now and peak | The market cap now, and the highest since the call, from the highest trade price after it |
| Peak and now multiple | Peak, or now, over the market cap at the call. 2x means it doubled |
| Buyers and bought | Wallets that bought through the link in its seven days, and the ZRO they spent |
| Earned | What the router paid you for those buys |
| Caller sold | Whether 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.
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
| What | Rule |
|---|---|
| Tag | 2 to 5 letters or digits, shown in capitals. One clan per tag |
| Name | 2 to 32 letters, digits, spaces, dots, dashes or underscores |
| Picture | An https link of at most 300 characters, or none |
| Members | At most 50, the owner included |
| Your clans | One at a time. Leave yours before you make or join another |
| Requests | One open at a time. Asking to join another clan replaces it |
| Owner leaves | The clan passes to the member who has been in it longest. A clan with nobody left is gone |
| Owner's powers | Change 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:
| Figure | What it counts |
|---|---|
| Profit | Realised profit from selling, by average cost, the same way as the traders' leaderboard. The default order |
| Volume | ZRO traded in the window, and in the last 24 hours |
| Holdings | What the members hold now, at today's prices |
| Members | How 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.
Submarine call
Wallet: <address, lowercase>
Token: <coin address, lowercase>
Note: <note, or (none)>
Time: <unix seconds>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.