# Gloom Supply Chain Paths

> Gloom Supply Chain Paths is a paid API for AI agents from api.gloom.sh, paid per call via x402, $3/call, status unknown (last checked 2026-11-01).

Returns supply chain relationship paths between two financial symbols, including hops, scores, and exposure data.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/supply-chain/paths?utm_source=zero.xyz
- Price: $3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-supply-chain-paths-5e5bbb68
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4kQmkPe4jLyqPgFxdFowj

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gloom-supply-chain-paths-5e5bbb68
```

Example prompt: Can you show me the supply chain paths from AAPL to TSM using Gloom — I want to see how many hops they are apart and what the confidence score looks like?

## When to prefer this

Use this endpoint when you need to discover and analyze supply chain relationships between two specific financial symbols — particularly when you want quantified metrics like hops, confidence scores, and exposure. Prefer this over general financial data APIs when supply chain connectivity and indirect dependencies between companies are the focus.

## Known failure modes

- Invalid or unrecognized fromSymbol/toSymbol returns empty data array
- No supply chain path found between the two symbols returns empty results
- Missing required queryParams (fromSymbol or toSymbol) returns a 400-level error
- Service unavailable or payment failure returns a 402 or 5xx error
- Symbols with no mapped supply chain data return low-confidence or null results

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

A list of supply chain path objects, each containing an ID indicating direction (e.g. downstream), number of hops between the two symbols, a relevance score (0–1), link IDs, node IDs traversed in the path, an exposure value, and a confidence score.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "fromSymbol",
      "toSymbol"
     ],
     "properties": {
      "toSymbol": {
       "type": "string"
      },
      "fromSymbol": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "downstream|commerce:5:6",
    "hops": 1,
    "score": 0.99,
    "linkIds": [
     "commerce:5:6"
    ],
    "nodeIds": [
     "5"
    ],
    "exposure": null,
    "confidence": 0.99
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-supply-chain-paths-5e5bbb68/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gloom.sh](https://www.zero.xyz/host/api.gloom.sh/llms.txt)