Skip to main content
GET
/
v1
/
bonds
Search Bonds
curl --request GET \
  --url https://api.debtstack.ai/v1/bonds

Documentation Index

Fetch the complete documentation index at: https://docs.debtstack.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Search and filter bonds across all companies by yield, seniority, maturity, and more. Perfect for yield hunting, bond screening, and credit analysis.

​
Request

​
Company Filters

​
ticker
string
Comma-separated list of company tickers.Example: RIG,VAL,DO
​
sector
string
Filter by company sector.Example: Energy

​
Bond Identifiers

​
cusip
string
Comma-separated list of CUSIPs.Example: 893830AK8,89157VAG8

​
Structure Filters

​
seniority
string
Seniority level: senior_secured, senior_unsecured, subordinated
​
security_type
string
Security type: first_lien, second_lien, unsecured
​
instrument_type
string
Instrument type: senior_notes, term_loan_b, revolver, etc.
​
issuer_type
string
Issuer entity type: holdco, opco, subsidiary
​
rate_type
string
Interest rate type: fixed, floating

​
Interest Rate Filters

​
min_coupon
number
Minimum coupon rate (%).
​
max_coupon
number
Maximum coupon rate (%).

​
Pricing Filters

​
min_ytm
number
Minimum yield to maturity (%).
​
max_ytm
number
Maximum yield to maturity (%).
​
min_spread
integer
Minimum spread to treasury (bps).
​
max_spread
integer
Maximum spread to treasury (bps).
​
has_pricing
boolean
Only return bonds with pricing data.

​
Maturity Filters

​
maturity_before
string
Maturity before date (YYYY-MM-DD).
​
maturity_after
string
Maturity after date (YYYY-MM-DD).

​
Other Filters

​
min_outstanding
integer
Minimum outstanding amount (cents).
​
has_guarantors
boolean
Only return bonds with guarantors.
​
currency
string
default:"USD"
Currency code.

​
Response Options

​
fields
string
Comma-separated fields to return.Example: name,cusip,coupon_rate,maturity_date,pricing
​
sort
string
Sort field. Prefix - for descending.Example: -pricing.ytm
​
limit
integer
default:"50"
Results per page. Maximum 100.
​
offset
integer
default:"0"
Pagination offset.

​
Examples

​
High-Yield Bond Screen

curl "https://api.debtstack.ai/v1/bonds?seniority=senior_unsecured&min_ytm=8.0&has_pricing=true&fields=name,cusip,company_ticker,coupon_rate,maturity_date,pricing&sort=-pricing.ytm" \
  -H "X-API-Key: ds_xxxxx"

​
Response

{
  "data": [
    {
      "name": "8.00% Senior Notes due 2027",
      "cusip": "893830AK8",
      "company_ticker": "RIG",
      "coupon_rate": 8.0,
      "maturity_date": "2027-02-01",
      "pricing": {
        "last_price": 94.25,
        "ytm": 9.42,
        "spread": 512,
        "staleness_days": 1
      }
    },
    {
      "name": "6.875% Senior Notes due 2026",
      "cusip": "89157VAG8",
      "company_ticker": "ATUS",
      "coupon_rate": 6.875,
      "maturity_date": "2026-03-01",
      "pricing": {
        "last_price": 91.50,
        "ytm": 8.75,
        "spread": 485,
        "staleness_days": 0
      }
    }
  ],
  "meta": {
    "total": 23,
    "limit": 50,
    "offset": 0
  }
}

​
More Examples

​
Secured First-Lien Bonds

curl "https://api.debtstack.ai/v1/bonds?seniority=senior_secured&security_type=first_lien&fields=name,company_ticker,outstanding,collateral" \
  -H "X-API-Key: ds_xxxxx"

​
Company’s Maturity Profile

curl "https://api.debtstack.ai/v1/bonds?ticker=CHTR&sort=maturity_date&fields=name,maturity_date,outstanding,seniority" \
  -H "X-API-Key: ds_xxxxx"

​
Floating Rate Debt

curl "https://api.debtstack.ai/v1/bonds?rate_type=floating&fields=name,company_ticker,benchmark,spread_bps,floor_bps" \
  -H "X-API-Key: ds_xxxxx"

​
Bonds with Guarantees

curl "https://api.debtstack.ai/v1/bonds?has_guarantors=true&fields=name,company_ticker,seniority,guarantor_count" \
  -H "X-API-Key: ds_xxxxx"