HiThink-Tech/Financial-API

HiThink‑Tech / Financial‑API – 同花順金融データサービス

何であるか – 中国の市場データプロバイダー「同花順」(10 Juqka) が維持する商用レベルのデータプラットフォーム。AIエージェント、定量研究者、開発者向けに、A株（中国メインボード）市場データを一元化し、APIキー保護されたサービスを提供する。

主要機能

• 任意のA株ティッカーに対するリアルタイムスナップショット、集合入札スナップショット、および日足K線（OHLCV）。
• 企業全体の財務諸表（損益、貸借対照表、キャッシュフロー）および評価レシオのセット（PER、PBR、PSR、PCF）。
• メタデータ：ティッカー照会、取引カレンダー、企業行動、スプリット・ボーナス係数、前後調整価格。
• 市場全体のデータ：インデックス・セクター構成銘柄、ファンド・マネージャ情報、公開先物・オプション契約、および限額上昇/下落プール、「炸板」（突破）プール、人気株、龍虎榜ランキングなどの特別リスト。
• バックテストやファクター研究用のバルク市場ダンプダウンロード。
• ローカルにDuckDBベースのmarketdbを構築可能。全市場をインクリメンタルに同期でき、通常のSQLでクエリ可能。

アクセス方法

方法	一般的な用途	エントリポイント
REST API	Webサービス、アプリ、任意の言語に統合	https://fuyao.aicubes.cn/api/... (README内のcurl例参照)
MCP (Model‑Center‑Protocol)	Claude Desktop、Cursor、WindsurfなどLLM対応ツールに接続	6つのホストエンドポイント（A株、A株インデックス、メタ、ファンド、先物、オプション）
CLI (@hithink-tech/hithink-finance-cli)	ターミナルでの即時クエリ、バルクダウンロード、データダンプ、ローカルDuckDB初期化	hithink-finance … コマンド
Python SDK (python/ パッケージ)	ノートブック探索、カスタムスクリプト、pandas/NumPyとの統合	python -m pip install -e ./python でインストール後、toolkit/fuyao スクリプトを使用
エージェントスキル (skills/hithink-finance/)	AIエージェントが最適なバックエンド（API、MCP、CLI、SDK）を自動選択可能	npx skills add … でインストール

一般的なワークフロー

1. Webポータルから単一のAPIキーを取得し、安全に保管する（HITHINK_FINANCE_API_KEY）。
2. 最も便利なエントリポイントを選択する（スキル → エージェント、CLIで一時的、SDKでノートブック、RESTでサービス）。
3. ティッカーを一意の thscode（例：600519.SH）に解決する。
4. 必要なエンドポイント（スナップショット、K線、財務諸表など）を呼び出す。
5. 大規模な結果の場合、システムはローカルにファイル（DuckDBまたはCSV）として書き出し、呼び出し元にはパス/要約のみを返す。

誰が使うべきか

• AIエージェント（Claude、Cursorなど）：最新の市場データが必要な場合。スキルをインストールして、API、MCP、CLIの自動切り替えを可能にする。
• 定量研究者：バックテスト、ファクターモデル、ダッシュボード構築の際。CLIまたはmarketdbを使ってローカルのDuckDBコピーを保持し、SQLでクエリ可能。
• 開発者：取引指向のWebまたはモバイルアプリを開発する際。任意の言語でREST APIを直接呼び出す。
• データエンジニア：データレイクインジェスト用のバルク市場ダンプが必要な場合。

セキュリティとコンプライアンスの注意事項

• APIキーはハードコードしたり、ソースコード管理にコミットしてはならない。
• 大規模な結果セットはディスクに書き出すこと。サービスは巨大なJSONペイロードをストリーミングしないことでコンテキストオーバーフローを回避する。
• サービスは投資アドバイスを提供しない。呼び出し元は分析結果に「非アドバイス」ラベルを付ける必要がある。
• レートリミットはソフト（ハード制限なし）だが、バースト性の高い高同時接続トラフィックを避けるよう依頼されている。

プロジェクトの状態

• 活発にメンテナンスされているモノレポ（Python + Node.js CLI + スキル）。
• 最近のリリースでは集合入札データの追加、ファンドカバレッジの拡張、統合スキルの導入が行われた。
• 今後のロードマップには、近々リリース予定の同花順AIクライアントとの統合が含まれる。

ライセンス – MIT。

---

上記のすべての情報はリポジトリのREADMEから直接取得したものであり、追加機能は推測されていない。