Tickerbot — The stock market, in SQL

GEThttps://api.tickerbot.io/v2/webhooks/{id}

Returns the current state of a webhook subscription. Visibility is account-scoped (not key-scoped) — every API key on this account can fetch every webhook on this account. Webhooks owned by a different account return 404.

Plan access

Paid plans (Hobby and above).

Cadence

Real-time on every paid plan — evaluated on every data refresh (~1×/min), so a match is delivered within seconds of it landing. Optionally throttle a webhook to hourly or at-market-open.

Capacity

Hobby 10 · Pro 100 · Scale & Enterprise unlimited.

Query parameters

idstringrequired

Webhook id returned by a subscribe endpoint (`POST /v2/tickers/{T}/subscribe`, etc.).

Status codes

200

The full webhook record (signing_secret stripped).

400

Invalid webhook id format.

404

Webhook not found, or owned by another account.

curl "https://api.tickerbot.io/v2/webhooks/wh_smRsF3-z36o" \
  -H "Authorization: Bearer YOUR_KEY"

Try it

This endpoint requires an authenticated key. Sign in to run it from your dashboard, or get a free key. tickerbot.io/dashboard.

Sample response

{
  "as_of": "2026-05-14T11:41:01.000Z",
  "id": "wh_smRsF3-z36o",
  "name": "NVDA · gap_up AND high_volume_alert",
  "q": "ticker = 'NVDA' AND (gap_up AND high_volume_alert)",
  "universe_id": null,
  "cadence": "realtime",
  "target_url": "https://your-app.example.com/webhooks/tickerbot",
  "delivery": "webhook",
  "status": "active",
  "source": "v2",
  "subscription_origin": { "type": "ticker", "ref": "NVDA", "condition": "gap_up AND high_volume_alert" },
  "created_at": 1778720416,
  "updated_at": 1778720500,
  "last_match_set": ["NVDA"],
  "last_evaluated_at": 1778721240,
  "next_eval_at": 1778721540,
  "last_fired": 1778721240
}