Webhooks
Subscribe a ticker set to an event type and NQ pushes a signed JSON payload to your HTTPS endpoint when it fires. Create and manage subscriptions in the dashboard → Integration; this page is the reference for what fires and what you receive.
Event types
Eight events. Each subscription is one event type × a ticker list × optional filters.
News event watchlist.news_event
New labeled news on a subscribed ticker.
| Filter | Type | Range | Required | Notes |
|---|---|---|---|---|
event | select | all-news, analyst, upgrades, downgrades, initiations, maintains, pt_raises, pt_cuts | — | default: all-news |
datatickerdateeventproviderheadlinereaction_5min_pctreaction_eod_pctnews_key (fund)
Analyst action watchlist.analyst_action
Upgrade / downgrade / PT change by an analyst on a subscribed ticker.
| Filter | Type | Range | Required | Notes |
|---|---|---|---|---|
actions | multiselect | upgrades, downgrades, initiations, maintains, pt_raises, pt_cuts | — | default: all actions |
datatickerdatefirmactionraw_actionproviderheadlinereaction_5min_pctnews_key (fund)
Volume surge alert.volume_surge
RVOL (current vol / 20-day avg) crosses your threshold.
| Filter | Type | Range | Required | Notes |
|---|---|---|---|---|
rvol_threshold | number | 1–1000 | yes | — |
datatickerdatervolthreshold
Big move alert.big_move
Absolute price reaction at a horizon crosses your % threshold.
| Filter | Type | Range | Required | Notes |
|---|---|---|---|---|
min_abs_move_pct | number | 0.5–100 | yes | — |
horizons | multiselect | 5min, eod | — | default: both |
direction | select | up, down, any | — | default: any |
datatickerdateeventproviderheadlinehorizonmove_pctthreshold_pctnews_key (fund)
Earnings release watchlist.earnings_release
Earnings announcement (EPS) on a subscribed ticker.
datatickerdateproviderheadlinereaction_5min_pctreaction_eod_pctnews_key (fund)
Price-target change watchlist.price_target_change
Analyst price-target revision on a subscribed ticker.
| Filter | Type | Range | Required | Notes |
|---|---|---|---|---|
min_pt_change_pct | number | 0–1000 | — | default: any change |
datatickerdatefirmpt_frompt_topct_changereaction_5min_pctnews_key (fund)
Unusual block alert.unusual_block
Self-baselined block-RVOL crosses your threshold.
| Filter | Type | Range | Required | Notes |
|---|---|---|---|---|
min_block_rvol | number | 1–1000 | yes | — |
datatickerdateblock_rvolnet_pressure_pctflagthreshold
Consensus shift watchlist.consensus_shift
Aggregate buy/hold/sell consensus label flips for a subscribed ticker.
datatickerdatefromtocounts
Payload
Every delivery is a Standard Webhooks v1 envelope — id, type, created_at, and a data object whose fields depend on the event (listed above). news_key provenance is fund-tier only.
{
"id": "9f2c41ab-...",
"type": "alert.big_move",
"created_at": "2026-06-22T13:45:02Z",
"data": {
"ticker": "AAPL",
"date": "2026-06-22",
"horizon": "5min",
"move_pct": 2.6,
"threshold_pct": 2,
"headline": "Apple raises quarterly dividend"
}
}Verify the signature
Each request carries a webhook-signature header — v1,<base64 HMAC-SHA256> computed over webhook-id.webhook-timestamp.body using your whsec_… signing secret (shown once when the subscription is created). Recompute it and compare in constant time before trusting the payload — the Standard Webhooks libraries do this for you.
Delivery & lifecycle
- Targets must be public
https://URLs (no localhost,.local/.internal, or literal IPs). - Ticker caps per subscription scale by tier: free 5 · pro 50 · fund 500.
- Verification ping on create — your endpoint must return 2xx to a signed ping, or the subscription starts paused.
- Retries with backoff on failure; after repeated consecutive failures a subscription is auto-disabled.
- Manage in the dashboard: create, edit, pause/activate, send a test, browse delivery history, delete.