Search Bonds

curl --request GET \
  --url https://api.debtstack.ai/v1/bonds

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.debtstack.ai/v1/bonds",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.debtstack.ai/v1/bonds"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.debtstack.ai/v1/bonds")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

GET

bonds

Search Bonds

curl --request GET \
  --url https://api.debtstack.ai/v1/bonds

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.debtstack.ai/v1/bonds",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.debtstack.ai/v1/bonds"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.debtstack.ai/v1/bonds")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

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

string

Comma-separated list of company tickers.Example: RIG,VAL,DO

string

Filter by company sector.Example: Energy

Bond Identifiers

string

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

Structure Filters

string

Seniority level: senior_secured, senior_unsecured, subordinated

string

Security type: first_lien, second_lien, unsecured

string

Instrument type: senior_notes, term_loan_b, revolver, etc.

string

Issuer entity type: holdco, opco, subsidiary

string

Interest rate type: fixed, floating

Interest Rate Filters

number

Minimum coupon rate (%).

number

Maximum coupon rate (%).

Pricing Filters

number

Minimum yield to maturity (%).

number

Maximum yield to maturity (%).

integer

Minimum spread to treasury (bps).

integer

Maximum spread to treasury (bps).

boolean

Only return bonds with pricing data.

Maturity Filters

string

Maturity before date (YYYY-MM-DD).

string

Maturity after date (YYYY-MM-DD).

Other Filters

integer

Minimum outstanding amount (cents).

boolean

Only return bonds with guarantors.

string

default:"USD"

Currency code.

Response Options

string

Comma-separated fields to return.Example: name,cusip,coupon_rate,maturity_date,pricing

string

Sort field. Prefix - for descending.Example: -pricing.ytm

integer

default:"50"

Results per page. Maximum 100.

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"

import requests

response = requests.get(
    "https://api.debtstack.ai/v1/bonds",
    params={
        "seniority": "senior_unsecured",
        "min_ytm": 8.0,
        "has_pricing": True,
        "fields": "name,cusip,company_ticker,coupon_rate,maturity_date,pricing",
        "sort": "-pricing.ytm"
    },
    headers={"X-API-Key": "ds_xxxxx"}
)

for bond in response.json()["data"]:
    print(f"{bond['company_ticker']} {bond['name']}: {bond['pricing']['ytm']:.2f}% YTM")

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"

Overview

Companies

Bonds

Financials

Collateral

Entities

Documents

Covenants

Ratings

Market Data

Batch

Search Bonds

Overview

Request

Company Filters

Bond Identifiers

Structure Filters

Interest Rate Filters

Pricing Filters

Maturity Filters

Other Filters

Response Options

Examples

High-Yield Bond Screen

Response

More Examples

Secured First-Lien Bonds

Company’s Maturity Profile

Floating Rate Debt

Bonds with Guarantees

​Overview

​Request

​Company Filters

​Bond Identifiers

​Structure Filters

​Interest Rate Filters

​Pricing Filters

​Maturity Filters

​Other Filters

​Response Options

​Examples

​High-Yield Bond Screen

​Response

​More Examples

​Secured First-Lien Bonds

​Company’s Maturity Profile

​Floating Rate Debt

​Bonds with Guarantees

Overview

Request

Company Filters

Bond Identifiers

Structure Filters

Interest Rate Filters

Pricing Filters

Maturity Filters

Other Filters

Response Options

Examples

High-Yield Bond Screen

Response

More Examples

Secured First-Lien Bonds

Company’s Maturity Profile

Floating Rate Debt

Bonds with Guarantees