Testnet on Base Sepolia: 1 ZRO here is 0.0001 test ETH.
Docs · Alerts and the Telegram bot

Docs · For traders

Alerts and the Telegram bot

Submarine can tell you when a token crosses a market cap, when your orders fill, and when wallets you follow trade. In the browser that works while a tab is open. The Telegram bot does the same with every tab closed.

Alerts in the browser

AlertWhen it fires
Market capA token goes above or below a cap you set. It fires once and is then removed
Your ordersAn order of yours fills, in full or in part
Followed walletsA 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 Whale sends you every trade that wallet makes, named Whale.
  • /alert 0xToken above 50k tells you once the token's market cap passes 50,000 dollars.
  • /orders 0xYourWallet tells 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

CommandWhat it does
/startShows the help
/helpShows 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
/watchingLists 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
/alertsLists your market cap alerts, numbered
/unalert <n>Removes alert number n
/orders <wallet>Alerts when that wallet's orders fill
/ordersLists the wallets whose orders you follow
/unorders <wallet>Stops order alerts for it

Limits

WhatLimit
Commands20 a minute per chat. Past that, the bot warns once and ignores the rest for the minute
Watched wallets100 per chat
Market cap alerts50 per chat
Wallets for order alerts20 per chat
MessagesAt most one a second per chat, with several alerts merged into one message. At most 200 waiting per chat
Old tradesA trade older than 10 minutes is not sent
Dollar levels move with ZRO. Market caps on the chain are in ZRO. The bot converts them at the ZRO price, refreshed every minute, so a dollar alert can fire when ZRO moves even if the token doesn't.