# شرح سود (تاریخی)

**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` بغیر کسی دلیل کے وہ سب فہرست کرتا ہے۔

### قیمت کا حوالہ

- میٹرنگ: کامیاب درخواست کی مقررہ لاگت کی بنیاد۔
- حوالہ جاتی درخواست کا تخمینہ: USD 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 endpoint استعمال کریں۔ |
| `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 — درست Felo API کلید درکار ہے۔

### 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 قطاریں تک ہوتی ہیں۔"
    }
  }
}
```
