The Truth Layer for Korean Financial Data

Clarity, Verified.

v1.0.0

DART 사업보고서에서 5소스 교차검증으로 추출한 한국 상장기업 재무 데이터. 모든 수치에 원문 출처(URL + 행·열)와 신뢰도 등급이 포함됩니다.

2,600+

상장기업

514

표준화 항목

84%

Verified 비율

30+

엔드포인트

💡 Base URL: https://api.hyean.io/v1 · 로컬: http://localhost:8000

인증

모든 API 요청에 API 키가 필요합니다. 여기서 발급받으세요.

HTTP

# Bearer 인증 (권장)
curl -H "Authorization: Bearer hyn_live_xxxx" https://api.hyean.io/v1/api/companies

# 헤더 인증
curl -H "X-API-Key: hyn_live_xxxx" https://api.hyean.io/v1/api/companies

# 쿼리 파라미터
curl https://api.hyean.io/v1/api/companies?api_key=hyn_live_xxxx

API 키 입력 (Try It 기능에 사용)

AI Agent Harness

Financial Harness는 AI 에이전트가 Hyean 데이터를 활용하여 기관급 분석 보고서를 자동 생성하는 오픈소스 스킬입니다. 사용자의 AI가 분석하고, Hyean은 검증된 데이터만 제공합니다.

설치 (2단계)

bash

# 1. 스킬 설치
git clone https://github.com/twiw49/financial-harness.git .claude
cp .claude/.env.example .claude/.env
# .env 열고 HYEAN_API_KEY=hyn_live_xxxx 입력

사용법

bash

# Claude Code에서:
/financial-harness 삼성전자 주식의 가치를 분석하고 보고서를 작성해주세요

# 4개 에이전트가 병렬로 분석:
# - Fundamental: 재무제표 + 밸류에이션 (Hyean API)
# - Risk: 리스크 + 이벤트 + 감사 (Hyean API + 웹)
# - Industry: 산업 + 세그먼트 (Hyean API + 웹)
# - Macro: 매크로 + WACC (Hyean API)
# → 통합 보고서 + HTML 대시보드 생성

Hyean 데이터

교차검증된 재무제표, 벤치마크, 이벤트, 매크로 109개 지표

원문 추적

모든 수치에 DART 보고서 URL + 표 위치 자동 포함

AI 비용 $0

사용자의 AI가 분석. Hyean은 데이터 API 비용만

기업 정보

GET/api/companies기업 목록Core

GET/api/companies/{corp_code}기업 상세Core

GET/api/companies/{corp_code}/coverageFnGuide 커버리지Core

GET/api/companies/{corp_code}/discover데이터 카탈로그AI

재무 데이터

GET/api/companies/{corp_code}/financials재무제표 시계열Core

GET/api/companies/{corp_code}/benchmark벤치마크 비교NEW

기업 프로필

GET/api/companies/{corp_code}/profile통합 프로필AI

GET/api/companies/{corp_code}/risk리스크 종합AI

GET/api/companies/{corp_code}/quality데이터 품질AI

이벤트 + 이상변동

GET/api/companies/{corp_code}/events주요사항 이벤트NEW

GET/api/events/search이벤트 검색NEW

GET/api/companies/{corp_code}/anomalies재무 이상변동NEW

주석 + 인사이트

GET/api/companies/{corp_code}/notes주석 시계열NEW

GET/api/companies/{corp_code}/notes/elements주석 요소 목록NEW

GET/api/companies/{corp_code}/insight-dataAI 인사이트AI

감사의견

GET/api/companies/{corp_code}/audit감사의견 + KAMDeep

Deep 구조화

GET/api/companies/{corp_code}/deepDeep 구조화Deep

그룹 + 순위

GET/api/companies/{corp_code}/groups기업 분류NEW

GET/api/companies/{corp_code}/rank백분위 순위NEW

매크로 경제

GET/api/macro/context/{corp_code}매크로 맥락NEW

GET/api/macro/timeseries매크로 시계열NEW

KRX 지수

GET/api/index/listKRX 지수 목록NEW

GET/api/index/{name}/timeseries지수 시세NEW

메타 + 통계

GET/api/meta/itemsitem_id 메타Meta

GET/api/statsDB 통계Meta

에러 코드

코드	의미	해결방법
400	잘못된 파라미터	파라미터 타입/범위 확인
401	인증 실패	API 키 확인
404	기업 없음	corp_code 확인
429	요청 한도 초과	120회/분 제한
500	서버 오류	재시도 또는 문의