Developers
How to use the API, authentication, limits and the MCP server. The spec is published as OpenAPI.
Authentication
Issue a key in your workspace and send it in the x-api-key header. The key is shown once; we store only its hash.
curl -H "x-api-key: cr_xxxxxxxx_..." https://api.cresearch.jp/v1/protocols?limit=10
Endpoints
| GET | Returns |
|---|---|
| /v1/market/overview | Market overview |
| /v1/assets | Assets |
| /v1/assets/{id}/metrics?metric=price | Time series |
| /v1/protocols | Protocols |
| /v1/protocols/{id} | Detail |
| /v1/chains | Chains |
| /v1/sectors | Sectors |
| /v1/macro | Macro |
| /v1/metrics | Metric definitions |
| /v1/sources | Sources and redistribution |
| /v1/research | Research index |
Limits and errors
- 429: per-minute or monthly limit reached (retryAfterSec included)
- 401: key missing or revoked
- Check x-ratelimit-limit and x-ratelimit-remaining headers
OpenAPI
The spec is served at /openapi.json.
https://api.cresearch.jp/openapi.json
MCP server
An MCP server for AI agents ships with the platform (beta). Run it locally and authenticate with your API key.
CR_API_KEY=cr_... node apps/api/src/mcp.ts