Financial Data
Company fundamentals, financial statements, market prices and economic data.
جستجوی معیارهای مالی مشخص
اقلام خطی مالی نام‌دار را در یک یا چند شرکت با یک فراخوانی بکشید. بدنه tickers و line_items (هر دو الزامی، هر دو آرایه) و همچنین period (annual، quarterly یا ttm) و limit را می‌گیرد. search_results را با یک ردیف برای هر ticker و دوره برمی‌گرداند که فقط فیلدهای درخواستی را دارد، در کنار report_period، period و currency. از آن برای ساختن جدول مقایسه بدون کشیدن سه صورت کامل برای هر شرکت استفاده کنید. نام اقلام همان نام فیلدهایی است که ابزارهای صورت برمی‌گردانند، پس اگر مطمئن نیستید اول آنجا جستجو کنید. برای همه چیز درباره یک شرکت از get_financial_financials استفاده کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
- برآورد درخواست مرجع: 0.02 دلار آمریکا.
- ضریب مشتری مرجع: 1.0. آن را دوباره روی مبلغ تسویه‌شده مشتری اعمال نکنید.
فقط فراداده مرجع، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: array string[] 1…line
_items الزامیآرایهای از آیتم‌های خطی برای اعمال روی جستجو.
- نوع: array string[] 1…tickersالزامی
آرایه‌ای از تیکرها برای اعمال روی جستجو.
- نوع: integerlimitحداقل:1
حداکثر تعداد نتایج برای برگرداندن.
- نوع: string فهرست مقادیرperiod
بازه زمانی داده‌های مالی.
مقادیر- annual
- quarterly
- ttm
- نوع: object · ResponseE40Feb4D3D6B_FinancialsSearchResponse200
پاسخ جستجوی موفق
- نوع: array object[]search
_results - currencyنوع: string
واحد پول داده‌های مالی.
- periodنوع: string فهرست مقادیر
بازه زمانی داده‌های مالی.
مقادیر- annual
- quarterly
- ttm
- reportنوع: string قالب: date
_period دوره گزارش داده‌های مالی.
- tickerنوع: string
نماد تیکر شرکت.
- propertyنوع: string
Name شاخص‌های مالی تکمیلی بر اساس معیارهای جستجو.
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 402
درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.
- 403
حساب مجاز به انجام این عملیات نیست.
- 429
به سقف درخواست یا هزینه رسیده‌اید.
- 502
سرویس نتوانست درخواست را کامل کند.
- 503
سرویس API یا صورت‌حساب موقتاً در دسترس نیست.
- 504
سرویس هنگام پردازش درخواست به پایان مهلت رسید.
- default
پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند
application/json
curl https://openapi.felo.ai/v1/beta/financial/financials/search/line-items \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"line_items": [
""
],
"tickers": [
""
],
"period": "ttm",
"limit": 1
}'
{
"search_results": [
{
"ticker": "string",
"report_period": "2026-10-26",
"period": "annual",
"currency": "string",
"additionalProperty": "string"
}
]
}