Skip to content

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

GETReturns
/v1/market/overviewMarket overview
/v1/assetsAssets
/v1/assets/{id}/metrics?metric=priceTime series
/v1/protocolsProtocols
/v1/protocols/{id}Detail
/v1/chainsChains
/v1/sectorsSectors
/v1/macroMacro
/v1/metricsMetric definitions
/v1/sourcesSources and redistribution
/v1/researchResearch 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