Financial Data
Company fundamentals, financial statements, market prices and economic 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.
- النوع: 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"
}