수록 현황:335 건의 뉴스/102 개의 AI 도구/407 개의 오픈소스 프로젝트/74 개의 학습 자료
홈뉴스오픈소스모델AI 도구학습 자료
홈 / 오픈소스 / Financial-API

Financial-API

AI 에이전트와 퀀트 연구자를 위한 REST API, CLI, Python SDK, MCP, Agent Skill 전반에 걸쳐 통합된 HiThink 공식 A주식 금융 데이터 서비스.

TypeScriptMITPlatform
⭐ GitHubhttps://github.com/HiThink-Tech/Financial-API
1,753
스타 수
+0
스타 증가율
2026년 8월 17일
최근 업데이트
1
클릭 수

1. 프로젝트 개요

Financial-API는 HiThink의 공식 A주식(중국 본토 주식 시장) 금융 데이터 서비스로, AI 에이전트, 퀀트 연구자, 애플리케이션 개발자가 실시간 및 과거 시장 데이터, 재무제표, 밸류에이션, 지수, 섹터, 뮤추얼 펀드 정보를 여러 데이터 공급업체를 짜맞출 필요 없이 하나의 통합된 방식으로 조회할 수 있게 해줍니다.

2. 배경 및 포지셔닝

HiThink(同花顺)은 중국의 주요 금융 데이터 및 트레이딩 소프트웨어 제공업체로서, 개발자 친화적인 표준화된 인터페이스를 통해 자사의 내부 시장 데이터 인프라를 외부에 제공하기 위해 이 프로젝트를 구축했습니다. 핵심 목표는 하나의 API 키로 REST 호출, AI 채팅 도구용 MCP 서버, 스크립팅용 CLI, 연구 노트북용 Python SDK, 바로 사용 가능한 Agent Skill 등 모든 접근 방식을 구동하여 팀이 각 사용 사례마다 별도의 통합을 작성하고 유지 관리할 필요가 없도록 하는 것입니다.

일반적인 오픈소스 금융 데이터 래퍼와 차별화되는 점은 AI 에이전트 우선 설계에 있습니다. 설치 가능한 Agent Skill과 네이티브 MCP 지원을 기본으로 제공하고, LLM 워크플로에서 모의 데이터와 컨텍스트 오버플로를 피하는 것을 명시하며, 글로벌 거래소를 일반적으로 커버하려 하기보다는 중국 A주식 시장에 특화하여 깊이 있게 집중합니다.

3. 기능 카테고리

📈 시장 데이터 — 실시간 시세, K라인(캔들스틱) 이력, 거래량, 경매 스냅샷. 예: 최신 가격 조회, 장중 틱 데이터, 과거 일봉/분봉, 장전 경매 스냅샷.

📊 재무제표 및 밸류에이션 — 분석 및 스크리닝을 위한 기업 펀더멘털. 예: 손익계산서, 대차대조표, 현금흐름표, 밸류에이션 비율(P/E, P/B, P/S, P/CF).

🔥 특화 시장 지표 — A주식 시장의 거래 메커니즘에 고유한 데이터. 예: 상한가/하한가 풀, 연속 상한가 돌파 추적, 시장 이상 현상, 인기 종목 목록, 용호방(상위 트레이더) 순위.

🏦 지수 및 섹터 — 거시 및 테마 분석을 위한 그룹화된 시장 뷰. 예: 지수 구성 종목, 섹터 성과, 섹터 순환 데이터.

💰 뮤추얼 펀드 및 ETF — 주식과 함께 제공되는 펀드 측면 데이터. 예: 펀드 보유 종목, 과거 펀드 성과, ETF/LOF 시장 시세.

🗄️ 로컬 데이터 인프라 — 오프라인 대규모 분석을 위한 도구. 예: 전체 시장 데이터셋 다운로드, marketdb를 통한 로컬 DuckDB 데이터베이스 구축, 로컬에 저장된 시장 데이터의 SQL 조회.

4. 주요 하이라이트

  • 일곱 가지 접근 방식, 하나의 API 키 — Skill, MCP, REST API, CLI, Python SDK, marketdb, 직접 JSON API 모두 동일한 통합 HITHINK_FINANCE_API_KEY로 인증합니다.
  • 네이티브 MCP 지원 — Claude Desktop, Cursor, Windsurf에 직접 연결되어 AI 어시스턴트가 대화형으로 금융 데이터를 조회할 수 있습니다.
  • 설치 가능한 Agent Skill — npx skills add 한 줄 명령으로 설치하면 코딩 에이전트가 주어진 요청에 적합한 백엔드를 자동으로 선택하는 통합 인터페이스를 갖추게 됩니다.
  • 로컬 DuckDB 통합(marketdb) — 영구적인 로컬 데이터베이스 구축 및 조회를 지원하여 원격 API를 반복 호출하지 않고도 백테스팅을 반복 수행하는 데 유용합니다.
  • 모의 데이터 금지 정책 — 이 서비스는 데이터를 사용할 수 없을 때 값을 조작하지 않고 명시적으로 보고합니다. 이는 연구 및 트레이딩 인접 워크플로에 중요합니다.
  • 깊은 A주식 특화 — 상한가 풀, 용호방 순위와 같은 지표는 일반적인 글로벌 주식 래퍼가 아닌 중국 시장 미시구조에 대한 깊은 이해를 반영합니다.

5. 역할별 사용 사례

일반 개발자 — 데이터 파이프라인을 처음부터 구축하지 않고도 REST API를 통해 주식 시세, 재무 데이터 또는 펀드 데이터를 웹/모바일 앱에 통합할 수 있습니다.

데이터 및 연구 과학자 / 퀀트 — Python SDK와 marketdb를 사용하여 과거 데이터를 가져오고, 로컬 DuckDB 데이터셋을 구축하고, 노트북에서 직접 백테스트나 팩터 연구를 실행할 수 있습니다.

AI/에이전트 빌더 — Agent Skill을 설치하거나 MCP 서버를 구성하여 LLM 기반 에이전트가 실시간 데이터로 금융 질문에 답하거나 연구 작업을 자동화할 수 있게 합니다.

6. 시작하기

필요한 것 찾기 — 문서 허브에서 REST API 계약과 가이드를 둘러보세요:

https://fuyao.aicubes.cn/docs/

설치 및 통합 — 워크플로에 맞는 접근 방식을 선택하세요:

# AI 에이전트 / 코딩 어시스턴트 통합
npx skills add HiThink-Tech/Financial-API --skill hithink-finance -g --yes

# 명령줄 도구
npm install -g @hithink-tech/hithink-finance-cli
hithink-finance auth login

# Python SDK
python -m pip install -e ./python

먼저 https://fuyao.aicubes.cn/admin/에서 통합 API 키를 등록하고 이를 HITHINK_FINANCE_API_KEY 환경 변수로 설정하세요.

기여하기 — 저장소는 모노레포로 구성되어 있습니다. GitHub에서 풀 리퀘스트를 열기 전에 문서와 패키지별 README(hithink-finance-cli/README.md, python/README.md, skills/hithink-finance/SKILL.md)를 검토하세요.

7. 프로젝트 구조

docs/                    API 계약 및 중앙 문서 허브
  api/                   REST API 계약 소스
skills/
  hithink-finance/        설치 가능한 Agent Skill(통합 계약)
hithink-finance-cli/       Node.js CLI, Python SDK와 독립적
python/
  marketdb/               오프라인 조회용 로컬 DuckDB 인터페이스
  toolkit/fuyao/          원격 데이터 클라이언트 및 헬퍼 스크립트
  examples/               실행 가능한 사용 예제
  tests/                  테스트 스위트
examples/                 추가 영감 갤러리 및 정적 샘플
scripts/                  저장소 유지보수 유틸리티

8. 관련 생태계

Financial-API는 모델 컨텍스트 프로토콜(MCP)과 통합되어 Claude Desktop, Cursor, Windsurf에서 직접 사용할 수 있습니다. marketdb 모듈을 통해 로컬 데이터 저장을 위해 DuckDB를 기반으로 구축되었습니다. 기본 데이터 플랫폼은 fuyao.aicubes.cn에서 호스팅되며, 이곳에서 API 키 관리 콘솔과 전체 문서 사이트도 제공합니다.

9. 라이선스

✅ MIT 라이선스에 따라 상업용 제품을 포함하여 사용, 복사, 수정, 병합, 게시, 배포가 자유롭습니다.
✅ 독점 또는 폐쇄형 애플리케이션에 내장할 수 있습니다.
❌ 어떠한 보증도 제공되지 않으며, 저자는 사용으로 인한 손해에 대해 책임을 지지 않습니다.
ℹ️ 기본 금융 데이터에 대한 접근은 여전히 HiThink API 키가 필요하며 코드 자체에 대한 MIT 라이선스와는 별개로 HiThink의 자체 API 서비스 약관이 적용됩니다.
ℹ️ 이 서비스는 명시적으로 투자 자문이 아니며, 출력물을 금융 조언으로 간주해서는 안 됩니다.

10. 자주 묻는 질문

Q: 통합 방식(REST, CLI, MCP 등)마다 별도의 API 키가 필요한가요?
A: 아니요 — https://fuyao.aicubes.cn/admin/에서 발급받은 단일 HITHINK_FINANCE_API_KEY 하나로 일곱 가지 접근 방식 모두에서 작동합니다.

Q: AI 에이전트를 구축하려면 어떤 접근 방식을 사용해야 하나요?
A: 통합 인터페이스를 원한다면 Agent Skill(npx skills add HiThink-Tech/Financial-API --skill hithink-finance -g --yes)을 사용하고, Claude Desktop, Cursor, Windsurf에서 직접 작업 중이라면 MCP 서버를 사용하세요.

Q: 매번 API를 호출하는 대신 데이터를 로컬에 저장할 수 있나요?
A: 네 — Python SDK의 marketdb 모듈을 사용하여 로컬 DuckDB 데이터베이스를 구축하고 이에 대해 SQL 쿼리를 실행할 수 있습니다.

Q: 중국 A주식에만 국한되나요, 아니면 글로벌 시장도 커버하나요?
A: 이 서비스는 상한가/하한가 풀, 용호방 순위와 같은 시장 특화 지표를 포함하여 중국 A주식 시장에 특화되어 있습니다.

Q: 요청한 데이터를 사용할 수 없으면 어떻게 되나요?
A: 이 서비스는 모의 또는 조작된 값을 반환하는 대신 데이터를 사용할 수 없음을 명시적으로 보고합니다.

11. 빠른 링크

12. 요약

Financial-API는 HiThink의 A주식 시장 데이터 인프라를 개발자, 퀀트, AI 에이전트가 각자에게 맞는 형식(REST, CLI, Python, MCP 또는 플러그 앤 플레이 Agent Skill)으로 사용할 수 있는 단일하고 일관되게 인증되는 서비스로 패키징합니다. 여러 공급업체를 짜맞추지 않고도 신뢰할 수 있고 잘 구조화된 데이터가 필요한 중국 시장 금융 애플리케이션이나 AI 연구 에이전트를 구축하는 팀에게 가장 가치가 있습니다.