동방재부 인터페이스 (eastmoney-api)
VAlpha 퀀트 터미널 사용자에게 A주 시장 데이터 획득, 다중 데이터 소스 자동 전환과 서킷 브레이커 보호를 제공하며, Tushare/Akshare 링크 폴백을 지원하고, 통합 크레딧 한도에 따라 자동으로 요청 빈도 제한을 구성합니다.
Pipeline
data_collection -> data_storage -> factor_computation -> target_selection -> trading_execution -> visualization
주요 사용 사례 (총 26개)
VAlpha 터미널 진입점 (UC-101)
FastAPI 서버 시작 또는 장 전/후 분석 실행을 위한 통합 진입점 제공 트리거: start, server, run
FastAPI 애플리케이션 팩토리 (UC-102)
CORS, 라우터, 수명 주기 관리를 포함한 FastAPI 애플리케이션 인스턴스 생성 및 구성 트리거: application, fastapi, server
정적 파일 서빙 및 SPA 라우팅 (UC-103)
프론트엔드 정적 파일 제공 및 SPA catch-each 라우팅 구현으로 클라이언트 측 네비게이션 지원 트리거: static, frontend, spa
전체 26개의 사용 사례는 references/USE_CASES.md를 참조하십시오.
실행 트리거: 사용자 의도가 intent_router.uc_entries[].positive_terms와 일치하고 사용자가 동작 동사(run/execute/실행/backtest/fetch/collect)를 사용하는 경우
질문할 내용
- 대상 시장: A주(기본값), 홍콩, 또는 암호화폐? (ZVT의 미국 주식은 반쪽짜리입니다 — stockus_nasdaq_AAPL은 존재하지만 범위가 제한적입니다)
- 데이터 소스/제공자: eastmoney(무료, 계정 불필요), joinquant(계정+유료), baostock(무료, 좋은 과거 데이터), akshare, 또는 qmt(브로커)?
- 전략 유형: MACD 골든크로스, MA 크로스오버, 거래량 돌파, 기본적 스크리닝, 또는 사용자 정의 팩터?
- 시간 범위: 백테스트 기간의 start_timestamp 및 end_timestamp
- 대상 엔티티 ID: 특정 주식(stock_sh_600000) 또는 지수 구성 요소(SZ1000)?
Semantic Lock (치명적)
| ID | 규칙 | 위반 시 조치 |
|---|---|---|
SL-01 | 모든 거래 주기에서 매도 주문을 매수 주문보다 먼저 실행합니다 | 중단 |
SL-02 | 거래 신호는 다음 봉 실행(next-bar execution)을 사용해야 합니다 (룩어헤드 금지) | 중단 |
SL-03 | 엔티티 ID는 반드시 entity_type_exchange_code 형식을 따라야 합니다 | 중단 |
SL-04 | DataFrame 인덱스는 반드시 MultiIndex(entity_id, timestamp)여야 합니다 | 중단 |
SL-05 | TradingSignal은 반드시 position_pct, order_money, order_amount 중 정확히 하나만 가져야 합니다 | 중단 |
SL-06 | filter_result 열 의미: True=매수, False=매도, None/NaN=무조치 | 중단 |
SL-07 | 팩터 파이프라인에서 Transformer는 Accumulator보다 먼저 실행되어야 합니다 | 중단 |
SL-08 | MACD 파라미터 고정: fast=12, slow=26, signal=9 | 중단 |
전체 잠금 정의: references/LOCKS.md
주요 안티 패턴 (총 14개)
AP-DATA-SOURCING-001: SEC API 요청에 대한 User-Agent 헤더 누락 또는 유효하지 않음AP-DATA-SOURCING-002: 외부 API 속도 제한 무시로 IP 차단 발생AP-DATA-SOURCING-003: HTTP 타임아웃 구성 누락으로 인한 무기한 대기
모든 14개 안티 패턴: references/ANTI_PATTERNS.md
증거 품질 공지
[품질 공지] 이 크리스털은 finance-bp-084 청사진에서 컴파일되었습니다. 증거 검증 비율 = 36.8%, 감사 실패 총계 = 26개. 생성된 결과에는 포착되지 않은 요구 사항 차이가 있을 수 있습니다. 중요한 결정은 소스 파일(LATEST.yaml / LATEST.jsonl)에 대해 검증하십시오.
참조 파일
| 파일 | 내용 | 로드 시점 |
|---|---|---|
| references/seed.yaml | V6+ 전체 권위 (source-of-truth) | 행동/결정 분쟁 발생 시 반드시 읽기 |
| references/ANTI_PATTERNS.md | 14개 프로젝트 간 안티 패턴 | 구현 시작 전 |
| references/WISDOM.md | 프로젝트 간 핵심 통찰 | 아키텍처 결정 시 |
| references/CONSTRAINTS.md | 도메인 + 치명적 제약 | 규칙 충돌 시 |
| references/USE_CASES.md | 전체 KUC-* 비즈니스 시나리오 | 전체 예제가 필요할 때 |
| references/LOCKS.md | SL-* + 전제 조건 + 힌트 | 백테스트/트레이딩 코드 생성 전 |
| references/COMPONENTS.md | AST 구성 요소 지도 (모듈별 분할) | API 조회 시 |
finance-bp-084 청사진으로부터 Doramagic crystal-compilation-v6.1에 의해 2026-04-22T13:00:34.071788+00:00에 컴파일됨.
비기술적 개요는 human_summary.md를 참조하십시오.