Financial Data
Company fundamentals, financial statements, market prices and economic data.
نرخ‌های بهره (تاریخی)
نرخ سیاست یک بانک مرکزی در طول زمان، به‌صورت آرایه interest_rates از bank، name، date و rate. bank الزامی است و با start_date و end_date محدود می‌شود. تله‌ای که ارزش دانستن دارد: کد به بزرگی و کوچکی حروف حساس است و باید بزرگ باشد — FED کار می‌کند، fed با پیام "No data found" و HTTP 404 برمی‌گردد که مانند نتیجه خالی خوانده می‌شود نه آرگومان اشتباه. کدهای معتبر FED، ECB، BOJ، BOE، BOC، RBA، PBOC، SNB، RBI و BOK هستند؛ get_financial_macro_interest_rates_snapshot بدون آرگومان همه را فهرست می‌کند.
مرجع قیمت‌گذاری
- اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
- برآورد درخواست مرجع: 0.02 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: stringbankالزامی
کد بانک مرکزی، مثلاً FED، ECB، BOJ. برای دریافت فهرست بانک‌های موجود از نقطه پایانی /macro/interest-rates/banks استفاده کنید.
- نوع: stringcursor
نشانگر صفحه‌بندی مبهم از next_page_url یک پاسخ قبلی. در صورت ارائه، همه پارامترهای دیگر کوئری نادیده گرفته می‌شوند: نشانگر فیلترهای درخواست اصلی را حمل می‌کند. آن را مبهم در نظر بگیرید؛ آن را نسازید یا تغییر ندهید.
- نوع: stringend
_date آخرین تاریخ برای برگرداندن، شامل، به قالب YYYY-MM-DD. پیش‌فرض امروز است.
- نوع: stringstart
_date اولین تاریخ برای برگرداندن، شامل، به قالب YYYY-MM-DD. وقتی هر دو تاریخ حذف شوند، پیش‌فرض پنج سال قبل از end_date است؛ برای دریافت تمام تاریخچه موجود تا آن تاریخ، آن را همراه با end_date حذف کنید.
- نوع: object · ResponseE40Feb4D3D6B_InterestRatesResponse200
پاسخ نرخ‌های بهره
- نوع: array object[] · ResponseE40Feb4D3D6B_InterestRate[]interest
_rates - bankنوع: string
نماد بانک مرکزی.
- dateنوع: string
روز تقویمی که نرخ در آن اعمال است، به قالب YYYY-MM-DD.
- nameنوع: string
نام بانک مرکزی.
- rateنوع: number
نرخ سیاست به درصد در آن روز. برای فدرال رزرو، نقطه میانی بازه هدف.
- نوع: stringnext
_page _url فقط تاریخچه. نشانی URL مطلق صفحه بعدی نتایج. فقط زمانی حاضر است که ردیف‌های بیشتری باقی مانده باشد؛ برای ادامه آن را همان‌گونه که هست درخواست کنید. هر صفحه تا 10 ردیف نگه می‌دارد.
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 402
درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.
- 403
حساب مجاز به انجام این عملیات نیست.
- 429
به سقف درخواست یا هزینه رسیده‌اید.
- 502
سرویس نتوانست درخواست را کامل کند.
- 503
سرویس API یا صورت‌حساب موقتاً در دسترس نیست.
- 504
سرویس هنگام پردازش درخواست به پایان مهلت رسید.
- default
پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/macro/interest-rates?bank=' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"interest_rates": [
{
"bank": "string",
"name": "string",
"rate": 1,
"date": "string"
}
],
"next_page_url": "string"
}