// the find
HiThink-Tech/Financial-API
同花顺官方 A股金融数据服务，提供股票实时行情、历史行情、财务报表、指数、板块、涨停等数据，适用于 AI Agent、量化研究和应用开发，支持 API、MCP、CLI 和 Python。Official Tonghuashun (HiThink) A-share financial data service providing real-time and historical stock market data, financial statements, indices, sectors and limit-up data for AI agents, quantitative research and application development.
An official A-share market data service from Tonghuashun (HiThink), offered as a hosted REST API with an MCP server, a Node CLI that syncs a local DuckDB database, a Python SDK, and an agent skill. It covers quotes, financial statements, valuations, indices, sectors, limit-up data, public funds, futures and options. It is aimed at AI agent builders and quant researchers who work with A-share data and can read Chinese.
- One API key works across REST, MCP, CLI and the Python SDK, so an agent, a notebook and a scheduled job can share auth and endpoints.
- marketdb builds a local DuckDB database with incremental sync, validation and repair, and the CLI exposes it as plain SQL through `db query`. Backtests get a reproducible local dataset without running a server.
- The README lists what is not offered (no minute bars, tick data, Level-2, HK/US quotes, macro data, news text) and says unsupported requests should fail rather than return simulated data. Vendor READMEs rarely state their limits this plainly, and that makes the adoption decision easier.
- The README describes a sync script with a `--check` mode that keeps the Skill's contract copies aligned with the docs, plus a page map and a capabilities schema. Drift between the docs and the real tool list is less likely than in most agent-facing APIs.
- Nothing works without a live, authorized key on one vendor domain (fuyao.aicubes.cn). The docs say offline material only shows what is supported, and actual availability depends on the account, so it can only be confirmed with real calls.
- Most of the documentation, field descriptions and error semantics are in Chinese. The English README is a short overview, so an English-only team will be working mostly from field names and examples.
- The onboarding flow offers to let the user hand the API key directly to the agent for setup. The only caveat is a note that chat platforms may keep message history. For a key that grants financial data access, that is a real exposure to think through before using it.
- The MIT license covers the code, not the data. Redistribution rights, and whether data can be stored in a shared marketdb, are governed by Tonghuashun's terms, which this repo does not spell out. Anyone building a product on it should read those first.