{"uid":"cap_xkXdYmooXL14E4ZLloeFt","slug":"gloom-supply-chain-relationships-7fa43f8d","name":"Gloom Supply Chain Relationships","description":"Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.","url":"https://api.gloom.sh/v1/supply-chain/relationships?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.24","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.24/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.24","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.24","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JOeLnB__L2kHeFvoJqUEq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.24","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns supply chain relationships (customer/supplier roles, counterparties, and direction) for one or more stock symbols based on company filings.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Semiconductor supply chain exposure","prompt":"Show me all the supply chain relationships for ASML and TSMC — I need to know who their customers and suppliers are, including which exchange and country they're listed on."},{"title":"Portfolio supplier risk analysis","prompt":"For my holdings in AAPL and QCOM, can you find their upstream supplier relationships so I can assess how exposed they are to any single counterparty?"},{"title":"Equity research counterparty mapping","prompt":"I'm researching Samsung's supply chain — can you pull the relationships for 005930 and tell me which companies report it as a customer or supplier in their filings?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:42.454Z","isFirstParty":false,"canonicalSlug":"gloom-supply-chain-relationships-7fa43f8d"}