Docs · For traders
Alerts and the Telegram bot
Alerts in the browser
| Alert | When it fires |
|---|---|
| Market cap | A token goes above or below a cap you set. It fires once and is then removed |
| Your orders | An order of yours fills, in full or in part |
| Followed wallets | A wallet you follow trades. A notification while the tab is in the background, and a card on screen, up to 3 at once for 8 seconds each |
Add a market cap alert with the bell by a token's name. Beside the level you type, it offers one-click alerts at -50%, -25%, -10%, +10%, +25%, +50% and +100% from the market cap now. Portfolio, under Alerts, lists every alert and how they reach you. The tab title shows how many you haven't seen yet. Followed wallets' trades also show as cards with a button to do the same, wherever you are in Submarine.
Alerts on the chart
Every alert on a token is drawn on its chart as a level. Right-click the chart at any height to set an alert there: above the price it fires when the market cap rises to it, below when it falls to it.
Sound and notifications
- Sound is on by default: two short tones.
- System notifications are off by default. Turned on, they appear only while the tab is hidden, after your browser asks for permission.
- Followed wallets alerts are off by default.
- A card on the page: an alert that fires while the page is in front shows as a card in the top right corner. On by default. A click opens the token.
The Telegram bot
Send the bot commands from any Telegram chat, alone or in a group. It watches the chain itself and writes to you whatever Submarine's tabs are doing. There is nothing to link: a chat's settings belong to that chat.
A quick start
/watch 0xWallet Whalesends you every trade that wallet makes, named Whale./alert 0xToken above 50ktells you once the token's market cap passes 50,000 dollars./orders 0xYourWallettells you when your orders fill.
When two or more wallets you watch buy the same token within 60 seconds, the bot sends one message saying they bought together.
Every command
| Command | What it does |
|---|---|
/start | Shows the help |
/help | Shows the help |
/watch <wallet> [name] | Alerts on every trade by that wallet. A name can be up to 32 characters |
/unwatch <wallet> | Stops watching it |
/watching | Lists the wallets you watch |
/alert <token> above|below <cap> | Alerts once when its market cap in dollars crosses the level. Write 50000, 50k, 1.2m or 2b |
/alerts | Lists your market cap alerts, numbered |
/unalert <n> | Removes alert number n |
/orders <wallet> | Alerts when that wallet's orders fill |
/orders | Lists the wallets whose orders you follow |
/unorders <wallet> | Stops order alerts for it |
Limits
| What | Limit |
|---|---|
| Commands | 20 a minute per chat. Past that, the bot warns once and ignores the rest for the minute |
| Watched wallets | 100 per chat |
| Market cap alerts | 50 per chat |
| Wallets for order alerts | 20 per chat |
| Messages | At most one a second per chat, with several alerts merged into one message. At most 200 waiting per chat |
| Old trades | A trade older than 10 minutes is not sent |