# Stopy procentowe (historyczne)

**API:** Data API

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

**Tags:** Financial Data

Stopa polityki pieniężnej jednego banku centralnego w czasie, jako tablica `interest_rates` z `bank`, `name`, `date` i `rate`. `bank` jest wymagane i ograniczone przez `start_date` i `end_date`. Pułapka, o której warto wiedzieć: kod rozróżnia wielkość liter i musi być pisany wielkimi literami — FED działa, fed zwraca HTTP 404 z komunikatem „No data found”, co wygląda jak pusty wynik, a nie błędny argument. Prawidłowe kody to FED, ECB, BOJ, BOE, BOC, RBA, PBOC, SNB, RBI i BOK; `get_financial_macro_interest_rates_snapshot` bez argumentów wyświetla je wszystkie.

### Cennik referencyjny

- Rozliczanie: stała podstawa kosztu za udane żądanie.
- Szacunek referencyjny dla żądania: USD 0.02.
- Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

## 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 | yes | string | Kod banku centralnego, np. FED, ECB, BOJ. Użyj endpointu /macro/interest-rates/banks, aby pobrać listę dostępnych banków. |
| `cursor` | query | no | string | Nieprzezroczysty kursor paginacji z next_page_url poprzedniej odpowiedzi. Po jego podaniu wszystkie pozostałe parametry zapytania są ignorowane: kursor przenosi filtry pierwotnego żądania. Traktuj go jako nieprzezroczysty; nie konstruuj go ani nie modyfikuj. |
| `end_date` | query | no | string | Ostatnia data do zwrócenia włącznie, w formacie YYYY-MM-DD. Domyślnie dzisiaj. |
| `start_date` | query | no | string | Pierwsza data do zwrócenia włącznie, w formacie YYYY-MM-DD. Gdy obie daty są pominięte, domyślnie pięć lat przed end_date; pomiń ją wraz z end_date, aby uzyskać całą dostępną historię do tej daty. |

## Responses

### 200 — Odpowiedź ze stopami procentowymi

Headers:
- `X-Request-Id` (string) — Identyfikator żądania do podania podczas kontaktu z pomocą techniczną Felo.

**application/json**

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

### 400 — Nie można przetworzyć żądania. Sprawdź parametry żądania.

### 401 — Wymagany jest prawidłowy klucz API Felo.

### 402 — Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

### 403 — Konto nie ma uprawnień do wykonania tej operacji.

### 429 — Osiągnięto limit żądań lub wydatków.

### 502 — Usługa nie mogła ukończyć żądania.

### 503 — API lub usługa rozliczeniowa jest tymczasowo niedostępna.

### 504 — Upłynął limit czasu usługi podczas przetwarzania żądania.

### default — Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseE40Feb4D3D6B_InterestRate

`#/components/schemas/ResponseE40Feb4D3D6B_InterestRate`

```json
{
  "type": "object",
  "properties": {
    "bank": {
      "type": "string",
      "description": "Symbol banku centralnego."
    },
    "name": {
      "type": "string",
      "description": "Nazwa banku centralnego."
    },
    "rate": {
      "type": "number",
      "description": "Stopa polityki pieniężnej w procentach w tym dniu. Dla Rezerwy Federalnej — środek przedziału docelowego."
    },
    "date": {
      "type": "string",
      "description": "Dzień kalendarzowy obowiązywania stopy, w formacie YYYY-MM-DD."
    }
  }
}
```

### 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": "Tylko historia. Bezwzględny adres URL następnej strony wyników. Obecny tylko wtedy, gdy pozostały dalsze wiersze; aby kontynuować, wyślij żądanie pod ten adres bez zmian. Każda strona zawiera do 10 wierszy."
    }
  }
}
```
