Financial Data
Company fundamentals, financial statements, market prices and economic data.
전체 재무제표 조회
한 기업의 세 재무제표를 한 번의 호출로 모두 가져옵니다. income_statements, balance_sheets, cash_flow_statements를 담은 financials 객체를 반환하며, 각각은 전용 도구가 반환하는 것과 같은 형태입니다. period는 필수(annual, quarterly 또는 ttm)이고 ticker 또는 cik으로 기업을 식별하며 limit으로 제한합니다. 전체 그림이 필요해 세 번 호출해야 하는 경우에 사용하세요. 재무제표 하나만 필요하면 get_financial_financials_income_statements, get_financial_financials_balance_sheets, get_financial_financials_cash_flow_statements가 훨씬 적은 데이터를 반환합니다. 여러 기업의 명명된 필드 몇 개가 필요하면 post_financial_financials_search_line_items가 더 좁습니다.
가격 참고
- 과금 기준: 성공한 요청당 고정 원가 기준.
- 참고 요청 추정치: USD 0.02.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: stringcik
회사의 CIK(Central Index Key)입니다.
- 유형: stringcursor
이전 응답의 next_page_url에서 가져온 불투명한 페이지네이션 커서입니다. 제공하면 다른 모든 쿼리 매개변수는 무시됩니다. 커서에 원래 요청의 필터가 포함되어 있기 때문입니다. 불투명한 값으로 취급하고 직접 구성하거나 수정하지 마세요.
- 유형: string 형식: datefiling
_date YYYY-MM-DD 형식의 정확한 SEC 제출 날짜로 필터링합니다. 제출 날짜를 알 수 없는 행은 제외됩니다.
- 유형: string 형식: datefiling
_date _gt YYYY-MM-DD 형식의 날짜 이후 SEC 제출 날짜로 필터링합니다. 제출 날짜를 알 수 없는 행은 제외됩니다.
- 유형: string 형식: datefiling
_date _gte YYYY-MM-DD 형식의 날짜 이후이거나 같은 SEC 제출 날짜로 필터링합니다. 제출 날짜를 알 수 없는 행은 제외됩니다.
- 유형: string 형식: datefiling
_date _lt YYYY-MM-DD 형식의 날짜 이전 SEC 제출 날짜로 필터링합니다. 제출 날짜를 알 수 없는 행은 제외됩니다.
- 유형: string 형식: datefiling
_date _lte YYYY-MM-DD 형식의 날짜 이전이거나 같은 SEC 제출 날짜로 필터링합니다. 특정 시점 기준 조회에 유용합니다. 지정한 날짜까지 공개 제출된 데이터만 반환합니다. 제출 날짜를 알 수 없는 행은 제외됩니다.
- 유형: integer 형식: int32limit
반환할 최대 재무제표 수입니다. 이 값은 페이지 크기가 아니라 모든 페이지에 걸친 총계입니다. 각 페이지에는 최대 10개 레코드가 포함되며
next_page_url로 연결됩니다. - 유형: string 열거형period필수
재무제표의 기간입니다.
값- annual
- quarterly
- ttm
- 유형: string 형식: datereport
_period YYYY-MM-DD 형식의 정확한 보고 기간 날짜로 필터링합니다.
- 유형: string 형식: datereport
_period _gt YYYY-MM-DD 형식의 날짜보다 큰 보고 기간으로 필터링합니다.
- 유형: string 형식: datereport
_period _gte YYYY-MM-DD 형식의 날짜보다 크거나 같은 보고 기간으로 필터링합니다.
- 유형: string 형식: datereport
_period _lt YYYY-MM-DD 형식의 날짜보다 작은 보고 기간으로 필터링합니다.
- 유형: string 형식: datereport
_period _lte YYYY-MM-DD 형식의 날짜보다 작거나 같은 보고 기간으로 필터링합니다.
- 유형: stringticker
티커 심볼입니다. cik를 제공하지 않으면 필수입니다.
- 유형: object · ResponseE40Feb4D3D6B_FinancialsResponse200
재무제표 응답
- 유형: objectfinancials
- balance유형: array object[] · ResponseE40Feb4D3D6B_BalanceSheet[]
_sheets - accession유형: string | null
_number 공시의 SEC 접수 번호입니다.
- accumulated유형: number
_other _comprehensive _income 회사의 누적 기타포괄손익입니다.
- cash유형: number
_and _equivalents 회사의 현금 및 현금성 자산입니다.
- currency유형: string
재무 데이터가 보고되는 통화입니다.
- current유형: number
_assets 회사의 유동자산입니다.
- current유형: number
_debt 회사의 단기부채입니다.
- current유형: number
_investments 회사의 유동 투자입니다.
- current유형: number
_liabilities 회사의 유동부채입니다.
- deferred유형: number
_revenue 회사의 이연수익입니다.
- deposit유형: number
_liabilities 회사의 예수부채입니다.
- filing유형: string | null 형식: date
_date SEC가 공시를 접수한 날짜(미국 동부 시간, SEC 운영 시간대 기준)입니다.
filing_datetime의 달력일 기준 대응값입니다. 행에 연결된 날짜가 있는 SEC 공시가 없으면 null입니다. - filing유형: string | null 형식: date-time
_datetime SEC가 공시를 접수한 시각을 하루 이내 단위로 기록한 타임스탬프(미국 동부 시간)입니다. EDGAR submissions API의 SEC
acceptanceDateTime필드에서 가져옵니다. 동일 이벤트의 달력일 정밀도 값인filing_date와 짝을 이룹니다. - filing유형: string | null 형식: uri
_url SEC 공시 URL입니다.
- fiscal유형: string
_period 대차대조표의 회계 기간입니다.
- form유형: string | null
_type 이 행의 출처가 된 SEC 양식입니다(
10-K,10-Q/A,20-F,S-1, ...). 제출된 그대로의 정확한 양식이므로 수정본은/A접미사를 유지합니다.period가ttm이면 null입니다. 최근 12개월 창은 여러 공시에 걸칠 수 있으므로 하나로 귀속하지 않습니다. 4분기가 회계연도 공시에서 도출된 경우quarterly행이10-K를 가질 수 있습니다. - goodwill유형: number
_and _intangible _assets 회사의 영업권 및 무형자산입니다.
- inventory유형: number
회사의 재고자산입니다.
- investments유형: number
회사의 투자입니다.
- non유형: number
_current _assets 회사의 비유동자산입니다.
- non유형: number
_current _debt 회사의 장기부채입니다.
- non유형: number
_current _investments 회사의 비유동 투자입니다.
- non유형: number
_current _liabilities 회사의 비유동부채입니다.
- outstanding유형: number
_shares 회사의 유통주식수입니다.
- period유형: string 열거형
대차대조표의 기간입니다.
값- quarterly
- ttm
- annual
- property유형: number
_plant _and _equipment 회사의 유형자산입니다.
- report유형: string 형식: date
_period 대차대조표의 보고 기간입니다.
- retained유형: number
_earnings 회사의 이익잉여금입니다.
- shareholders유형: number
_equity 회사의 주주자본입니다.
- tax유형: number
_assets 회사의 세무 자산입니다.
- tax유형: number
_liabilities 회사의 세무 부채입니다.
- ticker유형: string
티커 심볼입니다.
- total유형: number
_assets 회사의 총자산입니다.
- total유형: number
_debt 회사의 총부채입니다.
- total유형: number
_liabilities 회사의 총부채입니다.
- trade유형: number
_and _non _trade _payables 회사의 매입채무 및 비매입채무입니다.
- trade유형: number
_and _non _trade _receivables 회사의 매출채권 및 비매출채권입니다.
- cash유형: array object[] · ResponseE40Feb4D3D6B_CashFlowStatement[]
_flow _statements - accession유형: string | null
_number 공시의 SEC 접수 번호입니다.
- business유형: number
_acquisitions _and _disposals 회사의 사업 인수 및 처분입니다.
- capital유형: number
_expenditure 회사의 자본 지출입니다.
- change유형: number
_in _cash _and _equivalents 회사의 현금 및 현금성 자산 변동입니다.
- currency유형: string
재무 데이터가 보고되는 통화입니다.
- depreciation유형: number
_and _amortization 회사의 감가상각 및 상각입니다.
- dividends유형: number
_and _other _cash _distributions 회사의 배당금 및 기타 현금 분배입니다.
- effect유형: number
_of _exchange _rate _changes 회사의 환율 변동 효과입니다.
- ending유형: number
_cash _balance 회사의 기말 현금 잔액입니다.
- filing유형: string | null 형식: date
_date SEC가 공시를 접수한 날짜(미국 동부 시간, SEC 운영 시간대 기준)입니다.
filing_datetime의 달력일 기준 대응값입니다. 행에 연결된 날짜가 있는 SEC 공시가 없으면 null입니다. - filing유형: string | null 형식: date-time
_datetime SEC가 공시를 접수한 시각을 하루 이내 단위로 기록한 타임스탬프(미국 동부 시간)입니다. EDGAR submissions API의 SEC
acceptanceDateTime필드에서 가져옵니다. 동일 이벤트의 달력일 정밀도 값인filing_date와 짝을 이룹니다. - filing유형: string | null 형식: uri
_url SEC 공시 URL입니다.
- fiscal유형: string
_period 현금흐름표의 회계 기간입니다.
- form유형: string | null
_type 이 행의 출처가 된 SEC 양식입니다(
10-K,10-Q/A,20-F,S-1, ...). 제출된 그대로의 정확한 양식이므로 수정본은/A접미사를 유지합니다.period가ttm이면 null입니다. 최근 12개월 창은 여러 공시에 걸칠 수 있으므로 하나로 귀속하지 않습니다. 4분기가 회계연도 공시에서 도출된 경우quarterly행이10-K를 가질 수 있습니다. - free유형: number
_cash _flow 회사의 잉여현금흐름입니다.
- investment유형: number
_acquisitions _and _disposals 회사의 투자 인수 및 처분입니다.
- issuance유형: number
_or _purchase _of _equity _shares 회사의 지분 주식 발행 또는 매입입니다.
- issuance유형: number
_or _repayment _of _debt _securities 회사의 채무 증권 발행 또는 상환입니다.
- net유형: number
_cash _flow _from _financing 회사의 재무 활동으로 인한 순현금흐름입니다.
- net유형: number
_cash _flow _from _investing 회사의 투자 활동으로 인한 순현금흐름입니다.
- net유형: number
_cash _flow _from _operations 회사의 영업 활동으로 인한 순현금흐름입니다.
- net유형: number
_income 회사의 순이익입니다.
- period유형: string 열거형
현금흐름표의 기간입니다.
값- quarterly
- ttm
- annual
- report유형: string 형식: date
_period 현금흐름표의 보고 기간입니다.
- share유형: number
_based _compensation 회사의 주식 기반 보상입니다.
- ticker유형: string
티커 심볼입니다.
- income유형: array object[] · ResponseE40Feb4D3D6B_IncomeStatement[]
_statements - accession유형: string | null
_number 공시의 SEC 접수 번호입니다.
- consolidated유형: number
_income 회사의 연결 이익입니다.
- cost유형: number
_of _revenue 회사의 매출원가입니다.
- currency유형: string
재무 데이터가 보고되는 통화입니다.
- dividends유형: number
_per _common _share 회사의 보통주 1주당 배당금입니다.
- earnings유형: number
_per _share 회사의 주당순이익입니다.
- earnings유형: number
_per _share _diluted 회사의 희석 주당순이익입니다.
- ebit유형: number
회사의 이자 및 세전 이익입니다.
- filing유형: string | null 형식: date
_date SEC가 공시를 접수한 날짜(미국 동부 시간, SEC 운영 시간대 기준)입니다.
filing_datetime의 달력일 기준 대응값입니다. 행에 연결된 날짜가 있는 SEC 공시가 없으면 null입니다. - filing유형: string | null 형식: date-time
_datetime SEC가 공시를 접수한 시각을 하루 이내 단위로 기록한 타임스탬프(미국 동부 시간)입니다. EDGAR submissions API의 SEC
acceptanceDateTime필드에서 가져옵니다. 동일 이벤트의 달력일 정밀도 값인filing_date와 짝을 이룹니다. - filing유형: string | null 형식: uri
_url SEC 공시 URL입니다.
- fiscal유형: string
_period 손익계산서의 회계 기간입니다.
- form유형: string | null
_type 이 행의 출처가 된 SEC 양식입니다(
10-K,10-Q/A,20-F,S-1, ...). 제출된 그대로의 정확한 양식이므로 수정본은/A접미사를 유지합니다.period가ttm이면 null입니다. 최근 12개월 창은 여러 공시에 걸칠 수 있으므로 하나로 귀속하지 않습니다. 4분기가 회계연도 공시에서 도출된 경우quarterly행이10-K를 가질 수 있습니다. - gross유형: number
_profit 회사의 매출총이익입니다.
- income유형: number
_tax _expense 회사의 법인세 비용입니다.
- interest유형: number
_expense 회사의 이자 비용입니다.
- net유형: number
_income 회사의 순이익입니다.
- net유형: number
_income _common _stock 회사의 보통주 주주에게 귀속되는 순이익입니다.
- net유형: number
_income _discontinued _operations 회사의 중단영업으로 인한 순이익입니다.
- net유형: number
_income _non _controlling _interests 회사의 비지배지분으로 인한 순이익입니다.
- operating유형: number
_expense 회사의 영업비용입니다.
- operating유형: number
_income 회사의 영업이익입니다.
- period유형: string 열거형
손익계산서의 기간입니다.
값- quarterly
- ttm
- annual
- preferred유형: number
_dividends _impact 회사의 순이익에 대한 우선주 배당금의 영향입니다.
- report유형: string 형식: date
_period 손익계산서의 보고 기간입니다.
- research유형: number
_and _development 회사의 연구개발비입니다.
- revenue유형: number
회사의 총매출입니다.
- selling유형: number
_general _and _administrative _expenses 회사의 판매비와 관리비입니다.
- ticker유형: string
티커 심볼입니다.
- weighted유형: number
_average _shares 회사의 가중평균 주식수입니다.
- weighted유형: number
_average _shares _diluted 회사의 희석 가중평균 주식수입니다.
- 유형: stringnext
_page _url 다음 결과 페이지의 절대 URL입니다. 남은 결과가 있을 때만 표시되며, 그대로 요청해 계속 진행합니다. 각 페이지에는 최대 10개의 레코드가 있습니다.
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/financials?period=annual' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"financials": {
"income_statements": [
{
"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,
"revenue": 1,
"cost_of_revenue": 1,
"gross_profit": 1,
"operating_expense": 1,
"selling_general_and_administrative_expenses": 1,
"research_and_development": 1,
"operating_income": 1,
"interest_expense": 1,
"ebit": 1,
"income_tax_expense": 1,
"net_income_discontinued_operations": 1,
"net_income_non_controlling_interests": 1,
"net_income": 1,
"net_income_common_stock": 1,
"preferred_dividends_impact": 1,
"consolidated_income": 1,
"earnings_per_share": 1,
"earnings_per_share_diluted": 1,
"dividends_per_common_share": 1,
"weighted_average_shares": 1,
"weighted_average_shares_diluted": 1
}
],
"balance_sheets": [
{
"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,
"total_assets": 1,
"current_assets": 1,
"cash_and_equivalents": 1,
"inventory": 1,
"current_investments": 1,
"trade_and_non_trade_receivables": 1,
"non_current_assets": 1,
"property_plant_and_equipment": 1,
"goodwill_and_intangible_assets": 1,
"investments": 1,
"non_current_investments": 1,
"outstanding_shares": 1,
"tax_assets": 1,
"total_liabilities": 1,
"current_liabilities": 1,
"current_debt": 1,
"trade_and_non_trade_payables": 1,
"deferred_revenue": 1,
"deposit_liabilities": 1,
"non_current_liabilities": 1,
"non_current_debt": 1,
"tax_liabilities": 1,
"shareholders_equity": 1,
"retained_earnings": 1,
"accumulated_other_comprehensive_income": 1,
"total_debt": 1
}
],
"cash_flow_statements": [
{
"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,
"net_income": 1,
"depreciation_and_amortization": 1,
"share_based_compensation": 1,
"net_cash_flow_from_operations": 1,
"capital_expenditure": 1,
"business_acquisitions_and_disposals": 1,
"investment_acquisitions_and_disposals": 1,
"net_cash_flow_from_investing": 1,
"issuance_or_repayment_of_debt_securities": 1,
"issuance_or_purchase_of_equity_shares": 1,
"dividends_and_other_cash_distributions": 1,
"net_cash_flow_from_financing": 1,
"change_in_cash_and_equivalents": 1,
"effect_of_exchange_rate_changes": 1,
"ending_cash_balance": 1,
"free_cash_flow": 1
}
]
},
"next_page_url": "string"
}