pump.fun API: callouts, livestreams, launches and graduations
Programmatic access to the pump.fun alerts in @PF_Xanguard_bot: callout (callout_new, callout_milestone), livestream (livestream_started / livestream_ended), token launch (token_launched) and graduation (graduated) events. Each alert type is a separate subscription. For bot commands & pricing, see the PumpFun Livestream Telegram guide.
Auth: Bearer token with pf_ prefix.
Authorization: Bearer pf_your_api_key_here| Method | Path | Description |
|---|---|---|
| GET | /v1/pf/targets | List watched wallets |
| POST | /v1/pf/targets | Add wallet. Body: {"wallet_address": "DYw8j...", "label": "Dev1"} |
| DELETE | /v1/pf/targets/{wallet} | Remove wallet |
| GET | /v1/pf/events | Last 50 wallet events (livestream, launch, graduation). Callouts are not included |
| GET | /v1/pf/webhook | Get saved webhook URL |
| PUT | /v1/pf/webhook | Save a webhook URL. Delivery: WebSocket today; webhook delivery coming soon |
| GET | /v1/pf/status | Subscription status |
Event Response
{
"ok": true,
"data": [
{
"wallet_address": "DYw8j...",
"mint": "9PR3c...",
"token_name": "BONK",
"token_symbol": "BONK",
"event_type": "livestream_started",
"detected_at": "2026-03-22T10:15:00Z",
"delivery_latency_ms": 450
}
]
}
WebSocket
wss://api.xanguard.tech/v1/pf/ws?api_key=pf_your_keyStreams every wallet event (livestream, launch, graduation) for your watched wallets, and callout events for callers on your /call list. Both lists are read when you connect, so reconnect after changing either. This WebSocket (and the Telegram bot) is the delivery channel; webhook delivery for PumpFun is coming soon.
Callout Events (Callouts addon)
With an active Callouts addon, the same WebSocket stream carries two extra event_type values for callers you track via /call. callout_new fires the moment a tracked caller posts a callout; callout_milestone fires when a call crosses 2x, 5x, or 10x. Callout fields are present only on these two event types; other events are unchanged.
{
"type": "pf_event",
"data": {
"event_type": "callout_new",
"mint": "9PR3c...",
"creator": "DYw8j...",
"token_name": "",
"token_symbol": "PWH",
"market_cap": 7373.0,
"detected_at": 1787825953817,
"caller_wallet": "DYw8j...",
"caller_username": "callername",
"callout_mcap": 7373.0,
"multiplier": 1.105,
"amount_held": 413883049.83,
"cost_basis_sol": 18.95,
"thesis": "feel like gambling",
"milestone": null
}
}
Milestone variant (same fields; milestone is set and multiplier is the new max):
{
"type": "pf_event",
"data": {
"event_type": "callout_milestone",
"mint": "9PR3c...",
"creator": "DYw8j...",
"token_symbol": "PWH",
"caller_wallet": "DYw8j...",
"caller_username": "callername",
"callout_mcap": 7373.0,
"multiplier": 5.2,
"milestone": "5x",
"detected_at": 1787825953817
}
}
Callout Telegram Commands
| Command | Description |
|---|---|
/call <wallet | profile URL> | Track a caller's callouts (raw Solana wallet or pump.fun/profile/<wallet> URL) |
/callout_untrack <wallet> | Stop tracking a caller |
/callouts | List your tracked callers |
Callouts, Livestream, Token Launch and Graduation are four separate subscriptions, each on the same grid: $100 / $180 / $270 / $500 per month for 3 / 6 / 10 / 20 callers or wallets, per alert type. Paid in SOL in @PF_Xanguard_bot; payments are final and non-refundable. All prices: xanguard.tech/pricing.