本文へ移動

開発者向け

API の使い方、認証、上限、MCP サーバー。仕様は OpenAPI で公開しています。

認証

会員ページで API キーを発行し、x-api-key ヘッダーで送ります。キーは発行時に一度だけ表示され、C Research はハッシュしか保存しません。

curl -H "x-api-key: cr_xxxxxxxx_..." https://api.cresearch.jp/v1/protocols?limit=10

主な入口

GET内容
/v1/market/overview市場の概要
/v1/assets資産の一覧
/v1/assets/{id}/metrics?metric=price時系列
/v1/protocolsプロトコルの一覧
/v1/protocols/{id}詳細
/v1/chainsチェーン
/v1/sectorsセクター
/v1/macro金利など
/v1/metrics指標の定義
/v1/sources出典と再配布の可否
/v1/researchリサーチの目録

上限とエラー

  • 429: 分あたりの上限か月の上限を超えた(retryAfterSec を返す)
  • 401: キーが無い、または失効
  • x-ratelimit-limit と x-ratelimit-remaining ヘッダーで残りを確認できる

OpenAPI

/openapi.json で仕様を配布しています。

https://api.cresearch.jp/openapi.json

MCP サーバー

AI エージェントから C Research のデータを使うための MCP サーバーを同梱しています(ベータ)。手元で動かし、API キーで認証します。

CR_API_KEY=cr_... node apps/api/src/mcp.ts