Financial-api is a financial data service that provides A-share market data through multiple interfaces including REST API, MCP, CLI, and Python SDK.
The service solves the problem of accessing comprehensive Chinese stock market data for AI agents, quantitative researchers, and application developers. It aggregates real-time and historical stock prices, financial statements, valuations, indices, sectors, mutual funds, futures and options data, and market anomalies through a single API key. The tool offers multiple integration paths: a REST API for direct HTTP requests, an MCP interface for compatible AI tools like Claude and Cursor, a command-line interface for scripting, a Python SDK for research workflows, and a local DuckDB database for offline analysis and incremental synchronization.
Developers should choose this service if they work with Chinese A-share markets and need official data from Tonghuashun (HiThink), a major financial data provider in China. It suits quantitative research, AI agent development, and applications requiring comprehensive market coverage including limit-up pools, board-smashing detection, individual stock anomalies, and hot stock rankings. The project recommends starting with the Agent Skill interface, which automatically selects the appropriate underlying method based on the environment and task.
The project maintains active development across multiple integration channels with comprehensive documentation covering API endpoints, MCP specifications, CLI commands, and Python usage patterns. The repository includes detailed guides for different use cases and provides tools for building local data infrastructure through DuckDB integration.
