A股 풀스택 데이터 툴킷 — 7계층 아키텍처 · 28개 엔드포인트 · 13개 데이터 소스 · 제3자 데이터 래핑 의존성 제로

A股(중국 A주) 풀스택 데이터 툴킷 — 7계층 아키텍처 · 28개 엔드포인트 · 13개 데이터 소스 · 제3자 데이터 래핑 (Data Encapsulation) 의존성 제로

13개의 데이터 소스에 분산된 A股 원시 데이터를 AI 프로그래밍 어시스턴트가 즉시 사용할 수 있는 도구 세트로 통합한 자가 포함(Self-contained) Skill 파일입니다. 더 이상 mootdx의 K선(K-line) 파라미터, 동차(East Money)의 PDF Referer 헤더, iwencai의 X-Claw 인증을 외울 필요가 없습니다 — 모두 래핑(Encapsulated)되어 있습니다.

V3.1 수정 사항 (2026-05-19): 4개의 만료된 인터페이스 교체 (Baidu PAE 자금 흐름 → 동차 push2, 대량 거래/기관 좌석 보고서 명칭 업데이트) + 동차 글로벌 정보 및 쥐차오(Juchao) 공고 파라미터 변경 수정. 총 28개 엔드포인트 실측 통과.

V3.0 Breaking Change: akshare 의존성을 완전히 제거하고, 모든 데이터 소스를 HTTP API 직결 방식으로 변경. 자금면/칩(筹码, Chip) 계층 추가.

Claude Code · Codex · OpenClaw 호환

Skill 파일은 본질적으로 구조화된 Markdown + 내장된 Python으로 구성되어 있어, 컨텍스트 주입(Context Injection)을 지원하는 모든 AI 프로그래밍 어시스턴트에서 사용할 수 있습니다.

A股 풀스택 데이터 · 7계층 아키텍처 · V3.1
│
├── 행황층(行情层) mootdx + 텐센트 재경 + Baidu K선 K선(MA5/10/20 포함) + 5단계 호가(Five-level Order Book) + PE/PB/시가총액 + 지수/ETF
...

3단계, 2분.

# 1. skill 디렉토리 생성
mkdir -p ~/.claude/skills/a-stock-data
# 2. SKILL.md를 그 안에 넣기
...

Claude Code를 실행하고 「688017의 밸류에이션을 확인해줘」라고 말하면 자동으로 활성화됩니다.

Codex / OpenClaw 사용자: SKILL.md의 내용을 시스템 프롬프트(System Prompt)나 프로젝트 컨텍스트 파일에 붙여넣기만 하면 됩니다. 내장된 Python 코드는 즉시 실행 가능합니다.

엔드포인트	데이터
mootdx 행황	K선(다중 주기) + 5단계 호가 + 체결 내역 + 실시간 시세 46개 필드
텐센트 재경	PE(TTM) / PB / 총 시가총액 / 유통 시가총액 / 회전율 / 상하한가 / 지수 / ETF
Baidu K선	일봉 K선 + MA5/MA10/MA20 평균가 직접 반환 (V3.0 추가)

엔드포인트	데이터
동차 reportapi	리포트 목록 + 등급 + 3년 EPS 예측
...
엔드포인트	데이터
---	---
텅후순(Tonghuashun) 핫이슈	당일 강세주 + 테마 귀인(Attribution) reason tags (편집부 수동 태깅)
...	동차 자금 흐름
	주력 / 대형 / 중형 / 소형 / 초대형 주문 분 단위 순유입 (V3.1에서 Baidu PAE 대체)
용호방(Dragon-Tiger List) 좌석	상위 등재 기록 + 매수/매도 좌석 TOP5 + 기관 동향
전시장 용호방	매일 전 시장 상위 등재 종목 + 순매수액 순위 + 등재 사유
보호예수 해제 캘린더	과거 해제 기록 + 향후 90일 해제 예정 경고
산업 섹터 순위	동차 산업 상승/하락 및 상승/하락 종목 수 (V3.0에서 텅후순 대체, 인증 불필요)

엔드포인트	데이터
신용융자/공매도 상세	일간 신용 잔고/매수/상환 + 공매도 잔고/매도/상환
대량 거래	체결가/거래량 + 매수/매도측 영업부 + 프리미엄 비율
주주 수 변화	분기 주주 수 + 전분기 대비 변화 + 주당 평균 보유 주식 수 (칩 집중도)
배당 및 무상증자 이력	주당 배당/증자/전환 + 진행 상태
개별 종목 자금 흐름 120일	주력/대형/중형/소형 주문 일간 순유입

엔드포인트	데이터
개별 종목 뉴스	동차 개별 종목 뉴스 피드 (search-api-web 직결)
...
엔드포인트	데이터
---	---
분기 보고서 스냅샷	37개 필드 (EPS / ROE / 순이익 / 주력 매출... )
...

iwencai를 제외한 나머지 모든 데이터 소스는 완전 무료이며 API Key가 필요 없습니다. 오직 iwencai 시맨틱 검색(Semantic Search)에만 API Key가 필요합니다 (신청 주소).

AI 어시스턴트에게 다음과 같이 말하면 활성화됩니다:

시나리오	말하기
개별 종목 밸류에이션 (Valuation)	「688017 밸류에이션 좀 도와줘, PE / PEG / 소화 기간 알려줘」
...
프로세스	수행 작업
---	---
단일 종목 밸류에이션	실시간 가격 → 컨센서스 EPS → Forward PE / PEG / PE 소화 연수
...
변경 사항	설명
---	---
4개 무효화된 인터페이스 교체
Baidu PAE 자금 흐름 → Eastmoney (Dongcai) push2로 교체, 대량 거래/기관 창구 보고서 명칭 업데이트, 전체 실측 완료
Eastmoney 글로벌 뉴스 복구
필수 파라미터 req_trace (UUID) 추가, 미포함 시 403 에러 반환
Juchao 공시 복구
stock 파라미터 형식이 code,plate에서 code,orgId로 업데이트됨 (예: 600519,gssh0600519)
자금 흐름 Eastmoney 통합
시그널 레이어의 자금 흐름을 Baidu에서 Eastmoney push2로 전환하여 자금 측면 레이어와 데이터 소스 통일
28개 엔드포인트 전량 실측
2026-05-19 기준, 28개 엔드포인트 전체 Kweichow Moutai (600519)를 통해 검증 완료

우선순위	데이터 소스	프로토콜	IP 차단 위험
1	mootdx	TCP (7709)	매우 낮음
...

아키텍처 원칙: mootdx (TCP 바이너리 프로토콜)를 제외하고, 모두 HTTP API에 직접 연결하며 제3자 데이터 래핑 (Data Wrapper) 의존성이 제로입니다. V3.1부터 자금 흐름은 Eastmoney push2를 통해 통합됩니다.

Q: mootdx와 텐센트(Tencent)의 차이점은 무엇인가요?
상호 보완적입니다. mootdx = 거래 레이어 (가격 + 호가 + K선), 텐센트 = 밸류에이션 레이어 (PE / PB / 시가총액 / 거래회전율 / 상하한가). 두 서비스 모두 IP를 차단하지 않습니다.

Q: 해외 서버에서 실행하면 mootdx가 타임아웃(Timeout)이 발생합니다.
mootdx는 TCP를 통해 TongdaXun 시세 서버에 직접 연결되므로, 중국 내 IP를 사용해야 안정적입니다. 해외 환경에서는 프록시를 사용하거나 yfinance로 전환하는 것을 권장합니다.

Q: 텐센트 API 필드 43이 PB인가요?
아닙니다. 43 = 변동폭(Amplitude)%, 46 = PB입니다. 인터넷상의 많은 튜토리얼이 잘못 기재하고 있으나, 여기는 실측을 통해 교정된 결과입니다.

Q: V3.0에서 왜 akshare를 제거했나요?
akshare는 본질적으로 Eastmoney/Tonghuashun/Sina 등의 공개 API를 래핑(Wrapping)한 것입니다. 이 중간 레이어는 결함 지점(버전 호환성 버그, pandas 3.0 ArrowInvalid 등)을 추가합니다. V3.0은 하위 HTTP API에 직접 연결하여 중간 의존성을 없섶으며, 더 안정적이고 제어 가능합니다.

Q: 산업 섹터(Industry Sector) 데이터 소스를 왜 Tonghuashun에서 Eastmoney로 변경했나요?
Tonghuashun의 stock_board_industry_summary_ths 인터페이스에 2026년 초부터 안티 크롤링(Anti-scraping) 401 에러가 추가되었습니다. Eastmoney push2 산업 섹터(m:90+t:2)는 인증이 필요 없고 필드가 더 풍부하여 완벽한 대체재입니다.

Q: iwencai가 401 에러를 반환합니다.
다음 사항을 확인하세요: (1) API Key 유효성 (2) X-Claw-* 헤더를 포함했는지 여부. SkillHub 2.0 이후로는 필수 사항입니다.

Q: Tonghuashun 핫이슈(Hot Topic)의 reason 필드가 비어 있습니다.
장 마감 후 데이터가 아직 업데이트되지 않은 상태입니다. 15:30 이후에 다시 호출하세요. 일부 ST 종목은 수동 태깅이 되어 있지 않을 수 있으므로, dropna로 필터링하면 됩니다.

Q: Baidu Gushutong의 ResultCode가 불안정합니다.
알려진 이슈입니다. 때로는 정수(int) 0을 반환하고

13개의 소스로부터 원시 A-share 데이터를 통합하여 AI 코딩 어시스턴트(AI coding assistants)가 즉시 사용할 수 있는 툴킷으로 만드는 독립형(Self-contained) Skill 파일입니다. mootdx 캔들스틱(candlestick) 파라미터, Eastmoney PDF Referer 헤더, 또는 iwencai X-Claw 인증 방식을 암기할 필요가 없습니다. 모든 것이 처리되어 있습니다.

V3.1 수정 사항 (2026-05-19): 작동하지 않는 4개의 엔드포인트(Baidu PAE 자금 흐름 → Eastmoney push2, 대량매매/기관 보고서 명칭 업데이트)를 교체하였으며, Eastmoney 글로벌 뉴스 및 cninfo 공시 파라미터 변경 사항을 수정했습니다. 28개 엔드포인트를 모두 검증했습니다.

V3.0 주요 변경 사항 (Breaking Change): akshare 의존성을 완전히 제거했습니다. 이제 모든 데이터 소스는 직접적인 HTTP API 호출을 사용합니다. 자금 흐름(capital flow) / 지분 구조(ownership) 레이어를 추가했습니다.

Claude Code · Codex · OpenClaw와 호환됩니다.

Skill 파일은 구조화된 Markdown과 임베디드 Python(embedded Python)으로 구성되어 있습니다. 컨텍스트 주입(context injection)이 가능한 모든 AI 코딩 어시스턴트가 이를 사용할 수 있습니다.

중국 A-Share 풀스택 데이터 · 7계층 아키텍처 · V3.1
│
├── 시장 데이터(Market Data) mootdx + Tencent + Baidu K-line 캔들스틱 (MA5/10/20 포함) + 호가창(Order Book) + PE/PB + 지수/ETF
...

3단계, 2분 소요.

# 1. skill 디렉토리 생성
mkdir -p ~/.claude/skills/a-stock-data
# 2. SKILL.md 다운로드
...

Claude Code를 실행하고 "688017의 밸류에이션(valuation)을 확인해줘"라고 말하면, Skill이 자동으로 활성화됩니다.

Codex / OpenClaw 사용자: SKILL.md의 내용을 시스템 프롬프트(system prompt) 또는 프로젝트 컨텍스트 파일에 붙여넣으세요. 임베디드된 Python 코드는 즉시 실행할 준비가 되어 있습니다.

엔드포인트 (Endpoint)	데이터
mootdx 시장 데이터	캔들스틱 (다중 기간) + Level-2 호가창 + 틱 데이터(tick-by-tick) + 46개 필드 시세
Tencent Finance	PE(TTM) / PB / 시가총액(Market Cap) / 유동 시가총액(Float Cap) / 거래량(Turnover) / 가격 제한폭(Price Limits) / 지수 / ETF
Baidu K-line	일봉 K-line + MA5/MA10/MA20 이동평균선 포함 (V3.0 신규)

엔드포인트 (Endpoint)	데이터 (Data)
Eastmoney reportapi	리포트 목록 + 등급 + 3년 EPS 예측
...
엔드포인트 (Endpoint)	데이터 (Data)
---	---
THS Hot Stocks	오늘의 강세 종목 + 섹터 귀속 태그 (편집자 주석)
...	Eastmoney 자금 흐름 (Fund Flow)
메인 / 대형 / 중형 / 소형 / 초대형 주문 분 단위 순유입 (V3.1, Baidu PAE 대체)
용호보 (Dragon Tiger Board)	등장 기록 + 상위 5개 매수/매도 증권사 + 기관 활동
일간 용호보 (전 시장)	일간 용호보 대상 모든 종목 + 순매수 순위 + 등장 사유
보호예수 해제 캘린더 (Lockup Expiry Calendar)	과거 해제 기록 + 90일 이내 해제 예정 알림
산업 순위 (Industry Ranking)
Eastmoney 산업 상승/하락 종목 수 (V3.0, THS 401 대체)

엔드포인트 (Endpoint)	데이터 (Data)
신용 거래 (Margin Trading)
일일 신용 잔고 / 매수 / 상환 + 공매도 잔고
블록딜 (Block Trades)
거래 가격/거래량 + 매수/매도 증권사 + 프리미엄 비율
주주 수 (Shareholder Count)
분기별 주주 수 + 전분기 대비 (QoQ) 변동 + 주당 평균 보유 주식 수
배당 이력 (Dividend History)
주당 현금 배당 / 무상증자 / 주식 배당
120일 자금 흐름 (120-Day Fund Flow)
메인 / 대형 / 중형 / 소형 주문 일일 순유입

엔드포인트 (Endpoint)	데이터 (Data)
주식 뉴스 (Stock News)	Eastmoney 종목별 뉴스 (direct search-api-web)
...
엔드포인트 (Endpoint)	데이터 (Data)
---	---
분기 스냅샷 (Quarterly Snapshot)	37개 필드 (EPS / ROE / 순이익 / 매출...)
...

iwencai를 제외한 모든 데이터 소스는 완전 무료이며, API 키가 필요하지 않습니다. 오직 iwencai 시맨틱 검색(semantic search)만 API 키가 필요합니다 (여기에서 신청).

그저 당신의 AI 어시스턴트에게 다음과 같이 말하세요:

시나리오	프롬프트
밸류에이션 (Valuation)	"688017 가치 평가해줘 — PE / PEG / 회수 기간 (payback period) 알려줘"
...
워크플로우 (Workflow)	수행 작업
---	---
단일 종목 밸류에이션 (Single Stock Valuation)	실시간 가격 → 컨센서스 EPS → 선행 PE / PEG / PE 회수 연수
...
변경 사항	설명
---	---
4개의 고장난 엔드포인트 (Broken Endpoints) 교체
Baidu PAE 자금 흐름 → Eastmoney push2로 교체, 블록딜/기관 보고서 명칭 업데이트
Eastmoney 글로벌 뉴스 수정
필수 req_trace UUID 파라미터 추가 (미포함 시 403 에러 반환)
cninfo 공시 수정
stock 파라미터 형식을 code,plate에서 code,orgId로 업데이트
자금 흐름 소스 통합
시그널 계층 (Signal layer)의 자금 흐름을 Baidu에서 Eastmoney push2로 이동하여 자본 흐름 (Capital Flow) 계층과 통합
28개 엔드포인트 전체 검증
2026-05-19 기준 Kweichow Moutai (600519)를 대상으로 전체 테스트 통과

우선순위 (Priority)	소스 (Source)	프로토콜 (Protocol)	IP 차단 위험 (IP Ban Risk)
1	mootdx	TCP (7709)	매우 낮음
...

아키텍처 (Architecture): mootdx (TCP 바이너리 프로토콜)를 제외한 모든 소스는 직접적인 HTTP API 호출을 사용합니다. 제3자 데이터 래퍼 (data wrapper) 의존성이 전혀 없습니다. 자금 흐름은 V3.1부터 Eastmoney push2로 통합되었습니다.

이 프로젝트는 데이터 액세스 도구만을 제공하며 투자 조언을 구성하지 않습니다. 투자는 위험을 수반합니다.

저자: Simon Lin · TikTok @simonlin121212 · Douyin "Simon林" · WeChat Official Account "硅基世纪"