# 현금흐름표 조회 **API:** Data API **Endpoint:** `GET /v1/beta/financial/financials/cash-flow-statements` **Tags:** Financial Data 한 기업의 현금흐름표로, 기간당 약 27개 필드입니다. `net_cash_flow_from_operations`, `net_cash_flow_from_investing`, `net_cash_flow_from_financing`, `capital_expenditure`, `depreciation_and_amortization`, `share_based_compensation`, `issuance_or_repayment_of_debt_securities`, `issuance_or_purchase_of_equity_shares`, `dividends_and_other_cash_distributions`이며 `report_period`, `fiscal_period`, `currency`가 표시됩니다. `period`는 필수입니다. 회계상 이익이 아닌 현금 창출을 볼 때 사용하세요. 잉여현금흐름 수익률 같은 파생 수치는 `get_financial_financial_metrics`에 있습니다. ### 가격 참고 - 과금 기준: 성공한 요청당 고정 원가 기준. - 참고 요청 추정치: 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)입니다. | | `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, (int32) | 반환할 현금흐름표의 최대 개수입니다. 페이지 크기가 아니라 모든 페이지를 합친 총 개수입니다. 각 페이지에는 최대 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 — 현금흐름표 응답 Headers: - `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다. **application/json** Schema: `ResponseE40Feb4D3D6B_CashFlowStatementResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatementResponse`) ### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요. ### 401 — 유효한 Felo API 키가 필요합니다. ### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다. ### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다. ### 429 — 요청 또는 지출 한도에 도달했습니다. ### 502 — 서비스가 요청을 완료할 수 없습니다. ### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다. ### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다. ### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다. **application/json** Schema: ```json {} ``` ## Schema definitions ### ResponseE40Feb4D3D6B_CashFlowStatement `#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatement` ```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`와 짝을 이룹니다." }, "net_income": { "type": "number", "description": "회사의 순이익입니다." }, "depreciation_and_amortization": { "type": "number", "description": "회사의 감가상각 및 상각입니다." }, "share_based_compensation": { "type": "number", "description": "회사의 주식 기반 보상입니다." }, "net_cash_flow_from_operations": { "type": "number", "description": "회사의 영업 활동으로 인한 순현금흐름입니다." }, "capital_expenditure": { "type": "number", "description": "회사의 자본 지출입니다." }, "business_acquisitions_and_disposals": { "type": "number", "description": "회사의 사업 인수 및 처분입니다." }, "investment_acquisitions_and_disposals": { "type": "number", "description": "회사의 투자 인수 및 처분입니다." }, "net_cash_flow_from_investing": { "type": "number", "description": "회사의 투자 활동으로 인한 순현금흐름입니다." }, "issuance_or_repayment_of_debt_securities": { "type": "number", "description": "회사의 채무 증권 발행 또는 상환입니다." }, "issuance_or_purchase_of_equity_shares": { "type": "number", "description": "회사의 지분 주식 발행 또는 매입입니다." }, "dividends_and_other_cash_distributions": { "type": "number", "description": "회사의 배당금 및 기타 현금 분배입니다." }, "net_cash_flow_from_financing": { "type": "number", "description": "회사의 재무 활동으로 인한 순현금흐름입니다." }, "change_in_cash_and_equivalents": { "type": "number", "description": "회사의 현금 및 현금성 자산 변동입니다." }, "effect_of_exchange_rate_changes": { "type": "number", "description": "회사의 환율 변동 효과입니다." }, "ending_cash_balance": { "type": "number", "description": "회사의 기말 현금 잔액입니다." }, "free_cash_flow": { "type": "number", "description": "회사의 잉여현금흐름입니다." } } } ``` ### ResponseE40Feb4D3D6B_CashFlowStatementResponse `#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatementResponse` ```json { "type": "object", "properties": { "cash_flow_statements": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatement" } }, "next_page_url": { "type": "string", "description": "다음 결과 페이지의 절대 URL입니다. 남은 결과가 있을 때만 표시되며, 그대로 요청해 계속 진행합니다. 각 페이지에는 최대 10개의 레코드가 있습니다." } } } ```