Alerts
Create a price or smart-money alert - 0 credits
stalkchain_alert_create · free · Checked about every 5 minutes; fires once.
Ask: "Tell me if BONK drops below $0.00002."
Set up an alert that notifies the user once, by email or their own webhook (Discord, Slack or Telegram bot URL), when a token crosses a price or when several tracked traders buy it. Kinds: price_above / price_below (needs priceUsd), smart_money_buy (fires when at least minTraders tracked traders, default 2, buy the token within a few minutes). Needs the token's address: resolve a ticker first with stalkchain_fomo_search or stalkchain_token_prices_multichain. Chains: solana, ethereum, base, bsc. Alerts fire once and then switch off; checked about every 5 minutes; up to 20 active per account. Confirm the token, threshold and delivery with the user before calling. Returns the alert and the token's current price, so you can tell the user how far away the threshold is.
| Input | Type | Required | Description |
|---|---|---|---|
kind | price_above | price_below | smart_money_buy | yes | |
token | string | yes | Token address (mint on Solana, 0x… on EVM) |
chain | solana | ethereum | base | bsc | no | Default solana, or ethereum for 0x addresses |
priceUsd | number | no | Threshold in USD, for price_above / price_below |
minTraders | integer | no | smart_money_buy: how many tracked traders must buy. Default 2 |
channel | email | webhook | no | email (the account's address, default) or webhook |
webhookUrl | string | no | https Discord, Slack or Telegram bot webhook URL, when channel is webhook |
note | string | no | A short reminder of why the user set it |
REST: POST /api/v1/tools/stalkchain_alert_create with the inputs as a JSON body, or GET /api/v1/tools/stalkchain_alert_create?….
List your alerts - 0 credits
stalkchain_alert_list · free
Ask: "What alerts do I have?"
The user's alerts: what each watches, how it notifies, whether it is still active or has fired (and when, and why). Use before deleting, or when the user asks what alerts they have.
No inputs.
REST: POST /api/v1/tools/stalkchain_alert_list with the inputs as a JSON body, or GET /api/v1/tools/stalkchain_alert_list?….
Delete an alert - 0 credits
stalkchain_alert_delete · free
Ask: "Delete my BONK alert."
Switch off and delete one of the user's alerts by id (from stalkchain_alert_list). Confirm which alert with the user first.
| Input | Type | Required | Description |
|---|---|---|---|
id | string | yes |
REST: POST /api/v1/tools/stalkchain_alert_delete with the inputs as a JSON body, or GET /api/v1/tools/stalkchain_alert_delete?….