Whale and rug alerts by webhook or Discord
Get a signed webhook or Discord message when whales trade a Solana or Base token above your USD threshold, or when its rug-risk verdict gets worse: mint or freeze authority re-enabled, LP unlocked, liquidity pulled, holder spike.
Pro and Team subscribers can watch tokens instead of polling them. Create an alert with your tsk_ API key and we check the token in the background, then push a notification to your own HTTPS endpoint (signed with HMAC) and/or a Discord channel. It uses the same logic as whale flow and the token verdict.
Two alert types
- Whale (
"type": "whale"): new DEX trades of at leastminUsd(default $10,000) in the token's top pools. Optionalwallet(only trades sent by that wallet) andside(buy,sellorboth). New trades from one check arrive as one message. - Rug / risk (
"type": "risk"): the verdict got worse since the last check. Triggers: rating drops (SAFE to CAUTION to AVOID), safety score falls byscoreDroppoints (default 10), mint or freeze authority turned back on, permanent delegate added, contract ownership reclaimed or made upgradeable, honeypot or lost sell route, sell tax or transfer fee raised, LP locked share down 20 points, liquidity down 50%, or the largest holder up 10 points of supply (top 10 up 15).
Plans, limits and usage
- Pro ($49/month): up to 10 alerts. Whale alerts are checked every 10 minutes, risk alerts every 30.
- Team ($149/month): up to 50 alerts. Whale every 5 minutes, risk every 15.
- Checks are free. Each delivered notification uses 1 call of your monthly quota (refunded if delivery fails). At most 48 notifications per alert per day.
- The first check records a baseline, so you are not flooded with history.
Create an alert
curl -X POST https://signals.incomefather.com/alerts \
-H "Authorization: Bearer $TRADING_SIGNALS_API_KEY" \
-H 'content-type: application/json' \
-d '{"type":"whale","token":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
"minUsd":25000,"webhookUrl":"https://example.com/hooks/tsk",
"discordWebhookUrl":"https://discord.com/api/webhooks/123/abc..."}'
curl -X POST https://signals.incomefather.com/alerts \
-H "Authorization: Bearer $TRADING_SIGNALS_API_KEY" \
-H 'content-type: application/json' \
-d '{"type":"risk","token":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed","webhookUrl":"https://example.com/hooks/tsk"}'
The response includes the alert id and a signingSecret (shown once). Other calls:
GET /alerts # your alerts, cap and quota
GET /alerts/{id} # one alert + last 20 deliveries
POST /alerts/{id}/test # send a signed test notification (free, 5/hour)
DELETE /alerts/{id}
Webhook payload and signature
POST https://example.com/hooks/tsk
X-TSK-Event: whale.trades (or risk.worsened, alert.test)
X-TSK-Delivery: evt_… (unique per event: use it to de-dupe)
X-TSK-Signature: t=1763140000,v1=5f2c…
{"id":"evt_…","type":"whale.trades","alertId":"alr_…",
"token":{"chain":"solana","address":"DezX…B263","symbol":"Bonk"},
"data":{"count":2,"minUsd":25000,"buyUsd":61000,"sellUsd":0,
"trades":[{"time":"…","side":"buy","usd":36000,"wallet":"…","tx":"…"}]}}
Verify it by computing HMAC-SHA256(signingSecret, t + "." + rawBody) as hex and comparing it with v1; reject timestamps older than 5 minutes.
import { createHmac, timingSafeEqual } from "node:crypto";
function verify(secret, rawBody, header) {
const [, t, v1] = header.match(/^t=(\d+),v1=([0-9a-f]{64})$/) || [];
if (!t || Math.abs(Date.now() / 1000 - t) > 300) return false;
const want = createHmac("sha256", secret).update(t + "." + rawBody).digest();
return timingSafeEqual(Buffer.from(v1, "hex"), want);
}
Webhook URLs must be public https:// endpoints; redirects are not followed. After 20 failed deliveries in a row an alert is disabled. Informational only, not investment advice.
No Pro or Team plan yet? See plans, or poll /crypto/whale-flow and the token verdict routes yourself with any key. A shorter overview of tracking large Solana buys and sells, including this alerts API, is in Solana whale alerts.
More guides
- ES futures session brief API
- SEC insider buying API
- AI trade brief API for agents
- Solana token safety check API
- Crypto whale flow API for Base and Solana tokens
- OFAC sanctions screening API for crypto addresses and names
- Wallet pay-readiness API for Base and Solana
- SEC 13F holdings API for fund portfolios and notable holders
- Token pre-trade check API for Solana and Base
- CFTC COT positioning screener API
- Treasury auction and yields API
- x402 pay-per-call market data
- Add x402 payments to your API
- Is this token a rug? A 30-second Solana or Base check
- How to check if a Solana token is a rug
- Mint authority and freeze authority on Solana
- LP lock and liquidity burn
- Holder concentration, snipers and bundles
- How to check a Base token for a honeypot
- Solana whale alerts: track big buys and sells on any token