# Gloom CDS Curves API

> Gloom CDS Curves 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).

Retrieves credit default swap (CDS) curve data including spreads, settlement dates, and maturity information for a given issuer

## Facts

- Endpoint: GET https://api.gloom.sh/v1/cds/curves?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-cds-curves-api-5c395c86
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x9eK_Dou4oc0jYypB0O9J

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-cds-curves-api-5c395c86
```

Example prompt: Pull the CDS curve data for Oracle Corporation from Gloom so I can see the current spread in basis points and settlement details.

## When to prefer this

Use this endpoint when you need structured CDS curve data (spreads in basis points, maturities, settlement dates) for a named corporate issuer, particularly within a finance terminal or quant workflow. Prefer this over generic bond data APIs when you specifically need credit default swap spread curves with settlement and maturity breakdowns. Best suited for fixed income analysts, credit risk teams, and automated portfolio monitoring agents that need per-issuer CDS data at low cost.

## Known failure modes

- Missing or invalid 'issuer' query parameter returns an error
- Unknown issuer name returns an empty data array
- Network or payment failure (x402) prevents data retrieval
- Issuer name spelling mismatch results in no data returned
- Rate limiting or payment rejection for USDC micropayment

## 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 CDS curve data points for the requested issuer, each containing: settlement date, curve kind (e.g. 'settlement'), issuer name, number of prints, coupon in basis points (nullable), maturity date, reported flag, spread in basis points (e.g. 240.3), observed timestamp (nullable), and published timestamp.

## 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": [
      "issuer"
     ],
     "properties": {
      "issuer": {
       "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": [
   {
    "date": "2026-10-01",
    "kind": "settlement",
    "issuer": "Oracle Corporation",
    "prints": 0,
    "couponBp": null,
    "maturity": "2031-12-20",
    "reported": 0,
    "spreadBp": 240.3,
    "observedAt": null,
    "publishedAt": "2026-10-01"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-cds-curves-api-5c395c86/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)
