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.

재무 지표 조회

​

한 기업의 기간별 계산된 비율 약 49개입니다. market_cap, enterprise_value, price_to_earnings_ratio, price_to_book_ratio, price_to_sales_ratio, enterprise_value_to_ebitda_ratio, free_cash_flow_yield, peg_ratio, gross_margin, operating_margin, net_margin, return_on_equity, return_on_assets, return_on_invested_capital, 회전율 및 유동성 비율이며 각각 report_period와 fiscal_period가 표시됩니다. period는 필수이고 ticker 또는 cik으로 식별합니다. 기간에 걸쳐 비율 추세를 볼 때 사용하세요. 현재 값만 필요하면 get_financial_financial_metrics_snapshot이 한 행으로 훨씬 작습니다.

가격 참고

  • 과금 기준: 성공한 요청당 고정 원가 기준.
  • 참고 요청 추정치: USD 0.02.
  • 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.

참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

쿼리 매개변수
  • cik
    유형: string

    회사의 CIK(Central Index Key)입니다. ticker 대신 사용할 수 있습니다.

  • cursor
    유형: string

    이전 응답의 next_page_url에서 가져온 불투명한 페이지네이션 커서입니다. 제공하면 다른 모든 쿼리 매개변수는 무시됩니다. 커서에 원래 요청의 필터가 포함되어 있기 때문입니다. 불투명한 값으로 취급하고 직접 구성하거나 수정하지 마세요.

  • filing_date
    유형: string 형식: date

    YYYY-MM-DD 형식의 정확한 SEC 제출 날짜로 필터링합니다. 제출 날짜를 알 수 없는 행은 제외됩니다.

  • filing_date_gt
    유형: string 형식: date

    YYYY-MM-DD 형식의 날짜 이후 SEC 제출 날짜로 필터링합니다. 제출 날짜를 알 수 없는 행은 제외됩니다.

  • filing_date_gte
    유형: string 형식: date

    YYYY-MM-DD 형식의 날짜 이후이거나 같은 SEC 제출 날짜로 필터링합니다. 제출 날짜를 알 수 없는 행은 제외됩니다.

  • filing_date_lt
    유형: string 형식: date

    YYYY-MM-DD 형식의 날짜 이전 SEC 제출 날짜로 필터링합니다. 제출 날짜를 알 수 없는 행은 제외됩니다.

  • filing_date_lte
    유형: string 형식: date

    YYYY-MM-DD 형식의 날짜 이전이거나 같은 SEC 제출 날짜로 필터링합니다. 특정 시점 기준 조회에 유용합니다. 지정한 날짜까지 공개 제출된 데이터만 반환합니다. 제출 날짜를 알 수 없는 행은 제외됩니다.

  • limit
    유형: integer

    반환할 최대 결과 수입니다. 이 값은 페이지 크기가 아니라 모든 페이지에 걸친 총계입니다. 각 페이지에는 최대 10개 레코드가 포함되며 next_page_url로 연결됩니다.

  • period
    유형: string 열거형
    필수

    재무 데이터의 기간입니다.

    값
    • annual
    • quarterly
    • ttm
  • report_period
    유형: string 형식: date

    YYYY-MM-DD 형식의 정확한 보고 기간 날짜로 필터링합니다.

  • report_period_gt
    유형: string 형식: date

    YYYY-MM-DD 형식의 날짜보다 큰 보고 기간으로 필터링합니다.

  • report_period_gte
    유형: string 형식: date

    YYYY-MM-DD 형식의 날짜보다 크거나 같은 보고 기간으로 필터링합니다.

  • report_period_lt
    유형: string 형식: date

    YYYY-MM-DD 형식의 날짜보다 작은 보고 기간으로 필터링합니다.

  • report_period_lte
    유형: string 형식: date

    YYYY-MM-DD 형식의 날짜보다 작거나 같은 보고 기간으로 필터링합니다.

  • ticker
    유형: string

    회사의 티커 심볼입니다. cik를 제공하지 않으면 필수입니다.

응답
  • 200
    유형: object · ResponseE40Feb4D3D6B_FinancialMetricsResponse

    ticker의 과거 재무 지표 및 비율

    • accession_number
      유형: string | null

      공시의 SEC 접수 번호입니다.

    • asset_turnover
      유형: number

      매출을 평균 총자산으로 나눈 값입니다.

    • book_value_growth
      유형: number

      장부가치의 전년 대비 성장률입니다.

    • book_value_per_share
      유형: number

      주주자본을 유통주식수로 나눈 값입니다.

    • cash_ratio
      유형: number

      현금 및 현금성 자산을 유동부채로 나눈 값입니다.

    • currency
      유형: string

      재무 데이터가 보고되는 통화입니다.

    • current_ratio
      유형: number

      유동자산을 유동부채로 나눈 값입니다.

    • days_sales_outstanding
      유형: number

      기간 중 평균 매출채권을 매출로 나눈 값입니다.

    • debt_to_assets
      유형: number

      총 부채를 총자산으로 나눈 값입니다.

    • debt_to_equity
      유형: number

      총 부채를 주주자본으로 나눈 값입니다.

    • earnings_growth
      유형: number

      이익의 전년 대비 성장률입니다.

    • earnings_per_share
      유형: number

      순이익을 가중평균 유통주식수로 나눈 값입니다.

    • earnings_per_share_growth
      유형: number

      기간 중 주당순이익의 성장률입니다.

    • ebitda_growth
      유형: number

      기간 중 EBITDA의 성장률입니다.

    • enterprise_value
      유형: number

      회사의 총가치입니다(시가총액 + 부채 - 현금).

    • enterprise_value_to_ebitda_ratio
      유형: number

      기업가치 대비 EBITDA 비율입니다.

    • enterprise_value_to_revenue_ratio
      유형: number

      기업가치 대비 매출 비율입니다.

    • filing_date
      유형: string | null 형식: date

      SEC가 공시를 접수한 날짜(미국 동부 시간, SEC 운영 시간대 기준)입니다. filing_datetime의 달력일 기준 대응값입니다. 행에 연결된 날짜가 있는 SEC 공시가 없으면 null입니다.

    • filing_datetime
      유형: string | null 형식: date-time

      SEC가 공시를 접수한 시각을 하루 이내 단위로 기록한 타임스탬프(미국 동부 시간)입니다. EDGAR submissions API의 SEC acceptanceDateTime 필드에서 가져옵니다. 동일 이벤트의 달력일 정밀도 값인 filing_date와 짝을 이룹니다.

    • filing_url
      유형: string | null 형식: uri

      SEC 공시 URL입니다.

    • fiscal_period
      유형: string

      재무 지표의 회계 기간입니다.

    • form_type
      유형: string | null

      이 행의 출처가 된 SEC 양식입니다(10-K, 10-Q/A, 20-F, S-1, ...). 제출된 그대로의 정확한 양식이므로 수정본은 /A 접미사를 유지합니다. period가 ttm이면 null입니다. 최근 12개월 창은 여러 공시에 걸칠 수 있으므로 하나로 귀속하지 않습니다. 4분기가 회계연도 공시에서 도출된 경우 quarterly 행이 10-K를 가질 수 있습니다.

    • free_cash_flow_growth
      유형: number

      기간 중 잉여현금흐름의 성장률입니다.

    • free_cash_flow_per_share
      유형: number

      잉여현금흐름을 유통주식수로 나눈 값입니다.

    • free_cash_flow_yield
      유형: number

      잉여현금흐름 수익률입니다.

    • gross_margin
      유형: number

      매출 대비 매출총이익 비율입니다.

    • interest_coverage
      유형: number

      EBIT를 이자 비용으로 나눈 값입니다.

    • inventory_turnover
      유형: number

      매출원가를 평균 재고자산으로 나눈 값입니다.

    • net_margin
      유형: number

      매출 대비 순이익 비율입니다.

    • next_page_url
      유형: string

      다음 결과 페이지의 절대 URL입니다. 남은 결과가 있을 때만 표시되며, 그대로 요청해 계속 진행합니다. 각 페이지에는 최대 10개의 레코드가 있습니다.

    • operating_cash_flow_ratio
      유형: number

      영업 현금흐름을 유동부채로 나눈 값입니다.

    • operating_cycle
      유형: number

      재고자산 회전율 + 매출채권 회전율입니다.

    • operating_income_growth
      유형: number

      기간 중 영업이익의 성장률입니다.

    • operating_margin
      유형: number

      매출 대비 영업이익 비율입니다.

    • payout_ratio
      유형: number

      순이익 대비 지급 배당금 비율입니다.

    • peg_ratio
      유형: number

      주가수익성장비율(PEG)입니다.

    • period
      유형: string 열거형

      재무 지표의 기간입니다.

      값
      • quarterly
      • ttm
      • annual
    • price_to_book_ratio
      유형: number

      주가순자산비율(PBR)입니다.

    • price_to_earnings_ratio
      유형: number

      주가수익비율(PER)입니다.

    • price_to_sales_ratio
      유형: number

      주가매출비율(PSR)입니다.

    • quick_ratio
      유형: number

      당좌자산을 유동부채로 나눈 값입니다.

    • receivables_turnover
      유형: number

      매출을 평균 매출채권으로 나눈 값입니다.

    • report_period
      유형: string 형식: date

      재무 지표의 보고 기간입니다.

    • return_on_assets
      유형: number

      총자산 대비 순이익 비율입니다.

    • return_on_equity
      유형: number

      주주자본 대비 순이익 비율입니다.

    • return_on_invested_capital
      유형: number

      투자자본 대비 세후 순영업이익 비율입니다.

    • revenue_growth
      유형: number

      매출의 전년 대비 성장률입니다.

    • ticker
      유형: string

      회사의 티커 심볼입니다.

    • working_capital_turnover
      유형: number

      매출을 평균 운전자본으로 나눈 값입니다.

    application/json
  • 400

    요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

  • 401

    유효한 Felo API 키가 필요합니다.

  • 402

    청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

  • 403

    이 계정에는 이 작업을 수행할 권한이 없습니다.

  • 429

    요청 또는 지출 한도에 도달했습니다.

  • 502

    서비스가 요청을 완료할 수 없습니다.

  • 503

    API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

  • 504

    요청을 처리하는 동안 서비스 시간이 초과되었습니다.

  • default

    오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

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

도움이 필요하신가요?

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