a-stock-data  by simonlin1212

AI-powered data integration for China A-shares

Created 1 week ago

New!

1,736 stars

Top 24.0% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides a comprehensive, full-stack data toolkit for China A-Share market data, designed to be directly usable by AI coding assistants. It addresses the complexity of accessing and integrating data from multiple disparate sources by offering a unified interface, simplifying investment research workflows for AI-powered analysis. The target audience includes AI developers, quantitative researchers, and power users focused on the Chinese stock market.

How It Works

The toolkit employs a 6-layer architecture, consolidating data from 8 distinct sources including mootdx, Tencent Finance, Eastmoney, akshare, iwencai, cninfo, THS, and Baidu. It is packaged as a "Skill file" – a combination of structured Markdown and embedded Python – designed for seamless integration with AI programming assistants like Claude Code, Codex, and OpenClaw. This approach abstracts the intricate details of individual APIs, such as authentication, request headers, and parameterization, presenting a clean, callable interface for data retrieval.

Quick Start & Requirements

  • Primary install / run command: pip install mootdx akshare requests pandas stockstats
  • Non-default prerequisites: mootdx requires a domestic IP for stability; iwencai requires an API key.
  • Estimated setup time: ~2 minutes.
  • Links: SKILL.md download: https://raw.githubusercontent.com/simonlin1212/a-stock-data/main/SKILL.md; iwencai API key application: https://www.iwencai.com/skillhub.

Highlighted Details

  • 21 endpoints covering market data, research reports, signals, news, fundamentals, and filings.
  • Real-time market data (low IP ban risk) and handling of complex authentication (e.g., Eastmoney PDF, iwencai).
  • V2.1 enhancements include detailed Dragon Tiger Board analysis, full-market Dragon Tiger data, lockup expiry alerts, industry comparisons, concept blocks, and fund flow tracking.
  • Offers four built-in research workflows and optimized F10 data.

Maintenance & Community

  • Author: Simon Lin.
  • Community links: TikTok @simonlin121212, WeChat Official Account "硅基世纪". No other community platforms or roadmaps are detailed.

Licensing & Compatibility

  • License type: Apache License 2.0.
  • Compatibility: Permissive, compatible with commercial applications and closed-source linking with attribution.

Limitations & Caveats

mootdx requires a domestic IP for stability; overseas users may encounter timeouts or require workarounds. Some data sources, like akshare's Eastmoney backend, may exhibit anti-scraping measures necessitating retry logic. The iwencai semantic search feature is gated behind an API key. The project explicitly states it provides data access tools only and does not offer investment advice.

Health Check
Last Commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
3
Issues (30d)
5
Star History
1,783 stars in the last 13 days

Explore Similar Projects

Starred by Taranjeet Singh Taranjeet Singh(Cofounder of Mem0), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
16 more.

OpenBB by OpenBB-finance

0.5%
68k
Financial data platform for analysts, quants, and AI agents
Created 5 years ago
Updated 3 days ago
Feedback? Help us improve.