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
MethodPathDescription
GET/v1/pf/targetsList watched wallets
POST/v1/pf/targetsAdd wallet. Body: {"wallet_address": "DYw8j...", "label": "Dev1"}
DELETE/v1/pf/targets/{wallet}Remove wallet
GET/v1/pf/eventsLast 50 wallet events (livestream, launch, graduation). Callouts are not included
GET/v1/pf/webhookGet saved webhook URL
PUT/v1/pf/webhookSave a webhook URL. Delivery: WebSocket today; webhook delivery coming soon
GET/v1/pf/statusSubscription 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_key

Streams 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

CommandDescription
/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
/calloutsList 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.