# Gloom Supply Chain Relationships

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

Returns supply chain relationships (customer/supplier roles, counterparties, and direction) for one or more stock symbols based on company filings.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/supply-chain/relationships?utm_source=zero.xyz
- Price: $0.24/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-relationships-7fa43f8d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xkXdYmooXL14E4ZLloeFt

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-relationships-7fa43f8d
```

Example prompt: Can you pull up the supply chain relationships for AAPL and NVDA — I want to see who their key suppliers and customers are based on filing disclosures?

## When to prefer this

Choose this endpoint when you need structured, filing-sourced supply chain relationship data for publicly traded companies — especially for equity research, supply chain risk analysis, or building company relationship graphs. It is distinct from news-based or manually curated supply chain tools because it derives relationships from formal company filings. Best when you need machine-readable counterparty data including exchange and country metadata.

## Known failure modes

- Missing or invalid 'symbols' query parameter returns an error
- Unknown or delisted ticker returns empty data array
- Non-public or non-filing entity may have no relationships in the database
- Rate limiting or payment failure (x402) if USDC balance is insufficient
- Counterparty data may be incomplete (null ticker, country, or exchange) for private companies

## 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 supply chain relationship objects, each containing: the role of the reporting entity (customer or supplier), the queried symbol, the direction of the relationship (in/out), a relationship statement verb, the counterparty's name, kind, ticker, country, and exchange, plus the reporting entity's own ID, name, ticker, and exchange. Data is sourced from company filings and may include both listed and unlisted counterparties.

## 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": [
   {
    "role": "customer",
    "symbol": "AAPL",
    "direction": "out",
    "statement": "says",
    "counterparty": {
     "id": "6",
     "kind": "unknown",
     "name": "AmKor",
     "ticker": null,
     "country": null,
     "exchange": null
    },
    "reportingEntity": {
     "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-relationships-7fa43f8d/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)