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 آپریشنز

ارننگز کا اسنیپ شاٹ حاصل کریں

​

ایک اسٹاک کی رپورٹ شدہ ارننگز، تخمینوں کے مقابلے میں اصل اعداد۔ ہر اندراج میں report_period، fiscal_period، filing_date، filing_url اور accession_number، revenue، estimated_revenue، revenue_surprise اور revenue_surprise_pct والا quarterly بلاک، earnings_per_share کے لیے وہی تین، نیز سال بہ سال تبدیلی کے فیلڈز ہوتے ہیں۔ یہ signals بھی واپس کرتا ہے: اپ اسٹریم کے حساب سے بنے فلیگز جیسے EPS_BEAT، ساتھ headline اور اس کے پیچھے actual / estimate / surprise_pct۔ ticker درکار ہے اور یہ واحد پیرامیٹر ہے۔ اسے اس کے لیے استعمال کریں جو کمپنی نے دراصل رپورٹ کیا۔ جو مستقبل کا اتفاق ابھی ہوا ہی نہیں اس کے لیے get_financial_analyst_estimates استعمال کریں۔

قیمت کا حوالہ

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

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

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

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

  • limit
    قسم: integer
    کم از کم:  
    1
    زیادہ سے زیادہ:  
    40

    واپس کرنے کے لیے فلنگز کے حوالے سے حالیہ ترین رپورٹ ادوار کی تعداد، (report_period DESC, filing_date ASC) کے مطابق ترتیب دی گئی۔ واپس کیے جانے والے اندراجات کی تعداد limit سے زیادہ ہو سکتی ہے جب کسی حالیہ دور میں 8-K اور 10-Q / 10-K دونوں موجود ہوں۔ 40 سے زیادہ اقدار 40 تک محدود کر دی جاتی ہیں۔ غیر مثبت یا غیر صحیح اقدار 400 واپس کرتی ہیں۔ یہ تمام صفحات کا مجموعہ ہے، صفحہ کا سائز نہیں: ہر صفحہ زیادہ سے زیادہ 10 ریکارڈ رکھتا ہے، جو next_page_url سے منسلک ہوتے ہیں۔

  • ticker
    قسم: string
    لازمی

    ٹکر سمبل (مثلاً AAPL)۔

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

    ارننگز کا جواب

    • earnings
      قسم: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]

      ٹکر کے لیے SEC فائلنگز کی فلیٹ فہرست، (report_period DESC, filing_date ASC) کے مطابق ترتیب دی گئی۔ جب limit=N ہو تو زیادہ سے زیادہ N رپورٹ ادوار کے برابر فائلنگز واپس کی جاتی ہیں؛ اندراجات کی تعداد N سے زیادہ ہو سکتی ہے جب کسی حالیہ مدت میں 8-K اور 10-Q/10-K دونوں موجود ہوں۔

      • accession_number
        قسم: string
        لازمی

        فائلنگ کی شناخت کرنے والا SEC ایکسیشن نمبر۔

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

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

      • filing_url
        قسم: string فارمیٹ: uri
        لازمی

        SEC فائلنگ کا URL۔

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

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

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

        وہ SEC فارم قسم جو اس فائلنگ کی بنیاد ہے۔

        اقدار
        • 8-K
        • 10-Q
        • 10-K
        • 20-F
      • ticker
        قسم: string
        لازمی

        درخواست کردہ ٹکر سمبل۔

      • annual
        قسم: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          قسم: number | null
        • capital_expenditure_chg
          قسم: number

          سابقہ مدت کے مقابلے میں کیپیٹل ایکسپنڈیچر میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • capital_expenditure_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں کیپیٹل ایکسپنڈیچر میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • cash_and_equivalents
          قسم: number | null
        • change_in_cash_and_equivalents
          قسم: number | null
        • earnings_per_share
          قسم: number | null
        • earnings_per_share_chg
          قسم: number

          سابقہ مدت کے مقابلے میں EPS میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • earnings_per_share_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں EPS میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • free_cash_flow
          قسم: number | null
        • free_cash_flow_chg
          قسم: number

          سابقہ مدت کے مقابلے میں آزاد کیش فلو میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • free_cash_flow_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں آزاد کیش فلو میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_margin
          قسم: number

          مجموعی مارجن بطور اعشاریہ (gross_profit / revenue)۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_margin_chg_bps
          قسم: number

          سابقہ مدت کے مقابلے میں مجموعی مارجن میں بیسس پوائنٹس میں مطلق تبدیلی (مثلاً 200.0 = مارجن 200 bps بڑھا)۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_margin_chg_pct
          قسم: number

          سابقہ مدت کے مقابلے میں مجموعی مارجن میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_margin_yoy_chg_bps
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں مجموعی مارجن میں سال بہ سال تبدیلی، بیسس پوائنٹس میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_margin_yoy_chg_pct
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں مجموعی مارجن میں سال بہ سال فیصدی تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_profit
          قسم: number | null
        • gross_profit_chg
          قسم: number

          سابقہ مدت کے مقابلے میں مجموعی منافع میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_profit_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں مجموعی منافع میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_cash_flow_from_financing
          قسم: number | null
        • net_cash_flow_from_financing_chg
          قسم: number

          سابقہ مدت کے مقابلے میں فنانسنگ سے خالص کیش فلو میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_cash_flow_from_financing_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں فنانسنگ سے خالص کیش فلو میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_cash_flow_from_investing
          قسم: number | null
        • net_cash_flow_from_investing_chg
          قسم: number

          سابقہ مدت کے مقابلے میں سرمایہ کاری سے خالص کیش فلو میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_cash_flow_from_investing_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں سرمایہ کاری سے خالص کیش فلو میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_cash_flow_from_operations
          قسم: number | null
        • net_cash_flow_from_operations_chg
          قسم: number

          سابقہ مدت کے مقابلے میں آپریشنز سے خالص کیش فلو میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_cash_flow_from_operations_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں آپریشنز سے خالص کیش فلو میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_income
          قسم: number | null
        • net_income_chg
          قسم: number

          سابقہ مدت کے مقابلے میں خالص آمدنی میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_income_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں خالص آمدنی میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_margin
          قسم: number

          خالص مارجن بطور اعشاریہ (net_income / revenue)۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_margin_chg_bps
          قسم: number

          سابقہ مدت کے مقابلے میں خالص مارجن میں بیسس پوائنٹس میں مطلق تبدیلی۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_margin_chg_pct
          قسم: number

          سابقہ مدت کے مقابلے میں خالص مارجن میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_margin_yoy_chg_bps
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں خالص مارجن میں سال بہ سال تبدیلی، بیسس پوائنٹس میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_margin_yoy_chg_pct
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں خالص مارجن میں سال بہ سال فیصدی تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_income
          قسم: number | null
        • operating_income_chg
          قسم: number

          سابقہ مدت کے مقابلے میں آپریٹنگ آمدنی میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_income_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں آپریٹنگ آمدنی میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_margin
          قسم: number

          آپریٹنگ مارجن بطور اعشاریہ (operating_income / revenue)۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_margin_chg_bps
          قسم: number

          سابقہ مدت کے مقابلے میں آپریٹنگ مارجن میں بیسس پوائنٹس میں مطلق تبدیلی۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_margin_chg_pct
          قسم: number

          سابقہ مدت کے مقابلے میں آپریٹنگ مارجن میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_margin_yoy_chg_bps
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں آپریٹنگ مارجن میں سال بہ سال تبدیلی، بیسس پوائنٹس میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_margin_yoy_chg_pct
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں آپریٹنگ مارجن میں سال بہ سال فیصدی تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • revenue
          قسم: number | null
        • revenue_chg
          قسم: number

          سابقہ مدت کے مقابلے میں آمدنی میں فیصدی تبدیلی، اعشاریہ کی صورت میں (مثلاً 0.10 = +10%)۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • revenue_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں آمدنی میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • shareholders_equity
          قسم: number | null
        • total_assets
          قسم: number | null
        • total_debt
          قسم: number | null
        • total_liabilities
          قسم: number | null
        • weighted_average_shares
          قسم: number | null
        • weighted_average_shares_diluted
          قسم: number | null
      • currency
        قسم: string

        ISO کرنسی کوڈ (مثلاً USD)۔

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

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

      • filing_window
        قسم: string | null enum

        وہ مارکیٹ سیشن جس وقت SEC نے فائلنگ قبول کی، مشرقی وقت میں جانچا گیا۔ PRE_MARKET = ہفتے کے دن 04:00–09:30 ET۔ DURING_MARKET = ہفتے کے دن 09:30–16:00 ET۔ AFTER_HOURS = ہفتے کے دن باقاعدہ ٹریڈنگ اوقات سے باہر۔ WEEKEND = ہفتہ یا اتوار۔ جب filing_datetime دستیاب نہ ہو تو null۔

        اقدار
        • PRE_MARKET
        • DURING_MARKET
        • AFTER_HOURS
        • WEEKEND
      • fiscal_period
        قسم: string

        مالی مدت کا لیبل (مثلاً 2026-Q1 یا 2025-FY)۔

      • quarterly
        قسم: object · ResponseE40Feb4D3D6B_EarningsTimeDimension
        • capital_expenditure
          قسم: number | null
        • capital_expenditure_chg
          قسم: number

          سابقہ مدت کے مقابلے میں کیپیٹل ایکسپنڈیچر میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • capital_expenditure_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں کیپیٹل ایکسپنڈیچر میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • cash_and_equivalents
          قسم: number | null
        • change_in_cash_and_equivalents
          قسم: number | null
        • earnings_per_share
          قسم: number | null
        • earnings_per_share_chg
          قسم: number

          سابقہ مدت کے مقابلے میں EPS میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • earnings_per_share_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں EPS میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • free_cash_flow
          قسم: number | null
        • free_cash_flow_chg
          قسم: number

          سابقہ مدت کے مقابلے میں آزاد کیش فلو میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • free_cash_flow_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں آزاد کیش فلو میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_margin
          قسم: number

          مجموعی مارجن بطور اعشاریہ (gross_profit / revenue)۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_margin_chg_bps
          قسم: number

          سابقہ مدت کے مقابلے میں مجموعی مارجن میں بیسس پوائنٹس میں مطلق تبدیلی (مثلاً 200.0 = مارجن 200 bps بڑھا)۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_margin_chg_pct
          قسم: number

          سابقہ مدت کے مقابلے میں مجموعی مارجن میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_margin_yoy_chg_bps
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں مجموعی مارجن میں سال بہ سال تبدیلی، بیسس پوائنٹس میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_margin_yoy_chg_pct
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں مجموعی مارجن میں سال بہ سال فیصدی تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_profit
          قسم: number | null
        • gross_profit_chg
          قسم: number

          سابقہ مدت کے مقابلے میں مجموعی منافع میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • gross_profit_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں مجموعی منافع میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_cash_flow_from_financing
          قسم: number | null
        • net_cash_flow_from_financing_chg
          قسم: number

          سابقہ مدت کے مقابلے میں فنانسنگ سے خالص کیش فلو میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_cash_flow_from_financing_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں فنانسنگ سے خالص کیش فلو میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_cash_flow_from_investing
          قسم: number | null
        • net_cash_flow_from_investing_chg
          قسم: number

          سابقہ مدت کے مقابلے میں سرمایہ کاری سے خالص کیش فلو میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_cash_flow_from_investing_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں سرمایہ کاری سے خالص کیش فلو میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_cash_flow_from_operations
          قسم: number | null
        • net_cash_flow_from_operations_chg
          قسم: number

          سابقہ مدت کے مقابلے میں آپریشنز سے خالص کیش فلو میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_cash_flow_from_operations_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں آپریشنز سے خالص کیش فلو میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_income
          قسم: number | null
        • net_income_chg
          قسم: number

          سابقہ مدت کے مقابلے میں خالص آمدنی میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_income_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں خالص آمدنی میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_margin
          قسم: number

          خالص مارجن بطور اعشاریہ (net_income / revenue)۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_margin_chg_bps
          قسم: number

          سابقہ مدت کے مقابلے میں خالص مارجن میں بیسس پوائنٹس میں مطلق تبدیلی۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_margin_chg_pct
          قسم: number

          سابقہ مدت کے مقابلے میں خالص مارجن میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_margin_yoy_chg_bps
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں خالص مارجن میں سال بہ سال تبدیلی، بیسس پوائنٹس میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • net_margin_yoy_chg_pct
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں خالص مارجن میں سال بہ سال فیصدی تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_income
          قسم: number | null
        • operating_income_chg
          قسم: number

          سابقہ مدت کے مقابلے میں آپریٹنگ آمدنی میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_income_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں آپریٹنگ آمدنی میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_margin
          قسم: number

          آپریٹنگ مارجن بطور اعشاریہ (operating_income / revenue)۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_margin_chg_bps
          قسم: number

          سابقہ مدت کے مقابلے میں آپریٹنگ مارجن میں بیسس پوائنٹس میں مطلق تبدیلی۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_margin_chg_pct
          قسم: number

          سابقہ مدت کے مقابلے میں آپریٹنگ مارجن میں فیصدی تبدیلی، اعشاریہ کی صورت میں۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_margin_yoy_chg_bps
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں آپریٹنگ مارجن میں سال بہ سال تبدیلی، بیسس پوائنٹس میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • operating_margin_yoy_chg_pct
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں آپریٹنگ مارجن میں سال بہ سال فیصدی تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • revenue
          قسم: number | null
        • revenue_chg
          قسم: number

          سابقہ مدت کے مقابلے میں آمدنی میں فیصدی تبدیلی، اعشاریہ کی صورت میں (مثلاً 0.10 = +10%)۔ سہ ماہی پے لوڈ میں ترتیب وار، سالانہ پے لوڈ میں سال بہ سال۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • revenue_yoy_chg
          قسم: number

          ایک سال پہلے کی اسی مالی سہ ماہی کے مقابلے میں آمدنی میں سال بہ سال تبدیلی، اعشاریہ کی صورت میں۔ صرف سہ ماہی پے لوڈ۔ صرف اس وقت واپس کیا جاتا ہے جب حساب ممکن ہو۔

        • shareholders_equity
          قسم: number | null
        • total_assets
          قسم: number | null
        • total_debt
          قسم: number | null
        • total_liabilities
          قسم: number | null
        • weighted_average_shares
          قسم: number | null
        • weighted_average_shares_diluted
          قسم: number | null
      • signals
        قسم: array object[] · ResponseE40Feb4D3D6B_Signal[]

        اس فائلنگ سے نکالے گئے منتخب، مارکیٹ متاثر کرنے والے بصیرت افروز نکات۔ ہر آئٹم میں پہلے سے تیار شدہ headline، ساختہ details اور importance درجہ بندی شامل ہے۔ صرف اس وقت واپس کیا جاتا ہے جب اس اندراج کے لیے کم از کم ایک سگنل فعال ہو؛ ورنہ فیلڈ شامل نہیں کیا جاتا۔ فی اندراج زیادہ سے زیادہ 8، HIGH → MEDIUM → LOW کی ترتیب میں۔

        اس فائلنگ سے اخذ کردہ مارکیٹ کو متحرک کرنے والی ایک منتخب بصیرت۔ پہلے سے تیار headline براہ راست ڈسپلے کے لیے موزوں ہے؛ details فلٹرنگ اور پروگراماتی استعمال کے لیے ساختی فیلڈز رکھتا ہے۔ سگنلز ترجیحی ترتیب میں واپس کیے جاتے ہیں (سب سے اہم پہلے)؛ type بذات خود شدت کو انکوڈ کرتا ہے (مثلاً STRONG_REVENUE_INCREASE بمقابلہ REVENUE_INCREASE)۔

        • headline
          قسم: string
          لازمی

          براہ راست ڈسپلے کے لیے موزوں، پہلے سے تیار، انسانی پڑھنے کے قابل خلاصہ۔

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

          سگنل کی قسم۔ MARGIN_EXPANSION/MARGIN_CONTRACTION: مجموعی/آپریٹنگ/خالص مارجن میں سے کوئی بھی سال بہ سال ≥100bps حرکت کرے۔ GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: فائلنگ میں رپورٹ کردہ آگے کی گائیڈنس میں تبدیلی۔ SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: نامیاتی آمدنی کی نمو کے لحاظ سے بہترین یا بدترین رپورٹ ایبل سیگمنٹ۔ NON_GAAP_DIVERGENCE: ایڈجسٹ شدہ/non-GAAP عدد اسی مدت کے اپنے GAAP ہم منصب سے نمایاں طور پر مختلف ہو۔ BACKLOG_SURGE/BACKLOG_DECLINE: بیک لاگ یا بقایا کارکردگی کی ذمہ داریاں سال بہ سال ≥20% حرکت کریں۔ REVENUE_INCREASE/STRONG_REVENUE_INCREASE اور DECLINE اقسام: درجہ بند سال بہ سال آمدنی کی تبدیلی (≥10% / ≥20% شدت)۔ NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE اور DECLINE اقسام: درجہ بند سال بہ سال خالص آمدنی کی تبدیلی (≥15% / ≥30%)۔ EPS_INCREASE/STRONG_EPS_INCREASE اور DECLINE اقسام: درجہ بند سال بہ سال EPS کی تبدیلی (≥15% / ≥30%)؛ خالص آمدنی سے آزاد کیونکہ شیئر بائی بیکس EPS کی حرکت کو بڑھا سکتے ہیں۔ CAPEX_INCREASE/STRONG_CAPEX_INCREASE اور DECLINE اقسام: اخراجات کی شدت میں درجہ بند سال بہ سال سرمائے کے اخراجات کی تبدیلی (≥15% / ≥30%)۔

          اقدار
          • MARGIN_EXPANSION
          • MARGIN_CONTRACTION
          • GUIDANCE_RAISED
          • GUIDANCE_LOWERED
          • GUIDANCE_REAFFIRMED
        • details
          قسم: object

          سگنل کی قسم کے لیے مخصوص ساختی فیلڈز۔ مندرجات مختلف ہوتے ہیں: گائیڈنس سگنلز low، high، point_estimate، prior_value، revision_pct رکھتے ہیں؛ سیگمنٹ سگنلز best، worst، spread_pp رکھتے ہیں؛ non-GAAP سگنلز gaap_field، non_gaap_value، gaap_value، divergence_pct رکھتے ہیں؛ گروتھ سگنلز current، yoy_chg رکھتے ہیں۔ null اقدار شامل نہیں کی جاتیں۔ قسم کے مخصوص مثالوں سے رجوع کریں۔

          • propertyName
            قسم: anything
        • metric
          قسم: string | null

          وہ میٹرک جس کا یہ سگنل حوالہ دیتا ہے، جب قابل اطلاق ہو (مثلاً revenue، earnings_per_share، operating_margin، یا گائیڈنس/KPI میٹرک کا نام)۔

        • period
          قسم: string | null

          وہ مالی مدت جس کا سگنل حوالہ دیتا ہے (مثلاً 2026-Q1، FY 2026)۔ آگے کی گائیڈنس کے سگنلز گائیڈ کردہ مدت کا حوالہ دیتے ہیں؛ مالیاتی سگنلز اس فائلنگ کی رپورٹنگ مدت کا حوالہ دیتے ہیں۔

    • next_page_url
      قسم: string

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

    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    application/json
Request Example for get/v1/beta/financial/earnings
curl 'https://openapi.felo.ai/v1/beta/financial/earnings?ticker=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "earnings": [
    {
      "ticker": "string",
      "report_period": "2026-10-26",
      "fiscal_period": "string",
      "currency": "string",
      "source_type": "8-K",
      "filing_date": "2026-10-26",
      "filing_datetime": null,
      "filing_window": "PRE_MARKET",
      "signals": [
        {
          "type": "MARGIN_EXPANSION",
          "metric": null,
          "period": null,
          "headline": "string",
          "details": {
            "additionalProperty": "anything"
          }
        }
      ],
      "filing_url": "https://example.com",
      "accession_number": "string",
      "quarterly": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      },
      "annual": {
        "revenue": null,
        "revenue_chg": 1,
        "revenue_yoy_chg": 1,
        "earnings_per_share": null,
        "earnings_per_share_chg": 1,
        "earnings_per_share_yoy_chg": 1,
        "gross_profit": null,
        "gross_profit_chg": 1,
        "gross_profit_yoy_chg": 1,
        "gross_margin": 1,
        "gross_margin_chg_bps": 1,
        "gross_margin_chg_pct": 1,
        "gross_margin_yoy_chg_bps": 1,
        "gross_margin_yoy_chg_pct": 1,
        "operating_income": null,
        "operating_income_chg": 1,
        "operating_income_yoy_chg": 1,
        "operating_margin": 1,
        "operating_margin_chg_bps": 1,
        "operating_margin_chg_pct": 1,
        "operating_margin_yoy_chg_bps": 1,
        "operating_margin_yoy_chg_pct": 1,
        "net_income": null,
        "net_income_chg": 1,
        "net_income_yoy_chg": 1,
        "net_margin": 1,
        "net_margin_chg_bps": 1,
        "net_margin_chg_pct": 1,
        "net_margin_yoy_chg_bps": 1,
        "net_margin_yoy_chg_pct": 1,
        "weighted_average_shares": null,
        "weighted_average_shares_diluted": null,
        "cash_and_equivalents": null,
        "change_in_cash_and_equivalents": null,
        "total_debt": null,
        "total_assets": null,
        "total_liabilities": null,
        "shareholders_equity": null,
        "net_cash_flow_from_operations": null,
        "net_cash_flow_from_operations_chg": 1,
        "net_cash_flow_from_operations_yoy_chg": 1,
        "net_cash_flow_from_investing": null,
        "net_cash_flow_from_investing_chg": 1,
        "net_cash_flow_from_investing_yoy_chg": 1,
        "net_cash_flow_from_financing": null,
        "net_cash_flow_from_financing_chg": 1,
        "net_cash_flow_from_financing_yoy_chg": 1,
        "capital_expenditure": null,
        "capital_expenditure_chg": 1,
        "capital_expenditure_yoy_chg": 1,
        "free_cash_flow": null,
        "free_cash_flow_chg": 1,
        "free_cash_flow_yoy_chg": 1
      }
    }
  ],
  "next_page_url": "string"
}
Get earnings snapshot