# 대차대조표 조회 **API:** Data API **Endpoint:** `GET /v1/beta/financial/financials/balance-sheets` **Tags:** Financial Data 한 기업의 대차대조표로, 기간당 약 36개 필드입니다. `total_assets`, `current_assets`, `cash_and_equivalents`, `inventory`, `trade_and_non_trade_receivables`, `property_plant_and_equipment`, `goodwill_and_intangible_assets`, `total_liabilities`, `current_liabilities`, `current_debt`, `trade_and_non_trade_payables`, `deferred_revenue`와 자기자본 항목이며 `report_period`, `fiscal_period`, `currency`, `filing_url`이 표시됩니다. `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 | | --- | --- | --- | --- | --- | | `limit` | query | no | string | | | `period` | query | no | string | | | `ticker` | query | no | string | | ## Responses ### 200 — 대차대조표 응답 Headers: - `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다. **application/json** Schema: `ResponseE40Feb4D3D6B_BalanceSheetResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_BalanceSheetResponse`) ### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요. ### 401 — 유효한 Felo API 키가 필요합니다. ### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다. ### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다. ### 429 — 요청 또는 지출 한도에 도달했습니다. ### 502 — 서비스가 요청을 완료할 수 없습니다. ### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다. ### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다. ### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다. **application/json** Schema: ```json {} ``` ## Schema definitions ### ResponseE40Feb4D3D6B_BalanceSheet `#/components/schemas/ResponseE40Feb4D3D6B_BalanceSheet` ```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`와 짝을 이룹니다." }, "total_assets": { "type": "number", "description": "회사의 총자산입니다." }, "current_assets": { "type": "number", "description": "회사의 유동자산입니다." }, "cash_and_equivalents": { "type": "number", "description": "회사의 현금 및 현금성 자산입니다." }, "inventory": { "type": "number", "description": "회사의 재고자산입니다." }, "current_investments": { "type": "number", "description": "회사의 유동 투자입니다." }, "trade_and_non_trade_receivables": { "type": "number", "description": "회사의 매출채권 및 비매출채권입니다." }, "non_current_assets": { "type": "number", "description": "회사의 비유동자산입니다." }, "property_plant_and_equipment": { "type": "number", "description": "회사의 유형자산입니다." }, "goodwill_and_intangible_assets": { "type": "number", "description": "회사의 영업권 및 무형자산입니다." }, "investments": { "type": "number", "description": "회사의 투자입니다." }, "non_current_investments": { "type": "number", "description": "회사의 비유동 투자입니다." }, "outstanding_shares": { "type": "number", "description": "회사의 유통주식수입니다." }, "tax_assets": { "type": "number", "description": "회사의 세무 자산입니다." }, "total_liabilities": { "type": "number", "description": "회사의 총부채입니다." }, "current_liabilities": { "type": "number", "description": "회사의 유동부채입니다." }, "current_debt": { "type": "number", "description": "회사의 단기부채입니다." }, "trade_and_non_trade_payables": { "type": "number", "description": "회사의 매입채무 및 비매입채무입니다." }, "deferred_revenue": { "type": "number", "description": "회사의 이연수익입니다." }, "deposit_liabilities": { "type": "number", "description": "회사의 예수부채입니다." }, "non_current_liabilities": { "type": "number", "description": "회사의 비유동부채입니다." }, "non_current_debt": { "type": "number", "description": "회사의 장기부채입니다." }, "tax_liabilities": { "type": "number", "description": "회사의 세무 부채입니다." }, "shareholders_equity": { "type": "number", "description": "회사의 주주자본입니다." }, "retained_earnings": { "type": "number", "description": "회사의 이익잉여금입니다." }, "accumulated_other_comprehensive_income": { "type": "number", "description": "회사의 누적 기타포괄손익입니다." }, "total_debt": { "type": "number", "description": "회사의 총부채입니다." } } } ``` ### ResponseE40Feb4D3D6B_BalanceSheetResponse `#/components/schemas/ResponseE40Feb4D3D6B_BalanceSheetResponse` ```json { "type": "object", "properties": { "balance_sheets": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_BalanceSheet" } }, "next_page_url": { "type": "string", "description": "다음 결과 페이지의 절대 URL입니다. 남은 결과가 있을 때만 표시되며, 그대로 요청해 계속 진행합니다. 각 페이지에는 최대 10개의 레코드가 있습니다." } } } ```