Felo API PlatformFelo API Platform
সব Financial Data endpoint
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-ও ফেরত দেয়: upstream-এ গণনা করা ফ্ল্যাগ যেমন EPS_BEAT, সঙ্গে headline এবং তার পেছনের actual / estimate / surprise_pct। ticker আবশ্যক এবং এটিই একমাত্র প্যারামিটার। কোম্পানি প্রকৃতপক্ষে কী রিপোর্ট করেছে তার জন্য এটি ব্যবহার করুন। ভবিষ্যৎমুখী ঐকমত্য যা এখনও ঘটেনি তার জন্য get_financial_analyst_estimates ব্যবহার করুন।

মূল্য রেফারেন্স

  • মিটারিং: স্থির সফল-রিকোয়েস্ট খরচ ভিত্তি
  • রেফারেন্স রিকোয়েস্ট অনুমান: USD 0.02
  • রেফারেন্স গ্রাহক মাল্টিপ্লায়ার: 1.0। নিষ্পত্তিকৃত গ্রাহক অঙ্কে এটি আবার প্রয়োগ করবেন না।

এটি কেবল রেফারেন্স মেটাডেটা; অ্যাকাউন্টের কোটেশন, নিশ্চিত মূল্য বা ব্যয়সীমা নয়। রিসোর্স ক্রেডিট Felo ক্রেডিট নয়। চূড়ান্ত চার্জ Felo-এর বিলিং রেকর্ড অনুযায়ী হয়।

কোয়েরি প্যারামিটার
  • cursor
    টাইপ: string

    পূর্ববর্তী রেসপন্সের next_page_url থেকে পাওয়া অস্বচ্ছ পেজিনেশন কার্সর। প্রদান করা হলে অন্য সব query প্যারামিটার উপেক্ষা করা হয়: কার্সরটি মূল রিকোয়েস্টের ফিল্টার বহন করে। এটিকে অস্বচ্ছ হিসেবে গণ্য করুন; তৈরি বা পরিবর্তন করবেন না।

  • limit
    টাইপ: integer
    সর্বনিম্ন:  
    1
    সর্বোচ্চ:  
    40

    ফেরত দেওয়ার জন্য সাম্প্রতিকতম রিপোর্ট পিরিয়ড-এর সমান সংখ্যক ফাইলিং, (report_period DESC, filing_date ASC) অনুসারে সাজানো। কোনো সাম্প্রতিক পিরিয়ডে 8-K এবং 10-Q / 10-K দুটোই থাকলে ফেরত দেওয়া এন্ট্রির সংখ্যা limit-এর বেশি হতে পারে। 40-এর বেশি মান 40-এ সীমাবদ্ধ করা হয়। অ-ধনাত্মক বা অ-পূর্ণসংখ্যা মান 400 ফেরত দেয়। এটি সব পেজ মিলিয়ে মোট, পেজ সাইজ নয়: প্রতিটি পেজে সর্বোচ্চ 10টি রেকর্ড থাকে, যা next_page_url দিয়ে সংযুক্ত।

  • ticker
    টাইপ: string
    আবশ্যক

    ticker চিহ্ন (যেমন AAPL)।

রেসপন্স
  • 200
    টাইপ: object · ResponseE40Feb4D3D6B_EarningsResponse

    আয় রেসপন্স

    • earnings
      টাইপ: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]

      ticker-এর জন্য SEC ফাইলিংয়ের সমতল তালিকা, (report_period DESC, filing_date ASC) অনুসারে সাজানো। limit=N হলে সর্বোচ্চ N report_period-এর ফাইলিং ফেরত দেওয়া হয়; কোনো সাম্প্রতিক সময়কালে 8-K এবং 10-Q/10-K দুটোই থাকলে এন্ট্রির সংখ্যা N-এর বেশি হতে পারে।

      • accession_number
        টাইপ: string
        আবশ্যক

        ফাইলিং শনাক্তকারী SEC accession নম্বর

      • 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
        আবশ্যক

        অনুরোধ করা ticker প্রতীক

      • 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: ফাইলিংয়ে রিপোর্ট করা অগ্রগামী guidance পরিবর্তন। SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: জৈব রাজস্ব প্রবৃদ্ধির ভিত্তিতে সর্বোত্তম বা ন্যূনতম পারফর্ম করা রিপোর্টযোগ্য segment। NON_GAAP_DIVERGENCE: সমন্বিত/non-GAAP অঙ্ক একই সময়কালের তার GAAP সমতুল্য থেকে উল্লেখযোগ্যভাবে ভিন্ন। BACKLOG_SURGE/BACKLOG_DECLINE: backlog বা অবশিষ্ট পারফরম্যান্স বাধ্যবাধকতা বছর-প্রতি-বছর ≥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

          সিগন্যাল টাইপের জন্য নির্দিষ্ট কাঠামোবদ্ধ ফিল্ড। বিষয়বস্তু ভিন্ন হয়: guidance সিগন্যালে low, high, point_estimate, prior_value, revision_pct থাকে; segment সিগন্যালে 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, বা কোনো guidance/KPI মেট্রিকের নাম)।

        • period
          টাইপ: string | null

          এই সিগন্যাল যে আর্থিক সময়কাল উল্লেখ করে (যেমন 2026-Q1, FY 2026)। অগ্রগামী guidance সিগন্যাল নির্দেশিত সময়কাল উল্লেখ করে; আর্থিক সিগন্যাল এই ফাইলিংয়ের রিপোর্টিং সময়কাল উল্লেখ করে।

    • next_page_url
      টাইপ: string

      ফলাফলের পরবর্তী পৃষ্ঠার সম্পূর্ণ URL। শুধু আরও ফলাফল বাকি থাকলে উপস্থিত থাকে; চালিয়ে যেতে এটি যেমন আছে তেমনই অনুরোধ করুন। প্রতিটি পৃষ্ঠায় সর্বোচ্চ 10টি রেকর্ড থাকে।

    application/json
  • 400

    রিকোয়েস্ট প্রক্রিয়া করা যায়নি। রিকোয়েস্ট প্যারামিটার যাচাই করুন।

  • 401

    একটি বৈধ Felo API key আবশ্যক।

  • 402

    বিলিং শর্ত পূরণ না হওয়ায় রিকোয়েস্ট এগোতে পারছে না।

  • 403

    অ্যাকাউন্টটিকে এই অপারেশন করার অনুমতি নেই।

  • 429

    রিকোয়েস্ট বা ব্যয়ের সীমায় পৌঁছে গেছে।

  • 502

    পরিষেবা রিকোয়েস্টটি সম্পন্ন করতে পারেনি।

  • 503

    API বা বিলিং পরিষেবা সাময়িকভাবে অনুপলভ্য।

  • 504

    রিকোয়েস্ট প্রক্রিয়াকরণের সময় পরিষেবার সময় শেষ হয়ে গেছে।

  • default

    ত্রুটি রেসপন্স; আপস্ট্রিম passthrough রেসপন্স প্রোভাইডারের ফর্ম্যাট ব্যবহার করতে পারে।

    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