Hithink Financial Data Services (hithink-finance)

Market Dumps allow you to retrieve entire market datasets in Parquet format. This is significantly more efficient than calling individual stock endpoints for bulk operations like backtesting, offline analysis, or building a data warehouse. Instead of thousands of HTTP requests, you can use these three endpoints to get all necessary data in just a few requests.

Available Endpoints:

Hithink Financial Data Services (hithink-finance) provides official A-share (Chinese stock market) financial data designed for AI Agents, quantitative researchers, and application developers. It offers a unified API Key to access a wide range of data including real-time quotes, financial reports, valuations, indices, funds, futures, and specialized market sentiment data (e.g., limit up/down pools, dragon-tiger lists).

Key access methods include:

• REST API: For zero-dependency HTTP integration into websites or apps.
• MCP (Model Context Protocol): For connecting chat tools like Claude or Cursor.
• hithink-finance CLI: For terminal-based bulk queries, downloads, and exports.
• Python SDK/Toolkit: For research scripts and data processing in Python/Notebooks.
• hithink-finance Skill: The recommended entry point for AI Agents to automatically select the best tool (API, MCP, CLI, or SDK).
• marketdb: For building and maintaining a local DuckDB database for SQL-based research.

The Futures API allows users to query financial data related to futures markets. The typical workflow is to first identify a specific variety (品种) or contract (合约), and then use those identifiers to query related data such as positions, warehouse receipts, basis, trading schedules, and market prices.

Available data domains include:

• Information & Identifiers: Variety lists and contract details.
• Market Prices: Intraday and daily K-line data.
• Trading Schedules: Trading days and session timelines.
• Positions: Data categorized by variety, company, or specific contract (including historical sequences).
• Basis: Latest basis for main continuous contracts and historical basis for specific contracts.
• Warehouse Receipts: Historical warehouse receipt data.
• Extended Data (Internal/Coming Soon): Macro indicators, variety plates, main/secondary main contracts, and commodity indices.

The Futures domain provides data services for futures markets. The standard workflow is to first identify a specific variety (品种) or contract (合约), and then use those identifiers to query related data such as positions, warehouse receipts, basis, trading schedules, and market quotes.

Available data categories include:

• Information & Identifiers (资料与标识): Query directories, search for contracts, or get basic variety information to obtain identifiers needed for subsequent requests.
• Market Quotes (行情): Access intraday (分时) or daily K-line (日K) data.
• Trading Schedules (交易日程): Access trading days, trading sessions, and session times.
• Positions (持仓): Query positions by variety, company, or specific contract, including daily and historical data.
• Basis (基差): Access latest basis for main continuous contracts or historical basis for specific contracts.
• Warehouse Receipts (仓单): Access historical warehouse receipt data and changes.

The Public Fund (公募基金) API domain provides comprehensive data services for mutual funds. The data is organized into several functional groups:

• Information & Identifiers: Query fund companies and basic fund profiles to obtain identifiers needed for subsequent requests.
• Market Data: Access ETF trading prices via snapshots or historical daily lines. Note that fund Net Asset Value (NAV) is located under the 'Performance' group.
• Financial Statements & Indicators: Access income statements, balance sheets, and specific financial indicators for defined reporting periods.
• Net Value & Performance: Retrieve NAV sequences, interval returns, historical performance indicators, and maximum drawdowns.
• Holdings & Allocation: Access current top holdings, historical stock/bond holdings, and asset/industry allocation data. For historical queries, you must first retrieve the relevant report dates.
• Holders: View holder structures and the top ten holders.
• Fund Managers: Access manager details, investment styles, performance, and professional experience (Manager IDs are obtained from fund profile data).
• Backtesting: Perform online backtesting by first querying available indicators and then constructing test conditions.
• General Indicators: Retrieve data for charting (line) or tabular displays.
• QDII Quota: Summary and detailed lists of QDII quotas.
• News & Offerings: Fund news articles and lists of funds currently being offered or pending offering.
• Diagnostics & Corporate Actions: Access fund diagnostic details and dividend records.

The Futures domain provides data related to specific varieties or contracts. The standard workflow is to first identify a variety or contract using the 资料与标识 (Information & Identifiers) tools, and then perform queries for market data, trading schedules, positions, basis, or warehouse receipts.

Available data categories include:

• 资料与标识 (Information & Identifiers): Search for directories, contracts, or basic variety information to obtain identifiers required for subsequent API calls.
• 行情 (Market Data): Access intraday (分时) or daily (日K) price trends.
• 交易日程 (Trading Schedule): Query trading days, sessions, and time slots.
• 持仓 (Positions): Query positions at the variety, contract, or company level, supporting both specific dates and historical sequences.
• 基差 (Basis): Access latest basis for main continuous contracts or historical basis for specific contracts.
• 仓单 (Warehouse Receipts): Access historical warehouse receipt data and changes.

The Public Fund (公募基金) domain provides a comprehensive set of APIs for querying mutual fund data. The data is organized into several functional groups:

• Information & Identifiers (资料与标识): Search for fund companies and basic fund profiles to obtain necessary identifiers for subsequent requests.
• Market Data (行情): Access ETF historical daily lines or real-time market snapshots. Note that fund Net Asset Values (NAV) are located in the 'Net Value & Performance' group.
• Financial Statements & Indicators (财务报表与指标): Retrieve balance sheets, income statements, and financial indicators for specific reporting periods.
• Net Value & Performance (净值与业绩): Access NAV sequences, interval returns, drawdowns, and historical performance indicators.
• Holdings & Allocation (持仓与配置): Query asset allocation, industry allocation, top holdings, and historical stock/bond holdings. For historical data, you must first retrieve the relevant report dates.
• Holders (持有人): Analyze holder structures and the top ten holders.
• Fund Managers (基金经理): Get manager details, professional experience, investment styles, and performance metrics. Manager IDs can be obtained from fund profile data.
• Online Backtesting (在线回测): Query available indicators and execute backtesting based on specific conditions.
• General Indicators (通用指标): Retrieve indicators formatted for line charts or data tables.
• QDII Quota (QDII 额度): Access summaries and detailed lists of QDII quotas.
• News & Offerings (资讯与募集): Access fund news articles and lists of funds currently being offered or pending offering.
• Diagnostics & Corporate Actions (诊断与公司行动): Access fund diagnostic data and dividend records.