开发者 API

REST v1

通过 REST API 获取 CryptoJam 市场数据。

加密货币

USD 价格、市值和成交量。

GET/api/v1/developer/coins

请求参数

参数	类型	说明
`page`	integer	页码，从 1 开始
`pageSize`	integer	结果数量，1–250
`search`	string	币种名称或代号
`sort`	string	rank, price, marketCap, volume24h, change24h
`order`	string	asc 或 desc

响应字段及分页

响应包含 data 和 meta。主要字段为 id、slug、name、symbol、rank、priceUsd、change24h、marketCapUsd、volume24h、updatedAt 和 source。不可用价格为 null。默认每页 50 项。代号不唯一，请使用 id 或 slug。

价格历史

特定加密货币已存储的报价。

GET/api/v1/developer/history/{slug}

请求参数

参数	类型	说明
`range`	string	24h, 7d, 30d, 90d, 1y, all, max
`from / to`	string	自定义范围，ISO 8601
`granularity`	string	1d 或 tick

历史覆盖范围和来源

每个数据点包含 timestamp、priceUsd 和可用的附加指标。日期使用 UTC。all 范围指本地存储的全部历史，其起点可能与币种发行日期不同。

检查 meta.coverageStart、meta.coverageEnd、meta.source、meta.gaps、meta.truncated 和 meta.isDemo。响应截断时请请求较短的时间区间。USD 和 USDT 报价分别存储。

关于市场数据

授权和请求示例

在 X-API-Key 请求头中发送密钥。请将其保存在应用的服务器上。

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://cryptojam.net/api/v1/developer/history/bitcoin?range=30d"

market:read加密货币目录history:read价格历史

尝试请求

OpenAPI

示例结构JSON

{
  "data": [
    {
      "timestamp": "2025-01-01T00:00:00.000Z",
      "priceUsd": 93429.20,
      "source": "coingecko"
    }
  ],
  "meta": {
    "source": "coingecko",
    "coverageStart": "2025-01-01T00:00:00.000Z",
    "gaps": [],
    "isDemo": false
  }
}

我的 API 密钥

登录以创建密钥

管理市场和历史数据访问权限。

或

访问权限和限制

访问受限

数据提供目前已禁用。请求返回 503，仍可创建密钥。

访问详情和错误

确认提供商的数据再分发权后将启用数据提供。CoinGecko 是默认许可的提供商。Coin Metrics Community 数据不包含在开发者 API 中。

每日配额使用 UTC。X-RateLimit-Limit 和 X-RateLimit-Remaining 显示上限和剩余请求数。

400: 参数无效
401: 密钥缺失或无效
403: 权限不足
404: 未找到资源
429: 超出请求上限
503: 数据不可用

错误在 error 对象中包含 code 和 message。收到 429 响应后，若存在 Retry-After 请求头，请按照它重试。

联系 [email protected]