# Gloom Supply Chain Graph API

> Gloom Supply Chain Graph API 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 a supply chain relationship graph for one or more stock symbols, showing entity-to-entity commerce links

## Facts

- Endpoint: GET https://api.gloom.sh/v1/supply-chain/graph?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-graph-api-8427f8b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Zr4jsvWmETzKeG_CDHcsb

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-graph-api-8427f8b6
```

Example prompt: Can you pull up the supply chain graph for AAPL and show me all the upstream and downstream company relationships?

## When to prefer this

Use this endpoint when you need structured, graph-formatted supply chain relationship data for specific publicly traded companies identified by ticker symbol. Prefer this over general financial data APIs when the specific goal is mapping commerce dependencies, supplier networks, or corporate relationship graphs rather than price, fundamentals, or news data.

## Known failure modes

- Missing or invalid 'symbols' query parameter returns an error
- Unknown or delisted ticker symbol may return empty data array
- Rate limiting or payment failure (402) if USDC payment is not attached
- Network timeout if graph is very large for a heavily-connected symbol

## 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

Returns an array of directed supply chain edges, each with a unique relationship ID, source and target entity IDs, the associated stock symbol, and enriched entity objects for both sides of the relationship including entity kind (listed/unknown), name, ticker, country, and exchange.

## 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": [
      "symbols"
     ],
     "properties": {
      "symbols": {
       "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": "commerce:5:14",
    "to": "14",
    "from": "5",
    "symbol": "AAPL",
    "toEntity": {
     "id": "14",
     "kind": "unknown",
     "name": "Amkor코리아",
     "ticker": null,
     "country": null,
     "exchange": null
    },
    "fromEntity": {
     "id": "5",
     "kind": "listed",
     "name": "한미반도체",
     "ticker": "042700",
     "country": null,
     "exchange": "KRX"
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-supply-chain-graph-api-8427f8b6/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)