1. プロジェクト概要
Financial-APIは、HiThink公式のA株（中国本土株式市場）金融データサービスです。AIエージェント、クオンツ研究者、アプリケーション開発者に対して、リアルタイムおよび過去の市場データ、財務諸表、バリュエーション、指数、セクター、投資信託情報を、複数のデータベンダーをつなぎ合わせることなく、単一の統一された方法で照会できるようにします。
2. 背景と位置づけ
HiThink（同花順）は、中国の主要な金融データ・取引ソフトウェアプロバイダーであり、自社の内部市場データ基盤を開発者に優しい標準化されたインターフェースを通じて公開するために本プロジェクトを構築しました。中核となる使命は、1つのAPIキーであらゆるアクセス方法（REST呼び出し、AIチャットツール向けMCPサーバー、スクリプト作成向けCLI、リサーチノートブック向けPython SDK、すぐに使えるAgent Skill）を利用できるようにし、チームがユースケースごとに個別の統合を記述・保守する必要をなくすことです。
一般的なオープン金融データラッパーと一線を画すのは、AIエージェントファーストの設計です。インストール可能なAgent SkillとネイティブMCPサポートを最初から同梱し、LLMワークフローにおけるモックデータの回避とコンテキストオーバーフローへの配慮を明確にし、グローバル取引所を汎用的にカバーするのではなく、中国A株市場に特化して深く焦点を当てています。
3. 機能カテゴリ
📈 マーケットデータ — リアルタイム相場、K線（ローソク足）履歴、出来高、オークションスナップショット。例：最新価格照会、日中ティックデータ、過去の日足・分足、寄付前オークションスナップショット。
📊 財務諸表とバリュエーション — 分析とスクリーニングのための企業ファンダメンタルズ。例：損益計算書、貸借対照表、キャッシュフロー計算書、バリュエーション指標（P/E、P/B、P/S、P/CF）。
🔥 特殊市場指標 — A株市場の取引メカニズムに固有のデータ。例：ストップ高・ストップ安銘柄一覧、板破り追跡、市場異常、注目株リスト、ドラゴン・タイガー（上位トレーダー）ランキング。
🏦 指数とセクター — マクロ分析とテーマ分析のためのグループ化された市場ビュー。例：指数構成銘柄、セクターパフォーマンス、セクターローテーションデータ。
💰 投資信託とETF — 株式と並ぶファンド側のデータ。例：ファンド保有銘柄、ファンドの過去パフォーマンス、ETF/LOF市場相場。
🗄️ ローカルデータ基盤 — オフラインでの大規模分析のためのツール。例：全市場データセットのダウンロード、marketdbによるローカルDuckDBデータベース構築、ローカル保存された市場データへのSQL照会。
4. 主な特徴
- 7つのアクセス方法、1つのAPIキー — Skill、MCP、REST API、CLI、Python SDK、marketdb、直接JSON APIのすべてが、同じ統一された
HITHINK_FINANCE_API_KEYで認証されます。 - ネイティブMCPサポート — Claude Desktop、Cursor、Windsurfに直接接続し、AIアシスタントが会話形式で金融データを照会できるようにします。
- インストール可能なAgent Skill — ワンコマンドの
npx skills addインストールにより、コーディングエージェントに統一インターフェースを提供し、与えられたリクエストに適したバックエンドを自動的に選択します。 - ローカルDuckDB統合（
marketdb） — 永続的なローカルデータベースの構築と照会をサポートし、リモートAPIに負荷をかけずにバックテストを繰り返す場合に有用です。 - モックデータ不使用ポリシー — データが利用できない場合は値を捏造するのではなく明示的に報告します。これはリサーチや取引に近いワークフローにおいて重要です。
- A株への深い特化 — ストップ高銘柄一覧やドラゴン・タイガーランキングなどの指標は、汎用的なグローバル株式ラッパーではなく、中国市場のミクロストラクチャーへの深い精通を反映しています。
5. ロール別ユースケース
一般開発者 — データパイプラインをゼロから構築することなく、REST API経由で株式相場、財務データ、ファンドデータをWeb/モバイルアプリに統合します。
データ・リサーチサイエンティスト / クオンツ — Python SDKとmarketdbを使用して過去データを取得し、ローカルDuckDBデータセットを構築し、ノートブック上で直接バックテストやファクターリサーチを実行します。
AI/エージェント開発者 — Agent SkillをインストールするかMCPサーバーを設定して、LLMベースのエージェントがライブデータで金融の質問に答えたり、リサーチタスクを自動化したりできるようにします。
6. はじめに
必要なものを見つける — ドキュメントハブでREST APIコントラクトとガイドを参照してください：
https://fuyao.aicubes.cn/docs/
インストールと統合 — ワークフローに合ったアクセス方法を選択してください：
# AIエージェント / コーディングアシスタント統合
npx skills add HiThink-Tech/Financial-API --skill hithink-finance -g --yes
# コマンドラインツール
npm install -g @hithink-tech/hithink-finance-cli
hithink-finance auth login
# Python SDK
python -m pip install -e ./python
まずhttps://fuyao.aicubes.cn/admin/で統一APIキーを登録し、環境変数HITHINK_FINANCE_API_KEYとして設定してください。
貢献する — リポジトリはモノレポとして構成されています。GitHubでプルリクエストを開く前に、ドキュメントとパッケージ固有のREADME（hithink-finance-cli/README.md、python/README.md、skills/hithink-finance/SKILL.md）を確認してください。
7. プロジェクト構成
docs/ APIコントラクトと中央ドキュメントハブ
api/ REST APIコントラクトソース
skills/
hithink-finance/ インストール可能なAgent Skill（統一コントラクト）
hithink-finance-cli/ Node.js CLI（Python SDKから独立）
python/
marketdb/ オフライン照会用ローカルDuckDBインターフェース
toolkit/fuyao/ リモートデータクライアントとヘルパースクリプト
examples/ 実行可能な使用例
tests/ テストスイート
examples/ 追加のインスピレーションギャラリーと静的サンプル
scripts/ リポジトリ保守ユーティリティ
8. 関連エコシステム
Financial-APIはModel Context Protocol（MCP）と統合されており、Claude Desktop、Cursor、Windsurfから直接利用できます。marketdbモジュールを通じてローカルデータ保存にDuckDBを基盤としています。基盤となるデータプラットフォームはfuyao.aicubes.cnでホストされており、APIキー管理コンソールと完全なドキュメントサイトも提供しています。
9. ライセンス
✅ MITライセンスの下で、商用製品を含め、使用、複製、改変、統合、公開、配布が自由です。
✅ プロプライエタリまたはクローズドソースのアプリケーションに組み込むことができます。
❌ 無保証であり、作者は使用によって生じた損害に対して責任を負いません。
ℹ️ 基盤となる金融データへのアクセスにはHiThink APIキーが必要であり、コード自体のMITライセンスとは別に、HiThink独自のAPI利用規約が適用されます。
ℹ️ 本サービスは明示的に投資助言ではありません。出力は金融アドバイスとして扱うべきではありません。
10. よくある質問
Q: 統合方法ごと（REST、CLI、MCPなど）にAPIキーが必要ですか？
A: いいえ。https://fuyao.aicubes.cn/admin/で取得した単一のHITHINK_FINANCE_API_KEYが、7つのアクセス方法すべてで機能します。
Q: AIエージェントを構築する場合、どのアクセス方法を使うべきですか？
A: 統一インターフェースにはAgent Skill（npx skills add HiThink-Tech/Financial-API --skill hithink-finance -g --yes）を使用してください。Claude Desktop、Cursor、Windsurfで直接作業している場合はMCPサーバーを使用してください。
Q: 毎回APIを呼び出す代わりにデータをローカルに保存できますか？
A: はい。Python SDKのmarketdbモジュールを使用してローカルDuckDBデータベースを構築し、それに対してSQLクエリを実行できます。
Q: これは中国A株に限定されていますか、それともグローバル市場をカバーしていますか？
A: 本サービスは中国A株市場に特化しており、ストップ高・ストップ安銘柄一覧やドラゴン・タイガーランキングなどの市場固有の指標を含みます。
Q: 要求されたデータが利用できない場合はどうなりますか？
A: 本サービスはモックや捏造された値を返すのではなく、データが利用できないことを明示的に報告します。
11. クイックリンク
- リポジトリ: https://github.com/HiThink-Tech/Financial-API
- ドキュメントハブ: https://fuyao.aicubes.cn/docs/
- APIキー管理: https://fuyao.aicubes.cn/admin/
- ウェブサイト: https://fuyao.aicubes.cn/
12. まとめ
Financial-APIは、HiThinkのA株市場データ基盤を、開発者、クオンツ、AIエージェントがそれぞれに適した形式（REST、CLI、Python、MCP、またはプラグアンドプレイのAgent Skill）で利用できる、単一の一貫して認証されるサービスにパッケージ化します。複数のベンダーをつなぎ合わせることなく、信頼性が高く整然としたデータを必要とする中国市場向け金融アプリケーションやAIリサーチエージェントを構築するチームにとって最も価値があります。