TL;DR

a-stock-data는 중국 A주용 데이터 엔드포인트 집합으로 10계층 아키텍처와 40개 엔드포인트를 통해 시세·리포트·자금·공고·舆情을 통합 제공한다. 실시간 가격과 호가 등 민감한 시계열은 mootdx/Tencent로 우선 확보하고 Eastmoney 같은 독점 데이터는 em_get로 직렬 한정과 재시도를 적용해 IP 봉쇄 위험을 낮추는 방식으로 동작한다. V3.3에서 Limit-Up, ETF 옵션, 舆情互动 레이어가 추가되어 거래 신호·옵션 그리스·투자자 질의 응답까지 범위를 확장했으며 tdx_client와 em_get 헬퍼로 mootdx 초기화·Eastmoney 한계점을 보완했다. 단점으로는 일부 Eastmoney 엔드포인트가 주거용 대역폭에서 간헐적 차단(HTTP 000 등)을 보일 수 있어 배치 호출 시 EM_MIN_INTERVAL을 늘리거나 네트워크를 변경해야 안정성이 확보된다.

핵심 포인트

• 원본 소스에 대한 제3자 래퍼 의존을 제거하고 HTTP/TCP를 직접 호출하는 구조를 채택함으로써 중간 레이어의 버전·호환성 문제를 회피한다. 이로 인해 V3.0에서 akshare 의존을 제거했고 tdx_client로 mootdx 초기화 실패를 우회했다.
• 데이터 소스 우선순위를 명확히 규정해 mootdx/Tencent를 고빈도로 사용하고 Eastmoney는 독점 데이터에만 한정해 사용하도록 설계해 IP 봉쇄 리스크를 체계적으로 낮췄다. 모든 Eastmoney 호출은 em_get을 통해 일괄 제한된다.
• V3.3에서 Limit-Up, ETF 옵션, 舆情互动 등 세 개의 레이어를 추가해 판별 신호·옵션 데이터·투자자 질의 응답까지 범위를 확장했으며 이들 엔드포인트는 모두 제로 인증(키 불필요)으로 동작 가능한 경우가 많다.
• 실시간 K선과 5단 호가 같은 시장 데이터를 mootdx/Tencent로 우선 확보한다.