Felo API PlatformFelo API Platform
تمام Financial Data endpoints
v0.2.0-beta
OpenAPI 3.1.0

مالیاتی میٹرکس حاصل کریں

سرور:https://openapi.felo.ai
کلائنٹ لائبریریاں

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

Financial Data آپریشنز

مالیاتی میٹرکس حاصل کریں

​

ایک کمپنی کے وقت کے ساتھ حساب شدہ تناسب، فی مدت تقریباً 49: market_cap، enterprise_value، price_to_earnings_ratio، price_to_book_ratio، price_to_sales_ratio، enterprise_value_to_ebitda_ratio، free_cash_flow_yield، peg_ratio، gross_margin، operating_margin، net_margin، return_on_equity، return_on_assets، return_on_invested_capital، ٹرن اوور اور لیکویڈیٹی تناسب، ہر ایک report_period اور fiscal_period کے ساتھ۔ period درکار ہے؛ ticker یا cik سے شناخت کریں۔ اسے ادوار میں کسی تناسب کے رجحان کے لیے استعمال کریں۔ صرف موجودہ اقدار کے لیے get_financial_financial_metrics_snapshot ایک قطار اور کہیں چھوٹا ہے۔

قیمت کا حوالہ

  • میٹرنگ: کامیاب درخواست کی مقررہ لاگت کی بنیاد۔
  • حوالہ جاتی درخواست کا تخمینہ: USD 0.02۔
  • حوالہ جاتی صارف ملٹی پلائر: 1.0۔ تصفیہ شدہ صارف رقم پر اسے دوبارہ لاگو نہیں کریں۔

صرف حوالہ جاتی میٹا ڈیٹا، نہ کہ اکاؤنٹ کا کوٹ، ضمانت شدہ قیمت یا اخراجات کی حد۔ ریسورس کریڈٹس Felo کریڈٹس نہیں ہیں۔ حتمی چارجز Felo کے بلنگ ریکارڈز کے مطابق ہوں گے۔

کوئری پیرامیٹرز
  • cik
    قسم: string

    کمپنی کا Central Index Key (CIK)۔ ٹکر کے بجائے استعمال کیا جا سکتا ہے۔

  • cursor
    قسم: string

    پچھلے جواب کے next_page_url سے اوپیک پیجینیشن کرسر۔ فراہم کرنے پر دیگر تمام کوئری پیرامیٹرز نظر انداز کر دیے جاتے ہیں: کرسر اصل درخواست کے فلٹرز اٹھائے ہوئے ہوتا ہے۔ اسے اوپیک سمجھیں؛ اسے بنائیں یا تبدیل نہ کریں۔

  • filing_date
    قسم: string فارمیٹ: date

    YYYY-MM-DD فارمیٹ میں عین SEC فلنگ تاریخ کے مطابق فلٹر کریں۔ نامعلوم فلنگ تاریخ والی قطاریں خارج کر دی جاتی ہیں۔

  • filing_date_gt
    قسم: string فارمیٹ: date

    YYYY-MM-DD فارمیٹ میں SEC فلنگ تاریخ سے بڑی تاریخ کے مطابق فلٹر کریں۔ نامعلوم فلنگ تاریخ والی قطاریں خارج کر دی جاتی ہیں۔

  • filing_date_gte
    قسم: string فارمیٹ: date

    YYYY-MM-DD فارمیٹ میں SEC فلنگ تاریخ سے بڑی یا اس کے برابر تاریخ کے مطابق فلٹر کریں۔ نامعلوم فلنگ تاریخ والی قطاریں خارج کر دی جاتی ہیں۔

  • filing_date_lt
    قسم: string فارمیٹ: date

    YYYY-MM-DD فارمیٹ میں SEC فلنگ تاریخ سے چھوٹی تاریخ کے مطابق فلٹر کریں۔ نامعلوم فلنگ تاریخ والی قطاریں خارج کر دی جاتی ہیں۔

  • filing_date_lte
    قسم: string فارمیٹ: date

    YYYY-MM-DD فارمیٹ میں SEC فلنگ تاریخ سے چھوٹی یا اس کے برابر تاریخ کے مطابق فلٹر کریں۔ پوائنٹ-ان-ٹائم کوئریز کے لیے مفید: صرف وہ ڈیٹا واپس کرتا ہے جو دی گئی تاریخ تک عوامی طور پر فائل کیا گیا ہو۔ نامعلوم فلنگ تاریخ والی قطاریں خارج کر دی جاتی ہیں۔

  • limit
    قسم: integer

    واپس کرنے والے نتائج کی زیادہ سے زیادہ تعداد۔ یہ تمام صفحات کا مجموعہ ہے، صفحہ کا سائز نہیں: ہر صفحہ زیادہ سے زیادہ 10 ریکارڈ رکھتا ہے، جو next_page_url سے منسلک ہوتے ہیں۔

  • period
    قسم: string enum
    لازمی

    مالیاتی ڈیٹا کا زمانی دور۔

    اقدار
    • annual
    • quarterly
    • ttm
  • report_period
    قسم: string فارمیٹ: date

    YYYY-MM-DD فارمیٹ میں عین رپورٹ دور کی تاریخ کے مطابق فلٹر کریں۔

  • report_period_gt
    قسم: string فارمیٹ: date

    YYYY-MM-DD فارمیٹ میں تاریخ سے بڑے رپورٹ دور کے مطابق فلٹر کریں۔

  • report_period_gte
    قسم: string فارمیٹ: date

    YYYY-MM-DD فارمیٹ میں تاریخ سے بڑے یا اس کے برابر رپورٹ دور کے مطابق فلٹر کریں۔

  • report_period_lt
    قسم: string فارمیٹ: date

    YYYY-MM-DD فارمیٹ میں تاریخ سے چھوٹے رپورٹ دور کے مطابق فلٹر کریں۔

  • report_period_lte
    قسم: string فارمیٹ: date

    YYYY-MM-DD فارمیٹ میں تاریخ سے چھوٹے یا اس کے برابر رپورٹ دور کے مطابق فلٹر کریں۔

  • ticker
    قسم: string

    کمپنی کا ٹکر سمبل۔ اگر cik فراہم نہ کیا جائے تو درکار۔

جوابات
  • 200
    قسم: object · ResponseE40Feb4D3D6B_FinancialMetricsResponse

    کسی ٹکر کے لیے تاریخی مالیاتی میٹرکس اور تناسب

    • accession_number
      قسم: string | null

      فائلنگ کا SEC ایکسیشن نمبر۔

    • asset_turnover
      قسم: number

      آمدنی کو اوسط کل اثاثوں سے تقسیم کیا گیا۔

    • book_value_growth
      قسم: number

      بک ویلیو میں سال بہ سال نمو۔

    • book_value_per_share
      قسم: number

      شیئر ہولڈرز کی ایکویٹی کو زیر گردش حصص سے تقسیم کیا گیا۔

    • cash_ratio
      قسم: number

      نقدی اور نقدی کے مساوی کو موجودہ واجبات سے تقسیم کیا گیا۔

    • currency
      قسم: string

      وہ کرنسی جس میں مالیاتی ڈیٹا رپورٹ کیا جاتا ہے۔

    • current_ratio
      قسم: number

      موجودہ اثاثے کو موجودہ واجبات سے تقسیم کیا گیا۔

    • days_sales_outstanding
      قسم: number

      مدت کے دوران اوسط قابل وصول حسابات کو آمدنی سے تقسیم کیا گیا۔

    • debt_to_assets
      قسم: number

      کل قرض کو کل اثاثوں سے تقسیم کیا گیا۔

    • debt_to_equity
      قسم: number

      کل قرض کو شیئر ہولڈرز کی ایکویٹی سے تقسیم کیا گیا۔

    • earnings_growth
      قسم: number

      کمائی میں سال بہ سال نمو۔

    • earnings_per_share
      قسم: number

      خالص آمدنی کو وزنی اوسط زیر گردش حصص سے تقسیم کیا گیا۔

    • earnings_per_share_growth
      قسم: number

      مدت کے دوران فی حصص کمائی میں نمو۔

    • ebitda_growth
      قسم: number

      مدت کے دوران EBITDA میں نمو۔

    • enterprise_value
      قسم: number

      کمپنی کی کل قدر (مارکیٹ کیپ + قرض - نقدی)۔

    • enterprise_value_to_ebitda_ratio
      قسم: number

      انٹرپرائز ویلیو اور EBITDA کا تناسب۔

    • enterprise_value_to_revenue_ratio
      قسم: number

      انٹرپرائز ویلیو اور آمدنی کا تناسب۔

    • filing_date
      قسم: string | null فارمیٹ: date

      وہ کیلنڈر دن جب SEC نے فائلنگ قبول کی، مشرقی وقت (Eastern Time) میں (SEC کا آپریٹنگ ٹائم زون)۔ filing_datetime کا کیلنڈر دن جوڑا۔ null جب قطار سے کوئی تاریخ والی SEC فائلنگ منسلک نہ ہو۔

    • filing_datetime
      قسم: string | null فارمیٹ: date-time

      ذیلی دن کا ٹائم اسٹیمپ جو ریکارڈ کرتا ہے کہ SEC نے فائلنگ کب قبول کی، مشرقی وقت میں۔ EDGAR submissions API پر SEC کے acceptanceDateTime فیلڈ سے حاصل کیا گیا۔ filing_date کے ساتھ جوڑا بناتا ہے (اسی واقعے کی کیلنڈر دن کی درستگی)۔

    • filing_url
      قسم: string | null فارمیٹ: uri

      SEC فائلنگ کا URL۔

    • fiscal_period
      قسم: string

      مالیاتی میٹرکس کی مالی مدت۔

    • form_type
      قسم: string | null

      وہ SEC فارم جس سے یہ قطار لی گئی (10-K، 10-Q/A، 20-F، S-1، ...)۔ بالکل وہی فارم جیسا فائل کیا گیا، اس لیے ترامیم اپنا /A لاحقہ برقرار رکھتی ہیں۔ null جب period کی قدر ttm ہو: گزشتہ بارہ ماہ کی ونڈو متعدد فائلنگز پر پھیل سکتی ہے، اس لیے ہم اسے کسی ایک سے منسوب نہیں کرتے۔ quarterly قطار 10-K رکھ سکتی ہے جب چوتھی سہ ماہی مالی سال کی فائلنگ سے اخذ کی گئی ہو۔

    • free_cash_flow_growth
      قسم: number

      مدت کے دوران آزاد نقدی بہاؤ میں نمو۔

    • free_cash_flow_per_share
      قسم: number

      آزاد نقدی بہاؤ کو زیر گردش حصص سے تقسیم کیا گیا۔

    • free_cash_flow_yield
      قسم: number

      آزاد نقدی بہاؤ کی پیداوار۔

    • gross_margin
      قسم: number

      مجموعی منافع بطور آمدنی کا فیصد۔

    • interest_coverage
      قسم: number

      EBIT کو سود کے اخراجات سے تقسیم کیا گیا۔

    • inventory_turnover
      قسم: number

      فروخت شدہ اشیا کی لاگت کو اوسط انوینٹری سے تقسیم کیا گیا۔

    • net_margin
      قسم: number

      خالص آمدنی بطور آمدنی کا فیصد۔

    • next_page_url
      قسم: string

      نتائج کے اگلے صفحے کا مطلق URL۔ صرف اس وقت موجود جب مزید نتائج باقی ہوں؛ جاری رکھنے کے لیے اسے جوں کا توں درخواست کریں۔ ہر صفحے میں زیادہ سے زیادہ 10 ریکارڈز ہوتے ہیں۔

    • operating_cash_flow_ratio
      قسم: number

      آپریٹنگ نقدی بہاؤ کو موجودہ واجبات سے تقسیم کیا گیا۔

    • operating_cycle
      قسم: number

      انوینٹری ٹرن اوور + وصولیوں کا ٹرن اوور۔

    • operating_income_growth
      قسم: number

      مدت کے دوران آپریٹنگ آمدنی میں نمو۔

    • operating_margin
      قسم: number

      آپریٹنگ آمدنی بطور آمدنی کا فیصد۔

    • payout_ratio
      قسم: number

      ادا شدہ ڈیویڈنڈ بطور خالص آمدنی کا فیصد۔

    • peg_ratio
      قسم: number

      قیمت اور کمائی کی نمو کا تناسب۔

    • period
      قسم: string enum

      مالیاتی میٹرکس کی زمانی مدت۔

      اقدار
      • quarterly
      • ttm
      • annual
    • price_to_book_ratio
      قسم: number

      قیمت اور بک ویلیو کا تناسب۔

    • price_to_earnings_ratio
      قسم: number

      قیمت اور کمائی کا تناسب۔

    • price_to_sales_ratio
      قسم: number

      قیمت اور فروخت کا تناسب۔

    • quick_ratio
      قسم: number

      فوری اثاثے کو موجودہ واجبات سے تقسیم کیا گیا۔

    • receivables_turnover
      قسم: number

      آمدنی کو اوسط قابل وصول حسابات سے تقسیم کیا گیا۔

    • report_period
      قسم: string فارمیٹ: date

      مالیاتی میٹرکس کی رپورٹنگ مدت۔

    • return_on_assets
      قسم: number

      خالص آمدنی بطور کل اثاثوں کا فیصد۔

    • return_on_equity
      قسم: number

      خالص آمدنی بطور شیئر ہولڈرز کی ایکویٹی کا فیصد۔

    • return_on_invested_capital
      قسم: number

      ٹیکس کے بعد خالص آپریٹنگ منافع بطور سرمایہ کاری شدہ کیپٹل کا فیصد۔

    • revenue_growth
      قسم: number

      آمدنی میں سال بہ سال نمو۔

    • ticker
      قسم: string

      کمپنی کا ٹکر سمبل۔

    • working_capital_turnover
      قسم: number

      آمدنی کو اوسط ورکنگ کیپٹل سے تقسیم کیا گیا۔

    application/json
  • 400

    درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔

  • 401

    درست Felo API کلید درکار ہے۔

  • 402

    درخواست آگے نہیں بڑھ سکتی کیونکہ بلنگ کی شرط پوری نہیں ہوئی۔

  • 403

    اکاؤنٹ کو یہ آپریشن کرنے کی اجازت نہیں۔

  • 429

    درخواست یا اخراجات کی حد پوری ہو گئی ہے۔

  • 502

    سروس درخواست مکمل نہیں کر سکی۔

  • 503

    API یا بلنگ سروس عارضی طور پر دستیاب نہیں۔

  • 504

    درخواست پر کارروائی کے دوران سروس کا وقت ختم ہو گیا۔

  • default

    خرابی کا جواب؛ اپ اسٹریم پاس تھرو جوابات پرووائیڈر کی شکلیں استعمال کر سکتے ہیں

    application/json
Request Example for get/v1/beta/financial/financial-metrics
curl 'https://openapi.felo.ai/v1/beta/financial/financial-metrics?period=annual' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "ticker": "string",
  "report_period": "2026-10-26",
  "fiscal_period": "string",
  "period": "quarterly",
  "currency": "string",
  "accession_number": null,
  "form_type": null,
  "filing_url": null,
  "filing_date": null,
  "filing_datetime": null,
  "enterprise_value": 1,
  "price_to_earnings_ratio": 1,
  "price_to_book_ratio": 1,
  "price_to_sales_ratio": 1,
  "enterprise_value_to_ebitda_ratio": 1,
  "enterprise_value_to_revenue_ratio": 1,
  "free_cash_flow_yield": 1,
  "peg_ratio": 1,
  "gross_margin": 1,
  "operating_margin": 1,
  "net_margin": 1,
  "return_on_equity": 1,
  "return_on_assets": 1,
  "return_on_invested_capital": 1,
  "asset_turnover": 1,
  "inventory_turnover": 1,
  "receivables_turnover": 1,
  "days_sales_outstanding": 1,
  "operating_cycle": 1,
  "working_capital_turnover": 1,
  "current_ratio": 1,
  "quick_ratio": 1,
  "cash_ratio": 1,
  "operating_cash_flow_ratio": 1,
  "debt_to_equity": 1,
  "debt_to_assets": 1,
  "interest_coverage": 1,
  "revenue_growth": 1,
  "earnings_growth": 1,
  "book_value_growth": 1,
  "earnings_per_share_growth": 1,
  "free_cash_flow_growth": 1,
  "operating_income_growth": 1,
  "ebitda_growth": 1,
  "payout_ratio": 1,
  "earnings_per_share": 1,
  "book_value_per_share": 1,
  "free_cash_flow_per_share": 1,
  "next_page_url": "string"
}
Get financial metrics