# 재무 지표 조회 **API:** Data API **Endpoint:** `GET /v1/beta/financial/financial-metrics` **Tags:** Financial 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 청구 기록을 따릅니다. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `cik` | query | no | string | 회사의 CIK(Central Index Key)입니다. ticker 대신 사용할 수 있습니다. | | `cursor` | query | no | string | 이전 응답의 next_page_url에서 가져온 불투명한 페이지네이션 커서입니다. 제공하면 다른 모든 쿼리 매개변수는 무시됩니다. 커서에 원래 요청의 필터가 포함되어 있기 때문입니다. 불투명한 값으로 취급하고 직접 구성하거나 수정하지 마세요. | | `filing_date` | query | no | string, (date) | YYYY-MM-DD 형식의 정확한 SEC 제출 날짜로 필터링합니다. 제출 날짜를 알 수 없는 행은 제외됩니다. | | `filing_date_gt` | query | no | string, (date) | YYYY-MM-DD 형식의 날짜 이후 SEC 제출 날짜로 필터링합니다. 제출 날짜를 알 수 없는 행은 제외됩니다. | | `filing_date_gte` | query | no | string, (date) | YYYY-MM-DD 형식의 날짜 이후이거나 같은 SEC 제출 날짜로 필터링합니다. 제출 날짜를 알 수 없는 행은 제외됩니다. | | `filing_date_lt` | query | no | string, (date) | YYYY-MM-DD 형식의 날짜 이전 SEC 제출 날짜로 필터링합니다. 제출 날짜를 알 수 없는 행은 제외됩니다. | | `filing_date_lte` | query | no | string, (date) | YYYY-MM-DD 형식의 날짜 이전이거나 같은 SEC 제출 날짜로 필터링합니다. 특정 시점 기준 조회에 유용합니다. 지정한 날짜까지 공개 제출된 데이터만 반환합니다. 제출 날짜를 알 수 없는 행은 제외됩니다. | | `limit` | query | no | integer | 반환할 최대 결과 수입니다. 이 값은 페이지 크기가 아니라 모든 페이지에 걸친 총계입니다. 각 페이지에는 최대 10개 레코드가 포함되며 `next_page_url`로 연결됩니다. | | `period` | query | yes | string, enum: "annual", "quarterly", "ttm" | 재무 데이터의 기간입니다. | | `report_period` | query | no | string, (date) | YYYY-MM-DD 형식의 정확한 보고 기간 날짜로 필터링합니다. | | `report_period_gt` | query | no | string, (date) | YYYY-MM-DD 형식의 날짜보다 큰 보고 기간으로 필터링합니다. | | `report_period_gte` | query | no | string, (date) | YYYY-MM-DD 형식의 날짜보다 크거나 같은 보고 기간으로 필터링합니다. | | `report_period_lt` | query | no | string, (date) | YYYY-MM-DD 형식의 날짜보다 작은 보고 기간으로 필터링합니다. | | `report_period_lte` | query | no | string, (date) | YYYY-MM-DD 형식의 날짜보다 작거나 같은 보고 기간으로 필터링합니다. | | `ticker` | query | no | string | 회사의 티커 심볼입니다. cik를 제공하지 않으면 필수입니다. | ## Responses ### 200 — ticker의 과거 재무 지표 및 비율 Headers: - `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다. **application/json** Schema: `ResponseE40Feb4D3D6B_FinancialMetricsResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_FinancialMetricsResponse`) ### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요. ### 401 — 유효한 Felo API 키가 필요합니다. ### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다. ### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다. ### 429 — 요청 또는 지출 한도에 도달했습니다. ### 502 — 서비스가 요청을 완료할 수 없습니다. ### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다. ### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다. ### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다. **application/json** Schema: ```json {} ``` ## Schema definitions ### ResponseE40Feb4D3D6B_FinancialMetricsResponse `#/components/schemas/ResponseE40Feb4D3D6B_FinancialMetricsResponse` ```json { "type": "object", "properties": { "ticker": { "type": "string", "description": "회사의 티커 심볼입니다." }, "report_period": { "type": "string", "format": "date", "description": "재무 지표의 보고 기간입니다." }, "fiscal_period": { "type": "string", "description": "재무 지표의 회계 기간입니다." }, "period": { "type": "string", "enum": [ "quarterly", "ttm", "annual" ], "description": "재무 지표의 기간입니다." }, "currency": { "type": "string", "description": "재무 데이터가 보고되는 통화입니다." }, "accession_number": { "type": [ "string", "null" ], "description": "공시의 SEC 접수 번호입니다." }, "form_type": { "type": [ "string", "null" ], "description": "이 행의 출처가 된 SEC 양식입니다(`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). 제출된 그대로의 정확한 양식이므로 수정본은 `/A` 접미사를 유지합니다. `period`가 `ttm`이면 null입니다. 최근 12개월 창은 여러 공시에 걸칠 수 있으므로 하나로 귀속하지 않습니다. 4분기가 회계연도 공시에서 도출된 경우 `quarterly` 행이 `10-K`를 가질 수 있습니다." }, "filing_url": { "type": [ "string", "null" ], "format": "uri", "description": "SEC 공시 URL입니다." }, "filing_date": { "type": [ "string", "null" ], "format": "date", "description": "SEC가 공시를 접수한 날짜(미국 동부 시간, SEC 운영 시간대 기준)입니다. `filing_datetime`의 달력일 기준 대응값입니다. 행에 연결된 날짜가 있는 SEC 공시가 없으면 null입니다." }, "filing_datetime": { "type": [ "string", "null" ], "format": "date-time", "description": "SEC가 공시를 접수한 시각을 하루 이내 단위로 기록한 타임스탬프(미국 동부 시간)입니다. EDGAR submissions API의 SEC `acceptanceDateTime` 필드에서 가져옵니다. 동일 이벤트의 달력일 정밀도 값인 `filing_date`와 짝을 이룹니다." }, "enterprise_value": { "type": "number", "description": "회사의 총가치입니다(시가총액 + 부채 - 현금)." }, "price_to_earnings_ratio": { "type": "number", "description": "주가수익비율(PER)입니다." }, "price_to_book_ratio": { "type": "number", "description": "주가순자산비율(PBR)입니다." }, "price_to_sales_ratio": { "type": "number", "description": "주가매출비율(PSR)입니다." }, "enterprise_value_to_ebitda_ratio": { "type": "number", "description": "기업가치 대비 EBITDA 비율입니다." }, "enterprise_value_to_revenue_ratio": { "type": "number", "description": "기업가치 대비 매출 비율입니다." }, "free_cash_flow_yield": { "type": "number", "description": "잉여현금흐름 수익률입니다." }, "peg_ratio": { "type": "number", "description": "주가수익성장비율(PEG)입니다." }, "gross_margin": { "type": "number", "description": "매출 대비 매출총이익 비율입니다." }, "operating_margin": { "type": "number", "description": "매출 대비 영업이익 비율입니다." }, "net_margin": { "type": "number", "description": "매출 대비 순이익 비율입니다." }, "return_on_equity": { "type": "number", "description": "주주자본 대비 순이익 비율입니다." }, "return_on_assets": { "type": "number", "description": "총자산 대비 순이익 비율입니다." }, "return_on_invested_capital": { "type": "number", "description": "투자자본 대비 세후 순영업이익 비율입니다." }, "asset_turnover": { "type": "number", "description": "매출을 평균 총자산으로 나눈 값입니다." }, "inventory_turnover": { "type": "number", "description": "매출원가를 평균 재고자산으로 나눈 값입니다." }, "receivables_turnover": { "type": "number", "description": "매출을 평균 매출채권으로 나눈 값입니다." }, "days_sales_outstanding": { "type": "number", "description": "기간 중 평균 매출채권을 매출로 나눈 값입니다." }, "operating_cycle": { "type": "number", "description": "재고자산 회전율 + 매출채권 회전율입니다." }, "working_capital_turnover": { "type": "number", "description": "매출을 평균 운전자본으로 나눈 값입니다." }, "current_ratio": { "type": "number", "description": "유동자산을 유동부채로 나눈 값입니다." }, "quick_ratio": { "type": "number", "description": "당좌자산을 유동부채로 나눈 값입니다." }, "cash_ratio": { "type": "number", "description": "현금 및 현금성 자산을 유동부채로 나눈 값입니다." }, "operating_cash_flow_ratio": { "type": "number", "description": "영업 현금흐름을 유동부채로 나눈 값입니다." }, "debt_to_equity": { "type": "number", "description": "총 부채를 주주자본으로 나눈 값입니다." }, "debt_to_assets": { "type": "number", "description": "총 부채를 총자산으로 나눈 값입니다." }, "interest_coverage": { "type": "number", "description": "EBIT를 이자 비용으로 나눈 값입니다." }, "revenue_growth": { "type": "number", "description": "매출의 전년 대비 성장률입니다." }, "earnings_growth": { "type": "number", "description": "이익의 전년 대비 성장률입니다." }, "book_value_growth": { "type": "number", "description": "장부가치의 전년 대비 성장률입니다." }, "earnings_per_share_growth": { "type": "number", "description": "기간 중 주당순이익의 성장률입니다." }, "free_cash_flow_growth": { "type": "number", "description": "기간 중 잉여현금흐름의 성장률입니다." }, "operating_income_growth": { "type": "number", "description": "기간 중 영업이익의 성장률입니다." }, "ebitda_growth": { "type": "number", "description": "기간 중 EBITDA의 성장률입니다." }, "payout_ratio": { "type": "number", "description": "순이익 대비 지급 배당금 비율입니다." }, "earnings_per_share": { "type": "number", "description": "순이익을 가중평균 유통주식수로 나눈 값입니다." }, "book_value_per_share": { "type": "number", "description": "주주자본을 유통주식수로 나눈 값입니다." }, "free_cash_flow_per_share": { "type": "number", "description": "잉여현금흐름을 유통주식수로 나눈 값입니다." }, "next_page_url": { "type": "string", "description": "다음 결과 페이지의 절대 URL입니다. 남은 결과가 있을 때만 표시되며, 그대로 요청해 계속 진행합니다. 각 페이지에는 최대 10개의 레코드가 있습니다." } } } ```