An audit trail, not just an answer.

ForcedAlpha maps public equities down to their physical dependencies — materials, factories, processes, chokepoints — and maps physical constraints back up to exposed equities.

Every edge in the graph carries a source URL and verbatim quote from the regulatory filing, earnings call, or government database that proves the relationship exists. When you call the API, you get the finding and its provenance. Your analyst, your compliance team, and your AI agent can all verify the same primary source.

No SDK required. No install. Just curl.

Authentication

All requests require an API key passed in the X-API-Key header.

curl https://forcedalpha.com/api/v1/nodes/AXTI \
  -H "X-API-Key: fa_your_key_here"

Quickstart

AXTI (AXT Inc.) is a $6B semiconductor substrate company. Ask the graph what breaks if it fails:

curl "https://forcedalpha.com/api/v1/intelligence/cascade/AXTI?max_depth=1" \
  -H "X-API-Key: fa_your_key_here"

{
  "data": {
    "seed_node": {
      "id": "AXTI",
      "name": "AXT Inc.",
      "severity": 4,
      "market_cap_b": 6.09
    },
    "asymmetry_ratio": 4964.3,
    "total_downstream_cap_b": 30232.45,
    "breaks": [ // companies with NO alternative supply path if AXTI fails ],
    "stresses": [ // companies with reduced but not eliminated supply ]
  },
  "meta": { "execution_ms": 81 }
}

$6B controls $30 trillion in downstream market cap. A 4,964:1 asymmetry ratio. That is the AXTI pattern.

Find all 530 companies with asymmetry ratios above 10:1:

curl "https://forcedalpha.com/api/v1/intelligence/asymmetry/?min_ratio=100&limit=10" \
  -H "X-API-Key: fa_your_key_here"

Use case: Portfolio managers

Pain: You run a 30-stock book. You don't know that 11 positions share a single upstream supplier. You find out when the supplier misses earnings.

curl "https://forcedalpha.com/api/v1/intelligence/chokepoints/?theme=AI&severity_min=4&limit=10" \
  -H "X-API-Key: fa_your_key_here"

curl "https://forcedalpha.com/api/v1/nodes/NVDA?include_edges=true" \
  -H "X-API-Key: fa_your_key_here"

Use case: AI agents

Pain: Without a verified knowledge graph, an agent asked "what is upstream of NVIDIA?" either hallucinates a supply chain or punts to the user. With the FA API, it gets structured, provenance-tagged answers it can cite.

Native MCP integration

Using Claude, Gemini, or another MCP-compatible agent? See the MCP docs for a native integration that requires no HTTP plumbing — the graph is exposed as 11 tools with full provenance on every response. Your API key works on both the REST API and the MCP server — same key, same quota.

Per-field provenance

Every edge in the graph carries the source that proves it:

{
  "from_id": "AXTI",
  "to_id": "AAPL",
  "relationship": "supplies_to",
  "product": "InP substrates",
  "confidence": 0.92,
  "evidence_type": "primary",
  "source_url": "https://www.sec.gov/Archives/edgar/data/.../axti-10k-2024.htm",
  "source_excerpt": "InP substrates are used in the production of..."
}

Your agent forwards the source_url and source_excerpt inline. No hallucination, no black box — the auditor clicks the link.

Use case: Research teams

Pain: You read DART filings in Korean, EDINET yuho in Japanese, MOPS disclosures in Mandarin. Your English-only process misses the named-supplier disclosures that only appear in the original language.

The FA graph ingests all three jurisdictions nightly. Named suppliers disclosed in Korean DART business reports, Taiwan MOPS material disclosures, and Japanese EDINET annual filings are extracted, verified, and wired into the same graph as SEC 10-K data.

curl "https://forcedalpha.com/api/v1/verify/AXTI" \
  -H "X-API-Key: fa_your_key_here"
# Returns: competitor landscape, claim confidence, sourced evidence for each edge

Endpoints

curl "https://forcedalpha.com/api/v1/nodes/AXTI?include_edges=true" \
  -H "X-API-Key: fa_..."

curl "https://forcedalpha.com/api/v1/intelligence/cascade/AXTI?max_depth=2" \
  -H "X-API-Key: fa_..."
# Params: max_depth (1-5), scenario (current|full_embargo|us_only)

curl "https://forcedalpha.com/api/v1/intelligence/asymmetry/?min_ratio=100&theme=AI&limit=20" \
  -H "X-API-Key: fa_..."
# Params: min_ratio, max_cap_b, theme, severity_min, limit

curl "https://forcedalpha.com/api/v1/intelligence/chokepoints/?theme=AI&severity_min=4" \
  -H "X-API-Key: fa_..."
# Params: severity_min (1-5), theme, country, limit

curl "https://forcedalpha.com/api/v1/nodes/search?q=indium+phosphide&theme=AI" \
  -H "X-API-Key: fa_..."

Response format

All responses follow the same envelope:

{
  "data": { /* endpoint-specific payload */ },
  "meta": {
    "request_id": "c90b8554",
    "execution_ms": 81,
    "timestamp": "2026-06-17T06:49:00Z"
  },
  "partial_failures": [
    { "field": "source_excerpt", "reason": "legacy_unverified" }
  ]
}

Node object

{
  "id": "AXTI",
  "name": "AXT Inc.",
  "type": "company",
  "country": "US",
  "severity": 4,
  "market_cap_b": 6.09,
  "themes": ["AI", "DEFENSE"],
  "verification": {
    "status": "VERIFIED",
    "last_verified": "2026-06-01"
  }
}

Severity scale

Rate limits

What this API does not do

Questions? [email protected] — we respond same day.