# Gloom Bonds Data API

> Gloom Bonds Data API is a paid API for AI agents from api.gloom.sh, paid per call via x402, $0.12/call, status unknown (last checked 2026-11-01).

Fetches bond metadata for one or more ticker symbols, including CUSIP, coupon, maturity, callability, and issuer details.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/bonds?utm_source=zero.xyz
- Price: $0.12/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-bonds-data-api-46def211
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RyLPw0CWsI-4kR3TB7zOH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gloom-bonds-data-api-46def211
```

Example prompt: Can you pull the bond details for AAPL and MSFT — I need the CUSIP, coupon rate, maturity date, and whether they're callable?

## When to prefer this

Use this endpoint when you need structured bond metadata (CUSIP, coupon, maturity, callability, convertibility) keyed to equity ticker symbols rather than CUSIP directly. It is well suited for fixed income research workflows that start from a stock ticker. Prefer this over general financial data APIs when you specifically need bond-level corporate debt details tied to well-known equity symbols, at low per-call cost via x402 micropayment.

## Known failure modes

- Missing or invalid 'symbols' query parameter returns an error
- Unknown ticker symbol may return an empty data array
- Some bond fields (grade, coupon, maturity, callable) may be null if data is unavailable for the issuer
- Network or payment authorization failure (402) if x402 payment is not processed
- Rate limiting or authentication errors if payment is insufficient

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

Returns an array of bond records per requested symbol, each containing CUSIP identifier, issuer name, coupon rate, coupon type, maturity date, callable flag, next call date, convertible flag, and credit grade. Fields may be null if not available for the given bond.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "cusip": "037833DK3",
    "grade": null,
    "coupon": null,
    "symbol": "AAPL",
    "callable": null,
    "maturity": null,
    "couponType": null,
    "issuerName": "APPLE INC",
    "convertible": null,
    "nextCallDate": null
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-bonds-data-api-46def211/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gloom.sh](https://www.zero.xyz/host/api.gloom.sh/llms.txt)