How often is the risk score data updated?

Risk scores are updated daily. WARN Act notices are scraped from all 50 state websites each morning. 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.

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. Pro and Enterprise API keys can retrieve up to 200 results per call. For larger bulk exports, the /api/export/csv and /api/export/parquet endpoints are available on paid plans.

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

The free tier gives you 25 API calls per day with access to WARN-only data. The Pro tier ($199/mo) gives 1,000 calls/day with full access to all 6 datasets including risk signals, SEC filings, bankruptcy cross-reference, and H-1B/LCA data. Enterprise plans include custom rate limits, webhook alerts, and bulk data access. Sign up for a free key at warnfirehose.com/getting-started.

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

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",
  "risk_score": 42,
  "warn_notices": 5,
  "total_employees_affected": 2800,
  "sec_filings": 3,
  "bankruptcy_filings": 0,
  "lca_petitions": 12450,
  "lca_avg_wage": 145000,
  "h1b_petitions": 890,
  "signals": [
    "warn_velocity_high",
    "sec_restructuring"
  ]
}

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

{
  "count": 50,
  "results": [
    {
      "company": "Acme Corp",
      "risk_score": 78,
      "warn_notices": 3,
      "sec_filings": 2,
      "signals": [...]
    },
    ...
  ]
}

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.

# 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['risk_score']}/100")
print(f"Active Signals: {', '.join(data['signals'])}")

# Bulk: top 50 companies with score >= 60
bulk = requests.get(
    f"{BASE_URL}/api/risk-signal",
    params={"limit": 50, "min_score": 60},
    headers=headers
)
for company in bulk.json()["results"]:
    print(f"{company['company']}: {company['risk_score']}")

// 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(`Risk Score: ${data.risk_score}/100`);
  console.log(`Signals: ${data.signals.join(', ')}`);
  return data;
}

// Bulk: highest risk companies
async function getBulkSignals(minScore = 60) {
  const resp = await fetch(
    `https://warnfirehose.com/api/risk-signal?min_score=${minScore}&limit=50`,
    { headers: { 'X-API-Key': API_KEY } }
  );
  return resp.json();
}

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
WARN Act data only
Company risk score (WARN component)
JSON responses
SEC 8-K cross-reference
Bankruptcy correlation
H-1B / LCA trend signal
Bulk endpoint
Webhook alerts

Get Free Key →

Pro

$199 / month

1,000 API calls / day
All 6 datasets
Full risk score (all 5 signals)
SEC 8-K cross-reference
Bankruptcy correlation
H-1B / LCA trend signal
Bulk endpoint (up to 200)
JSON / CSV / Parquet exports
Webhook alerts

Start Pro →

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
AWS Data Exchange access

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 from all 50 state websites each morning. 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. Pro keys can retrieve up to 200 results per call. 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? ▼

The free tier gives 25 calls/day with WARN-only data. The Pro tier ($199/mo) gives 1,000 calls/day with full access to all 6 datasets including risk signals, SEC filings, bankruptcy cross-reference, and H-1B/LCA data. Enterprise plans add custom rate limits and webhook alerts. Sign up for a free key →

Ready to integrate?

Free API key in 30 seconds. No credit card required for the free tier. Full Pro access from $199/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