# שערי ריבית (היסטוריים)

**API:** Data API

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

**Tags:** Financial Data

שיעור ריבית המדיניות של בנק מרכזי אחד לאורך זמן, כמערך `interest_rates` של `bank`, `name`, `date` ו-`rate`. `bank` חובה ומוגבל ב-`start_date` ו-`end_date`. מלכודת שכדאי להכיר: הקוד תלוי רישיות וחייב להיות באותיות גדולות — FED עובד, fed מחזיר HTTP 404 עם "No data found", מה שנקרא כמו תוצאה ריקה ולא כמו ארגומנט שגוי. הקודים התקפים הם FED, ECB, BOJ, BOE, BOC, RBA, PBOC, SNB, RBI ו-BOK; `get_financial_macro_interest_rates_snapshot` ללא ארגומנטים מציג את כולם.



### מראה תמחור

- מדידה: בסיס עלות קבוע לבקשה מוצלחת.
- אומדן בקשת ייחוס: 0.02 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.

זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של 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 | קוד הבנק המרכזי, למשל FED, ECB, BOJ. השתמשו בנקודת הקצה /macro/interest-rates/banks כדי לקבל את רשימת הבנקים הזמינים. |
| `cursor` | query | no | string | סמן עימוד אטום מ-next_page_url של תגובה קודמת. כשמסופק, כל פרמטרי השאילתה האחרים מתעלמים: הסמן נושא את המסננים של הבקשה המקורית. התייחסו אליו כאטום; אל תיצרו או תשנו אותו. |
| `end_date` | query | no | string | התאריך האחרון להחזרה, כולל, בפורמט YYYY-MM-DD. ברירת המחדל היא היום. |
| `start_date` | query | no | string | התאריך הראשון להחזרה, כולל, בפורמט YYYY-MM-DD. ברירת המחדל היא חמש שנים לפני end_date כששני התאריכים מושמטים; השמיטו אותו עם end_date כדי לקבל את כל ההיסטוריה הזמינה עד אותו תאריך. |

## Responses

### 200 — תגובת שערי ריבית

Headers:
- `X-Request-Id` (string) — מזהה בקשה לכלול בעת פנייה לתמיכת Felo.

**application/json**

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

### 400 — לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.

### 401 — נדרש מפתח API תקף של Felo.

### 402 — לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.

### 403 — החשבון אינו מורשה לבצע את הפעולה הזו.

### 429 — הגעתם למגבלת בקשות או לתקרת הוצאה.

### 502 — השירות לא הצליח להשלים את הבקשה.

### 503 — שירות ה-API או החיוב אינו זמין באופן זמני.

### 504 — השירות פג בזמן הטיפול בבקשה.

### default — תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseE40Feb4D3D6B_InterestRate

`#/components/schemas/ResponseE40Feb4D3D6B_InterestRate`

```json
{
  "type": "object",
  "properties": {
    "bank": {
      "type": "string",
      "description": "הסימול של הבנק המרכזי."
    },
    "name": {
      "type": "string",
      "description": "השם של הבנק המרכזי."
    },
    "rate": {
      "type": "number",
      "description": "שיעור ריבית המדיניות באחוזים באותו יום. עבור הפדרל ריזרב, נקודת האמצע של טווח היעד."
    },
    "date": {
      "type": "string",
      "description": "היום הקלנדרי שבו הריבית בתוקף, בפורמט 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": "היסטוריה בלבד. כתובת URL מוחלטת של העמוד הבא של התוצאות. קיימת רק כאשר נותרו שורות נוספות; יש לבקש אותה כפי שהיא כדי להמשיך. כל עמוד מכיל עד 10 שורות."
    }
  }
}
```
