Felo API PlatformFelo API Platform
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, 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)입니다. 최근 기간에 8-K와 10-Q / 10-K가 모두 있으면 반환되는 항목 수가 limit을 초과할 수 있습니다. 40을 초과하는 값은 40으로 제한됩니다. 0 이하이거나 정수가 아닌 값은 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개 report_period 분량의 공시가 반환되며, 최근 기간에 8-K와 10-Q/10-K가 모두 있으면 항목 수가 N을 초과할 수 있습니다.

      • 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 열거형
        필수

        이 공시의 근거가 되는 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

          1년 전 같은 회계 분기 대비 자본 지출의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • 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

          1년 전 같은 회계 분기 대비 EPS의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • free_cash_flow
          유형: number | null
        • free_cash_flow_chg
          유형: number

          직전 기간 대비 잉여현금흐름의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • free_cash_flow_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 잉여현금흐름의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • gross_margin
          유형: number

          매출총이익률을 소수로 나타냅니다(gross_profit / revenue). 계산 가능한 경우에만 반환됩니다.

        • gross_margin_chg_bps
          유형: number

          직전 기간 대비 매출총이익률의 절대 변동을 베이시스 포인트로 나타냅니다(예: 200.0 = 마진 200bps 확대). 계산 가능한 경우에만 반환됩니다.

        • gross_margin_chg_pct
          유형: number

          직전 기간 대비 매출총이익률의 변동률을 소수로 나타냅니다. 계산 가능한 경우에만 반환됩니다.

        • gross_margin_yoy_chg_bps
          유형: number

          1년 전 같은 회계 분기 대비 매출총이익률의 전년 대비 변동을 베이시스 포인트로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • gross_margin_yoy_chg_pct
          유형: number

          1년 전 같은 회계 분기 대비 매출총이익률의 전년 대비 변동률을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • gross_profit
          유형: number | null
        • gross_profit_chg
          유형: number

          직전 기간 대비 매출총이익의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • gross_profit_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 매출총이익의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • net_cash_flow_from_financing
          유형: number | null
        • net_cash_flow_from_financing_chg
          유형: number

          직전 기간 대비 재무 활동으로 인한 순현금흐름의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • net_cash_flow_from_financing_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 재무 활동으로 인한 순현금흐름의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • net_cash_flow_from_investing
          유형: number | null
        • net_cash_flow_from_investing_chg
          유형: number

          직전 기간 대비 투자 활동으로 인한 순현금흐름의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • net_cash_flow_from_investing_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 투자 활동으로 인한 순현금흐름의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • net_cash_flow_from_operations
          유형: number | null
        • net_cash_flow_from_operations_chg
          유형: number

          직전 기간 대비 영업 활동으로 인한 순현금흐름의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • net_cash_flow_from_operations_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 영업 활동으로 인한 순현금흐름의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • net_income
          유형: number | null
        • net_income_chg
          유형: number

          직전 기간 대비 순이익의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • net_income_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 순이익의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • net_margin
          유형: number

          순이익률을 소수로 나타냅니다(net_income / revenue). 계산 가능한 경우에만 반환됩니다.

        • net_margin_chg_bps
          유형: number

          직전 기간 대비 순이익률의 절대 변동을 베이시스 포인트로 나타냅니다. 계산 가능한 경우에만 반환됩니다.

        • net_margin_chg_pct
          유형: number

          직전 기간 대비 순이익률의 변동률을 소수로 나타냅니다. 계산 가능한 경우에만 반환됩니다.

        • net_margin_yoy_chg_bps
          유형: number

          1년 전 같은 회계 분기 대비 순이익률의 전년 대비 변동을 베이시스 포인트로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • net_margin_yoy_chg_pct
          유형: number

          1년 전 같은 회계 분기 대비 순이익률의 전년 대비 변동률을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • operating_income
          유형: number | null
        • operating_income_chg
          유형: number

          직전 기간 대비 영업이익의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • operating_income_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 영업이익의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • operating_margin
          유형: number

          영업이익률을 소수로 나타냅니다(operating_income / revenue). 계산 가능한 경우에만 반환됩니다.

        • operating_margin_chg_bps
          유형: number

          직전 기간 대비 영업이익률의 절대 변동을 베이시스 포인트로 나타냅니다. 계산 가능한 경우에만 반환됩니다.

        • operating_margin_chg_pct
          유형: number

          직전 기간 대비 영업이익률의 변동률을 소수로 나타냅니다. 계산 가능한 경우에만 반환됩니다.

        • operating_margin_yoy_chg_bps
          유형: number

          1년 전 같은 회계 분기 대비 영업이익률의 전년 대비 변동을 베이시스 포인트로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • operating_margin_yoy_chg_pct
          유형: number

          1년 전 같은 회계 분기 대비 영업이익률의 전년 대비 변동률을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • revenue
          유형: number | null
        • revenue_chg
          유형: number

          직전 기간 대비 매출의 변동률을 소수로 나타냅니다(예: 0.10 = +10%). 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • revenue_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 매출의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • 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 열거형

        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

          1년 전 같은 회계 분기 대비 자본 지출의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • 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

          1년 전 같은 회계 분기 대비 EPS의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • free_cash_flow
          유형: number | null
        • free_cash_flow_chg
          유형: number

          직전 기간 대비 잉여현금흐름의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • free_cash_flow_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 잉여현금흐름의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • gross_margin
          유형: number

          매출총이익률을 소수로 나타냅니다(gross_profit / revenue). 계산 가능한 경우에만 반환됩니다.

        • gross_margin_chg_bps
          유형: number

          직전 기간 대비 매출총이익률의 절대 변동을 베이시스 포인트로 나타냅니다(예: 200.0 = 마진 200bps 확대). 계산 가능한 경우에만 반환됩니다.

        • gross_margin_chg_pct
          유형: number

          직전 기간 대비 매출총이익률의 변동률을 소수로 나타냅니다. 계산 가능한 경우에만 반환됩니다.

        • gross_margin_yoy_chg_bps
          유형: number

          1년 전 같은 회계 분기 대비 매출총이익률의 전년 대비 변동을 베이시스 포인트로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • gross_margin_yoy_chg_pct
          유형: number

          1년 전 같은 회계 분기 대비 매출총이익률의 전년 대비 변동률을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • gross_profit
          유형: number | null
        • gross_profit_chg
          유형: number

          직전 기간 대비 매출총이익의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • gross_profit_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 매출총이익의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • net_cash_flow_from_financing
          유형: number | null
        • net_cash_flow_from_financing_chg
          유형: number

          직전 기간 대비 재무 활동으로 인한 순현금흐름의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • net_cash_flow_from_financing_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 재무 활동으로 인한 순현금흐름의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • net_cash_flow_from_investing
          유형: number | null
        • net_cash_flow_from_investing_chg
          유형: number

          직전 기간 대비 투자 활동으로 인한 순현금흐름의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • net_cash_flow_from_investing_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 투자 활동으로 인한 순현금흐름의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • net_cash_flow_from_operations
          유형: number | null
        • net_cash_flow_from_operations_chg
          유형: number

          직전 기간 대비 영업 활동으로 인한 순현금흐름의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • net_cash_flow_from_operations_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 영업 활동으로 인한 순현금흐름의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • net_income
          유형: number | null
        • net_income_chg
          유형: number

          직전 기간 대비 순이익의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • net_income_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 순이익의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • net_margin
          유형: number

          순이익률을 소수로 나타냅니다(net_income / revenue). 계산 가능한 경우에만 반환됩니다.

        • net_margin_chg_bps
          유형: number

          직전 기간 대비 순이익률의 절대 변동을 베이시스 포인트로 나타냅니다. 계산 가능한 경우에만 반환됩니다.

        • net_margin_chg_pct
          유형: number

          직전 기간 대비 순이익률의 변동률을 소수로 나타냅니다. 계산 가능한 경우에만 반환됩니다.

        • net_margin_yoy_chg_bps
          유형: number

          1년 전 같은 회계 분기 대비 순이익률의 전년 대비 변동을 베이시스 포인트로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • net_margin_yoy_chg_pct
          유형: number

          1년 전 같은 회계 분기 대비 순이익률의 전년 대비 변동률을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • operating_income
          유형: number | null
        • operating_income_chg
          유형: number

          직전 기간 대비 영업이익의 변동률을 소수로 나타냅니다. 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • operating_income_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 영업이익의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • operating_margin
          유형: number

          영업이익률을 소수로 나타냅니다(operating_income / revenue). 계산 가능한 경우에만 반환됩니다.

        • operating_margin_chg_bps
          유형: number

          직전 기간 대비 영업이익률의 절대 변동을 베이시스 포인트로 나타냅니다. 계산 가능한 경우에만 반환됩니다.

        • operating_margin_chg_pct
          유형: number

          직전 기간 대비 영업이익률의 변동률을 소수로 나타냅니다. 계산 가능한 경우에만 반환됩니다.

        • operating_margin_yoy_chg_bps
          유형: number

          1년 전 같은 회계 분기 대비 영업이익률의 전년 대비 변동을 베이시스 포인트로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • operating_margin_yoy_chg_pct
          유형: number

          1년 전 같은 회계 분기 대비 영업이익률의 전년 대비 변동률을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • revenue
          유형: number | null
        • revenue_chg
          유형: number

          직전 기간 대비 매출의 변동률을 소수로 나타냅니다(예: 0.10 = +10%). 분기 페이로드에서는 순차 비교, 연간 페이로드에서는 전년 대비입니다. 계산 가능한 경우에만 반환됩니다.

        • revenue_yoy_chg
          유형: number

          1년 전 같은 회계 분기 대비 매출의 전년 대비 변동을 소수로 나타냅니다. 분기 페이로드에만 해당합니다. 계산 가능한 경우에만 반환됩니다.

        • 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 열거형
          필수

          시그널 카테고리입니다. 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

도움이 필요하신가요?

  • API, 결제, 계정 관련 문의는 지원에서 안내해 드립니다.
  • Discord에서 Felo 개발자와 대화해 보세요.
  • 변경 내역을 확인해 보세요.
  • 대량 구매 가격이나 구매 관련 도움이 필요하신가요? 영업팀 문의.
  • LLM으로 구축 중이신가요? llms.txt를 읽어 보세요.