Skip to main content
GET
/
v1
/
market
/
cds
CDS Spreads
curl --request GET \
  --url https://api.example.com/v1/market/cds

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

Get CDS spread time series for corporate issuers. Spreads are derived from TRACE bond pricing data using a bond spread-to-treasury methodology, economically equivalent to CDS spreads (CDS-bond basis is typically within 20 bps for investment grade).

​
Request

​
Company Filters

​
ticker
string
Filter by company ticker(s), comma-separated.Example: AAPL,MSFT
​
sector
string
Filter by sector.Example: Technology

​
CDS Filters

​
tenor
string
default:"5Y"
CDS tenor: 1Y, 3Y, 5Y, 7Y, 10Y
​
source
string
Data source filter: bond_spread_proxy, dtcc_sdr, ice_settlement

​
Date Filters

​
from_date
string
Start date (YYYY-MM-DD).
​
to_date
string
End date (YYYY-MM-DD).

​
Convenience

​
latest_only
boolean
default:"false"
Return only the most recent spread per company.

​
Response Options

​
fields
string
Comma-separated fields to return.Example: ticker,spread_date,spread_bps,trade_count
​
sort
string
default:"-spread_date"
Sort field. Prefix - for descending.
​
limit
integer
default:"50"
Results per page. Maximum 200.
​
offset
integer
default:"0"
Pagination offset.

​
Coverage

  • 111 companies with CDS spread data
  • ~53,000 records across all tenors and dates
  • 598 trading days (March 2023 to present)
  • 5 tenors: 1Y, 3Y, 5Y, 7Y, 10Y
  • Updated daily at 9:30 PM ET

​
Methodology

Spreads are computed using a bond spread-to-treasury proxy:
  1. Select fixed-rate senior unsecured bonds with TRACE pricing
  2. Group by remaining maturity into tenor buckets (1Y / 3Y / 5Y / 7Y / 10Y)
  3. Apply data quality filters (price >= $60, no estimated pricing, maturity >= 1 year)
  4. Remove outliers (3-sigma for groups >= 4 bonds, range check for smaller groups)
  5. Report median spread-to-treasury in basis points
Negative spreads are possible for premium investment grade issuers (floor: -200 bps).

​
Examples

​
Get Latest Spreads for a Company

curl "https://api.debtstack.ai/v1/market/cds?ticker=AAPL&latest_only=true" \
  -H "X-API-Key: ds_xxxxx"

​
Response

{
  "data": [
    {
      "ticker": "AAPL",
      "company_name": "Apple Inc.",
      "spread_date": "2026-03-04",
      "tenor": "5Y",
      "spread_bps": 42.5,
      "trade_count": 12,
      "bond_count": 8,
      "source": "bond_spread_proxy"
    }
  ],
  "meta": {
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

​
More Examples

​
1-Year Spread History

curl "https://api.debtstack.ai/v1/market/cds?ticker=AAPL&tenor=5Y&from_date=2025-03-01&to_date=2026-03-01" \
  -H "X-API-Key: ds_xxxxx"

​
Compare Spreads Across Companies

curl "https://api.debtstack.ai/v1/market/cds?ticker=AAPL,MSFT,GOOGL&tenor=5Y&latest_only=true" \
  -H "X-API-Key: ds_xxxxx"

​
Short-Term vs Long-Term Spread

# Compare 1Y and 10Y tenors for curve shape analysis
curl "https://api.debtstack.ai/v1/market/cds?ticker=AAL&tenor=1Y&latest_only=true" \
  -H "X-API-Key: ds_xxxxx"

curl "https://api.debtstack.ai/v1/market/cds?ticker=AAL&tenor=10Y&latest_only=true" \
  -H "X-API-Key: ds_xxxxx"