Developer

API Documentation

Integrate News-to-Risk signals into your trading systems, dashboards, and workflows.

REST APIWebhooksJSON responses

Authentication

Authenticated endpoints require an API key passed via the X-API-Key header.

curl -H "X-API-Key: your-api-key" https://newsrisk.tech/signals

API keys are issued during onboarding. Default rate limit: 60 requests/minute per API key.

Endpoints

GET/signalsAuth

List recent risk signals. Returns newest first.

Parameters

limitintdefault: 50— Max signals to return (1-500)

Example

curl -H "X-API-Key: your-api-key" https://newsrisk.tech/signals?limit=10

[{
  "signal_id": "gdelt-abc123",
  "ticker": "NVDA",
  "entity": "NVIDIA Corp",
  "event_type": "SupplyChain",
  "severity": "high",
  "confidence": 0.85,
  "timestamp_utc": "2026-03-14T02:12:30Z",
  "summary": "NVIDIA supply chain disruption reported...",
  "sources": ["https://reuters.com/..."],
  "verification_status": "verified",
  "source_match_score": 0.92
}]

GET/signals/client-safeAuth

Filtered signals meeting quality gates. Only verified signals with sufficient confidence and sources.

Parameters

limitintdefault: 50— Max signals (1-500)

min_confidencefloatdefault: 0.65— Minimum confidence threshold

min_sourcesintdefault: 1— Minimum source count

Example

curl -H "X-API-Key: your-api-key" https://newsrisk.tech/signals/client-safe?min_confidence=0.80

# Same schema as /signals, filtered to quality gates

GET/digest/dailyAuth

Daily digest summary of top signals.

Parameters

limitintdefault: 10— Signals in digest

Example

curl -H "X-API-Key: your-api-key" https://newsrisk.tech/digest/daily

{
  "generated_at": "2026-03-14T12:00:00Z",
  "count": 10,
  "items": [{ "ticker": "NVDA", "event_type": "SupplyChain", "severity": "high", ... }]
}

GET/kpiAuth

Pipeline health metrics — publish rates, latency, source health.

Example

curl -H "X-API-Key: your-api-key" https://newsrisk.tech/kpi

{
  "publishability": { "strict": { "rate": 0.03, "count": 8 }, "adaptive": { "rate": 0.93, "count": 250 } },
  "latency": { "seconds_avg": 340, "seconds_p50": 280, "seconds_p95": 1200 },
  "ingest_stats": { "source_success": { "gdelt": 45, "google_rss": 120 }, ... }
}

GET/health

Service health check. Always public.

Example

curl https://newsrisk.tech/health

{ "ok": true, "service": "news-risk-feed", "utc": "2026-03-14T02:08:45Z" }

POST/webhooks/registerAuth

Parameters

urlstring— Your webhook endpoint URL

secretstring— HMAC-SHA256 signing secret

Example

curl -X POST -H "X-API-Key: your-api-key" -H "Content-Type: application/json" \
  -d '{"url":"https://your-app.com/webhook","secret":"your_signing_secret"}' \
  https://newsrisk.tech/webhooks/register

{ "ok": true, "client": "your-client", "registered_at": "2026-03-14T02:12:30Z" }

POST/signals/outcomesAuth

Record an outcome label for a signal. Used to close the feedback loop and improve scoring over time.

Parameters

signal_idstring— The signal to label

outcomestring— acted | ignored | useful | noise

analyst_notesstring— Optional notes

Example

curl -X POST -H "X-API-Key: your-api-key" -H "Content-Type: application/json" \
  -d '{"signal_id":"gdelt-abc123","outcome":"acted","analyst_notes":"Triggered position review"}' \
  https://newsrisk.tech/signals/outcomes

{ "ok": true, "signal_id": "gdelt-abc123", "outcome": "acted" }

Webhook Delivery

Professional and Enterprise tiers support webhook delivery. Signals are pushed to your endpoint as they pass quality gates.

POST https://your-webhook.com/signals
Content-Type: application/json
X-NTR-Signature: sha256=...

{
  "event": "signal.new",
  "signal": { "signal_id": "...", "ticker": "NVDA", ... }
}

Try it yourself

Copy any example above and test it directly in your terminal with curl. The /health endpoint is public.

curl https://newsrisk.tech/health | python3 -m json.tool

Need an API key or custom integration?

Request API Access

Endpoints

GET/signalsAuth

List recent risk signals. Returns newest first.

Parameters

limitintdefault: 50— Max signals to return (1-500)

Example

curl -H "X-API-Key: your-api-key" https://newsrisk.tech/signals?limit=10

[{
  "signal_id": "gdelt-abc123",
  "ticker": "NVDA",
  "entity": "NVIDIA Corp",
  "event_type": "SupplyChain",
  "severity": "high",
  "confidence": 0.85,
  "timestamp_utc": "2026-03-14T02:12:30Z",
  "summary": "NVIDIA supply chain disruption reported...",
  "sources": ["https://reuters.com/..."],
  "verification_status": "verified",
  "source_match_score": 0.92
}]

GET/signals/client-safeAuth

Filtered signals meeting quality gates. Only verified signals with sufficient confidence and sources.

Parameters

limitintdefault: 50— Max signals (1-500)

min_confidencefloatdefault: 0.65— Minimum confidence threshold

min_sourcesintdefault: 1— Minimum source count

Example

curl -H "X-API-Key: your-api-key" https://newsrisk.tech/signals/client-safe?min_confidence=0.80

# Same schema as /signals, filtered to quality gates

GET/digest/dailyAuth

Daily digest summary of top signals.

Parameters

limitintdefault: 10— Signals in digest

Example

curl -H "X-API-Key: your-api-key" https://newsrisk.tech/digest/daily

{
  "generated_at": "2026-03-14T12:00:00Z",
  "count": 10,
  "items": [{ "ticker": "NVDA", "event_type": "SupplyChain", "severity": "high", ... }]
}

GET/kpiAuth

Pipeline health metrics — publish rates, latency, source health.

Example

curl -H "X-API-Key: your-api-key" https://newsrisk.tech/kpi

{
  "publishability": { "strict": { "rate": 0.03, "count": 8 }, "adaptive": { "rate": 0.93, "count": 250 } },
  "latency": { "seconds_avg": 340, "seconds_p50": 280, "seconds_p95": 1200 },
  "ingest_stats": { "source_success": { "gdelt": 45, "google_rss": 120 }, ... }
}

GET/health

Service health check. Always public.

Example

curl https://newsrisk.tech/health

{ "ok": true, "service": "news-risk-feed", "utc": "2026-03-14T02:08:45Z" }

POST/webhooks/registerAuth

Parameters

urlstring— Your webhook endpoint URL

secretstring— HMAC-SHA256 signing secret

Example

curl -X POST -H "X-API-Key: your-api-key" -H "Content-Type: application/json" \
  -d '{"url":"https://your-app.com/webhook","secret":"your_signing_secret"}' \
  https://newsrisk.tech/webhooks/register

{ "ok": true, "client": "your-client", "registered_at": "2026-03-14T02:12:30Z" }

POST/signals/outcomesAuth

Record an outcome label for a signal. Used to close the feedback loop and improve scoring over time.

Parameters

signal_idstring— The signal to label

outcomestring— acted | ignored | useful | noise

analyst_notesstring— Optional notes

Example

curl -X POST -H "X-API-Key: your-api-key" -H "Content-Type: application/json" \
  -d '{"signal_id":"gdelt-abc123","outcome":"acted","analyst_notes":"Triggered position review"}' \
  https://newsrisk.tech/signals/outcomes

{ "ok": true, "signal_id": "gdelt-abc123", "outcome": "acted" }

Webhook Delivery

Professional and Enterprise tiers support webhook delivery. Signals are pushed to your endpoint as they pass quality gates.

POST https://your-webhook.com/signals
Content-Type: application/json
X-NTR-Signature: sha256=...

{
  "event": "signal.new",
  "signal": { "signal_id": "...", "ticker": "NVDA", ... }
}