開発者向け
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