Felo API PlatformFelo API Platform
endpoint ทั้งหมดของ Financial Data
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, บล็อก quarterly ที่มี revenue, estimated_revenue, revenue_surprise และ revenue_surprise_pct, ชุดสามค่าเดียวกันสำหรับ 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
    จำเป็น

    สัญลักษณ์ ticker (เช่น AAPL)

การตอบกลับ
  • 200
    ประเภท: object · ResponseE40Feb4D3D6B_EarningsResponse

    การตอบกลับกำไร

    • earnings
      ประเภท: array object[] · ResponseE40Feb4D3D6B_EarningsRecord[]

      รายการเอกสารยื่นต่อ SEC แบบแบนสำหรับ ticker เรียงตาม (report_period DESC, filing_date ASC) เมื่อ limit=N จะคืนเอกสารยื่นได้ไม่เกิน N report_period จำนวนรายการอาจเกิน N เมื่องวดล่าสุดมีทั้ง 8-K และ 10-Q/10-K

      • accession_number
        ประเภท: string
        จำเป็น

        หมายเลข accession ของ SEC ที่ระบุเอกสารยื่น

      • filing_date
        ประเภท: string รูปแบบ: date
        จำเป็น

        วันที่ตามปฏิทินที่ SEC รับเอกสารยื่น ตามเวลาตะวันออก (เขตเวลาทำการของ SEC) จับคู่กับ filing_datetime ในระดับวัน

      • filing_url
        ประเภท: string รูปแบบ: uri
        จำเป็น

        URL ไปยังเอกสารยื่นต่อ SEC

      • 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

          เปอร์เซ็นต์การเปลี่ยนแปลงของกำไรต่อหุ้นเทียบกับงวดก่อนหน้า เป็นทศนิยม เทียบตามลำดับในเพย์โหลดรายไตรมาส และเทียบปีต่อปีในเพย์โหลดรายปี คืนค่าเฉพาะเมื่อคำนวณได้

        • earnings_per_share_yoy_chg
          ประเภท: number

          การเปลี่ยนแปลงของกำไรต่อหุ้นแบบปีต่อปีเทียบกับไตรมาสเดียวกันของปีก่อน เป็นทศนิยม เฉพาะเพย์โหลดรายไตรมาส คืนค่าเฉพาะเมื่อคำนวณได้

        • 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 รับเอกสารยื่นเมื่อใด ตามเวลาตะวันออก ดึงจากฟิลด์ acceptanceDateTime ใน API submissions ของ EDGAR จับคู่กับ 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 = วันเสาร์หรืออาทิตย์ เป็น null เมื่อไม่มี filing_datetime

        ค่า
        • 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

          เปอร์เซ็นต์การเปลี่ยนแปลงของกำไรต่อหุ้นเทียบกับงวดก่อนหน้า เป็นทศนิยม เทียบตามลำดับในเพย์โหลดรายไตรมาส และเทียบปีต่อปีในเพย์โหลดรายปี คืนค่าเฉพาะเมื่อคำนวณได้

        • earnings_per_share_yoy_chg
          ประเภท: number

          การเปลี่ยนแปลงของกำไรต่อหุ้นแบบปีต่อปีเทียบกับไตรมาสเดียวกันของปีก่อน เป็นทศนิยม เฉพาะเพย์โหลดรายไตรมาส คืนค่าเฉพาะเมื่อคำนวณได้

        • 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: 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: การเปลี่ยนแปลงกำไรต่อหุ้นแบบปีต่อปีแบบแบ่งระดับ (≥15% / ≥30%); เป็นอิสระจากกำไรสุทธิเพราะการซื้อหุ้นคืนอาจขยายการเคลื่อนไหวของกำไรต่อหุ้น 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

    จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง

  • 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