How often is the risk score data updated?

Risk scores are updated daily. WARN Act notices are scraped each morning from the 47 states and DC that publish them. SEC EDGAR 8-K filings are pulled from the EDGAR submissions API. Bankruptcy data is pulled from PACER RSS feeds and SEC EDGAR Item 1.03. H-1B and LCA data is updated quarterly when DOL publishes new disclosure files. The /api/market-pulse endpoint returns the freshest snapshot of all six datasets in a single call.

What API key tier do I need to access risk signals?

Every tier can read the Risk Signal teaser: company, states and a coarse signal level. The full Risk Signal API — composite scores, all five distress indexes and the per-company drilldown at /api/risk-signal/company/{name} — requires an Investor plan ($499/mo) or an Enterprise agreement. Free gives 25 calls/day, Starter ($49/mo) 200 calls/day, Professional ($199/mo) 1,000 calls/day across all six datasets live. Sign up for a free key at warnfirehose.com/getting-started.

Home › API Docs › Risk Signal API

Risk Signal API

Q: How is the risk score calculated?

The risk score is a weighted composite of five proprietary signals: WARN Weight (recency and volume of layoff filings), SEC Cross-Reference (8-K restructuring filings in the last 90 days), Bankruptcy Correlation (active Chapter 11 proceedings matched to the company), H-1B/LCA Trend (changes in visa hiring relative to WARN activity), and Industry Context (sector-wide distress patterns from the Industry Domino Index). Scores range from 0 to 100, with scores above 60 indicating significant multi-dataset convergence.

Q: Can I get bulk risk scores for a list of companies?

Yes. The bulk endpoint GET /api/risk-signal accepts limit and min_score query parameters and returns risk signals for the highest-scoring companies in the database. Investor and Enterprise API keys receive the full ranked list with composite scores and the per-dataset breakdown. Free, Starter and Professional keys receive a five-row teaser (company, states and signal level, without scores). For larger bulk exports, the /api/export/csv and /api/export/parquet endpoints are available on paid plans.

Programmatic access to corporate distress scores for 50,000+ companies via REST API. 5 proprietary indexes. 6 cross-referenced federal datasets. Daily updates.

For funds: Hedge fund annual contract → · Short-seller signals →

50K+

Companies Scored

Proprietary Signals

Federal Datasets

Daily

Score Updates

0–100

Score Range

Endpoints

GET /api/risk-signal/company/{name} Per-company distress score with full signal breakdown

Request

GET /api/risk-signal/company/Amazon
Host: warnfirehose.com
X-API-Key: wf_your_key_here

Response

{
  "company": "Amazon",
  "score": 6,
  "level": "Elevated",
  "factors": [
    "High WARN volume",
    "Recent layoff (90d)",
    "SEC 8-K on file"
  ],
  "notice_count": 5,
  "employees_affected": 2800,
  "latest_notice": "2026-04-13",
  "states": "CA,WA,TX",
  "sec_filings": 3,
  "bankruptcy_filings": 0,
  "lca_petitions": 12450,
  "lca_avg_wage": 145000,
  "lca_top_roles": [...],
  "h1b": { "approvals": 890, "denials": 12 }
}
// score is 0-10+. Levels: Low (0-1), Moderate (2-3), Elevated (4-6), Critical (7+).

GET /api/risk-signal Bulk scores — filter by min_score, limit

Request

GET /api/risk-signal?limit=50&min_score=60
Host: warnfirehose.com
X-API-Key: wf_your_key_here

Response

[
  {
    "company": "Acme Corp",
    "score": 8,
    "level": "Critical",
    "factors": [...],
    "notice_count": 3,
    "employees_affected": 1240,
    "latest_notice": "2026-04-10",
    "states": "CA,TX"
  },
  ...
]
// Top-level array, newest / highest-score first.

GET /api/market-pulse Single-call snapshot across all 6 datasets with trend direction

Request

GET /api/market-pulse
Host: warnfirehose.com
X-API-Key: wf_your_key_here

Response

{
  "trend": "rising",
  "last_30d_notices": 312,
  "last_30d_employees": 48200,
  "top_industry_90d": "Technology",
  "at_risk_companies": 87,
  "sec_filings_30d": 24,
  "bankruptcies_30d": 9
}

Full API reference with all 90+ endpoints →

Scoring Methodology

Each risk score is a weighted composite of five independent signals derived from six federal datasets. A score above 60 means multiple datasets are converging on the same company simultaneously.

WARN

WARN Weight35%

Volume of recent WARN notices, employee headcount, and recency decay. Notices in the last 90 days weighted 3x.

SEC

SEC Cross-Reference25%

8-K Item 2.05 restructuring filings matched by company name or ticker. Coincident with WARN = strong amplifier.

Bankruptcy Correlation20%

Active Chapter 11 proceedings matched from PACER RSS, SEC EDGAR Item 1.03, and FJC historical records.

H1B

H-1B / LCA Trend12%

Declining visa petition volume or flagged H-1B-dependent status while WARN notices are active signals workforce restructuring.

IDX

Industry Context8%

Industry Domino Index: sector-wide layoff cascade patterns from the Industry Domino and WARN Velocity indexes amplify individual company scores.

Scores are algorithmic estimates based on public government data. They are not investment advice or legal determinations. Explore live signals →

Integration Examples

Drop risk scores into your research pipeline in under 5 minutes. Authenticate with your API key in the X-API-Key header.

The examples below return composite score and factors fields on an Investor or Enterprise key. On Free, Starter and Professional keys the same calls return the teaser shape — company, states and level — and the per-company drilldown returns 403.

# pip install requests
import requests

API_KEY = "wf_your_key_here"
BASE_URL = "https://warnfirehose.com"

headers = {"X-API-Key": API_KEY}

# Per-company risk score
resp = requests.get(
    f"{BASE_URL}/api/risk-signal/company/Tesla",
    headers=headers
)
data = resp.json()
print(f"Risk Score: {data['score']} ({data['level']})")
print(f"Factors: {', '.join(data['factors'])}")

# Bulk: top 50 companies with score >= 4 (Elevated+)
bulk = requests.get(
    f"{BASE_URL}/api/risk-signal",
    params={"limit": 50, "min_score": 4},
    headers=headers
)
# Response is a top-level JSON array
for company in bulk.json():
    print(f"{company['company']}: {company['score']} ({company['level']})")

// Per-company risk score
const API_KEY = 'wf_your_key_here';

async function getRiskScore(company) {
  const resp = await fetch(
    `https://warnfirehose.com/api/risk-signal/company/${encodeURIComponent(company)}`,
    { headers: { 'X-API-Key': API_KEY } }
  );
  const data = await resp.json();
  console.log(`Score: ${data.score} (${data.level})`);
  console.log(`Factors: ${data.factors.join(', ')}`);
  return data;
}

// Bulk: highest risk companies. Returns a top-level array.
async function getBulkSignals(minScore = 4) {
  const resp = await fetch(
    `https://warnfirehose.com/api/risk-signal?min_score=${minScore}&limit=50`,
    { headers: { 'X-API-Key': API_KEY } }
  );
  return resp.json(); // Array<{company, score, level, factors, ...}>
}

getRiskScore('Tesla');

# Per-company risk score
curl -s \
  -H "X-API-Key: wf_your_key_here" \
  "https://warnfirehose.com/api/risk-signal/company/Tesla" \
  | python3 -m json.tool

# Bulk: top 50 companies, score >= 60
curl -s \
  -H "X-API-Key: wf_your_key_here" \
  "https://warnfirehose.com/api/risk-signal?limit=50&min_score=60" \
  | python3 -m json.tool

# Market pulse snapshot
curl -s \
  -H "X-API-Key: wf_your_key_here" \
  "https://warnfirehose.com/api/market-pulse"

Pricing

Start free. Upgrade when you need all six datasets and full signal depth.

Free

$0 / month

25 API calls / day
All 6 datasets on a 7-day delay
Risk Signal teaser — company, states, level
JSON responses
Live same-day data
Composite scores & 5 distress indexes
Company drilldown endpoint
Exports
Webhook alerts

Get Free Key →

Professional

$199 / month

1,000 API calls / day
All 6 datasets, live same-day
Full history, 500 records / call
SEC 8-K, bankruptcy & H-1B/LCA data
JSON / CSV / Parquet exports
Webhook alerts
Risk Signal teaser — company, states, level
Composite scores & 5 distress indexes
Company drilldown endpoint

Start Professional →

Investor

$499 / month

Full Risk Signal API — all 5 distress indexes
Composite scores + per-dataset breakdown
Company drilldown — /api/risk-signal/company/{name}
Everything in Professional
5,000 API calls / day, 1,000 records / call
MCP access for AI agents
Company watchlist (100 companies)
Real-time webhook alerts

Get Investor Access →

Enterprise

Custom pricing

Custom rate limits
All 6 datasets
Full risk score (all 5 signals)
Webhook alerts on custom criteria
Bulk data delivery (S3 / SFTP)
Dedicated SLA discussion
Priority support
Marketplace delivery (AWS Data Exchange) once the listing is live — in progress

Contact Sales →

FAQ

What does the Risk Signal API return? ▼

The Risk Signal API returns a composite distress score (0–100) per company, along with the individual signals that contributed to that score: WARN Act layoff notices, SEC 8-K restructuring filings, bankruptcy court records, H-1B and LCA visa petition trends, and industry-level context. The per-company endpoint also returns raw counts (notices, employees affected, SEC filings, bankruptcy filings, LCA/H-1B petitions) and a list of triggered signal flags such as warn_velocity_high or sec_restructuring.

How is the risk score calculated? ▼

The score is a weighted composite of five independent signals: WARN Weight (35%), SEC Cross-Reference (25%), Bankruptcy Correlation (20%), H-1B/LCA Trend (12%), and Industry Context (8%). Scores above 60 indicate significant multi-dataset convergence. See the scoring methodology section above for full detail.

How often is risk score data updated? ▼

Risk scores are recomputed daily. WARN Act notices are scraped each morning from the 47 states and DC that publish them. SEC EDGAR 8-K filings are pulled from the EDGAR submissions API. Bankruptcy data is refreshed via PACER RSS feeds. H-1B and LCA data updates quarterly when the DOL publishes new disclosure files.

Can I get bulk risk scores for a list of companies? ▼

Yes. The bulk endpoint GET /api/risk-signal accepts limit and min_score query parameters and returns the highest-scoring companies. Investor and Enterprise keys receive the full ranked list with composite scores; Free, Starter and Professional keys receive a five-row teaser without scores. For larger exports, /api/export/csv and /api/export/parquet are available on paid plans.

What API tier do I need to access risk signals? ▼

Every tier can read the Risk Signal teaser — company, states and a coarse signal level. The full Risk Signal API (composite scores, all five distress indexes, and the per-company drilldown) requires an Investor plan at $499/mo, or an Enterprise agreement. Free gives 25 calls/day, Starter ($49/mo) 200 calls/day, and Professional ($199/mo) 1,000 calls/day across all six datasets live. Sign up for a free key →

Ready to integrate?

Free API key in 30 seconds. No credit card required for the free tier. The full Risk Signal API is on the Investor plan, $499/mo.

Get Free API Key → View Pricing

Disclaimer: Risk scores are algorithmic estimates derived from public government data (WARN Act filings, SEC EDGAR, PACER, DOL). They are provided for informational and research purposes only and do not constitute investment advice, legal determinations, or predictions of future corporate behavior. Always conduct independent due diligence. Terms of Service

Related Resources