debtstack-ai/debtstack-python

**Corporate credit data for AI agents.**
Why DebtStack?
Equity data is everywhere. Credit data isn't.
There's no "Yahoo Finance for bonds." Corporate debt structures, guarantor chains, and covenant details are buried in SEC filings—scattered across 10-Ks, 8-Ks, credit agreements, and indentures. An AI agent trying to answer "which telecom companies have leverage above 5x?" would need to read dozens of filings, extract the right numbers, and compute ratios manually.
**DebtStack fixes this.** We extract, normalize, and serve corporate credit data through an API built for AI agents.
Three Things You Can't Do Elsewhere
**1. Cross-Company Credit Queries**
Screen ~300 companies by leverage, coverage ratios, or maturity risk in one call. No filing-by-filing analysis.
**2. Pre-Built Entity Relationships**
Guarantor chains, parent-subsidiary hierarchies, structural subordination—mapped and queryable. This data exists nowhere else in machine-readable form.
**3. Agent-Ready Speed**
AI agents chain multiple calls. If each took 30 seconds (reading a filing), a portfolio analysis would take hours. DebtStack returns in milliseconds.
---
Installation
For LangChain integration:
Quick Start
Synchronous Usage
What's In The Data
| Coverage | Count |
|----------|-------|
| Companies | ~300 (S&P 100 + NASDAQ 100 + high-yield issuers) |
| Entities | ~39,000 (subsidiaries, holdcos, JVs, VIEs) |
| Debt Instruments | ~10,000 (bonds, loans, revolvers) with 96% document linkage |
| Bond Pricing | ~4,300 bonds with FINRA TRACE pricing (updated 3x daily) |
| SEC Filing Sections | ~25,000 (searchable full-text) |
| Covenants | ~1,800 structured covenant records |
**Pre-computed metrics:** Leverage ratios, interest coverage, maturity profiles, structural subordination scores.
**Relationships:** Guarantor chains, issuer-entity links, parent-subsidiary hierarchies.
API Methods
| Method | What It Does |
|--------|--------------|
| search_companies() | Screen by leverage, sector, coverage, risk flags |
| search_bonds() | Filter by yield, spread, seniority, maturity |
| resolve_bond() | Look up CUSIP, ISIN, or "RIG 8% 2027" |
| traverse_entities() | Follow guarantor chains, map corporate structure |
| search_pricing() | FINRA TRACE bond prices, YTM, spreads |
| search_documents() | Full-text search across credit agreements, indentures |
| batch() | Run multiple queries in parallel |
| get_changes() | Track debt structure changes over time |
Examples
Which MAG7 company has the most debt?
Find high-yield bonds trading at a discount
Who guarantees a specific bond?
Search for covenant language
LangChain Integration
Build AI agents that can autonomously analyze corporate credit data.
Installation
Available Tools
| Tool | Description |
|------|-------------|
| debtstack_search_companies | Screen companies by leverage, sector, coverage ratios, and risk flags |
| debtstack_search_bonds | Filter bonds by yield, spread, seniority, maturity, and pricing |
| debtstack_resolve_bond | Look up bonds by CUSIP, ISIN, or description (e.g., "RIG 8% 2027") |
| debtstack_traverse_entities | Follow guarantor chains, map corporate structure, trace ownership |
| debtstack_search_pricing | Get FINRA TRACE bond prices, YTM, and spreads |