# Interest Rates (Real-Time)

**API:** Data API

**Endpoint:** `GET /v1/beta/financial/macro/interest-rates/snapshot`

**Tags:** Financial Data

Return the latest central-bank interest-rate snapshot. The optional bank code is case-sensitive, for example FED, ECB or BOJ. Omit bank to request all supported banks. Lowercase bank codes can return HTTP 404.

### Pricing reference

- Metering: Fixed successful-request cost basis.
- Reference request estimate: USD 0.02.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.

Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `bank` | query | no | string | Optional uppercase central-bank code, such as FED, ECB or BOJ. Omit to request all supported banks. |

## Responses

### 200 — Interest rates snapshot response

Headers:
- `X-Request-Id` (string) — Request identifier to include when contacting Felo support.

**application/json**

Schema: `ResponseE40Feb4D3D6B_InterestRatesResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_InterestRatesResponse`)

### 400 — The request could not be processed. Check the request parameters.

### 401 — A valid Felo API key is required.

### 402 — The request cannot proceed because a billing requirement is not met.

### 403 — The account is not permitted to perform this operation.

### 429 — A request or spending limit has been reached.

### 502 — The service could not complete the request.

### 503 — The API or billing service is temporarily unavailable.

### 504 — The service timed out while processing the request.

### default — Error response; upstream passthrough responses may use provider formats

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseE40Feb4D3D6B_InterestRate

`#/components/schemas/ResponseE40Feb4D3D6B_InterestRate`

```json
{
  "type": "object",
  "properties": {
    "bank": {
      "type": "string",
      "description": "The symbol of the central bank."
    },
    "name": {
      "type": "string",
      "description": "The name of the central bank."
    },
    "rate": {
      "type": "number",
      "description": "The policy rate in percent on that day. For the Federal Reserve, the midpoint of the target range."
    },
    "date": {
      "type": "string",
      "description": "The calendar day the rate is in effect, in YYYY-MM-DD format."
    }
  }
}
```

### ResponseE40Feb4D3D6B_InterestRatesResponse

`#/components/schemas/ResponseE40Feb4D3D6B_InterestRatesResponse`

```json
{
  "type": "object",
  "properties": {
    "interest_rates": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_InterestRate"
      }
    },
    "next_page_url": {
      "type": "string",
      "description": "History only. Absolute URL of the next page of results. Present only when more rows remain; request it as-is to continue. Each page holds up to 10 rows."
    }
  }
}
```