# Gloom Central Bank Rates API

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

Retrieves current central bank interest rates for countries worldwide, including the instrument type, source series, and publication frequency.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/central-bank-rates?utm_source=zero.xyz
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-central-bank-rates-api-37ad2185
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JjCGmlShEGS1kKbVYpwgO

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-central-bank-rates-api-37ad2185
```

Example prompt: What are the current central bank interest rates across all countries? I want to see the rate instruments, sources, and publication frequencies — pull from Gloom's central bank rates endpoint.

## When to prefer this

Choose this endpoint when you need structured, multi-country central bank interest rate data with source attribution and instrument details — particularly when building macro dashboards, monetary policy trackers, or financial research tools. It is preferable over scraping central bank websites because it normalizes data across countries with consistent schema and sourced series IDs. Best for agents that need a quick, cheap ($0.06) lookup of benchmark rates without managing multiple upstream API integrations.

## Known failure modes

- Invalid or unsupported property filter returns empty data array
- Payment failure (402) if x402 micropayment is not provided or insufficient
- Rate limiting if too many requests are made in quick succession
- Stale data if the upstream source (e.g. FRED) has not published a new rate recently

## 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 central bank rate records, each containing country ID, rate value in percent, country label, the central bank name, the specific rate instrument (e.g. Fed funds target range), source (e.g. FRED), source series IDs, country codes, publication frequency, and any notes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "US",
    "unit": "percent",
    "label": "United States",
    "notes": [],
    "source": "fred",
    "instrument": "Fed funds target range",
    "centralBank": "Federal Reserve",
    "countryCodes": [
     "US"
    ],
    "sourceSeriesIds": [
     "DFEDTARL"
    ],
    "publicationFrequency": "daily"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-central-bank-rates-api-37ad2185/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)