你的第一条调用只有一行:
Bitculator 上的每个图表、表格和仪表都运行在一个数据引擎上:实时价格大约每分钟刷新一次,跨交易所的数千个市场、情绪指标、技术指标、清算、全球市场历史数据。
今天我们正在开启这个引擎。 Bitculator Data API 已上线 - 一个 Bearer 身份验证的 JSON API,拥有 85 个端点,分布在 15 个分组,一个免费层,以及 19 种语言的文档。
你的第一条调用只有一行:
curl "https://bitculator.com/api/v1/coins?per_page=5" \\ -H “Authorization: Bearer YOUR_API_KEY”
{ "data": [ { "rank": 1, "name": "Bitcoin", "symbol": "BTC", "price": "67412.83451201", "..." : "..." } ], "meta": { "current_page": 1, "per_page": 5, "..." : “..."} }
在你的 开发者控制台 中创建一个密钥,这个调用现在就能工作。
你可以获取的内容
该 API 被组织成 15 个资源组,平台显示的所有内容都包含在其中:
- 币币与价格 - 完整的资产目录、实时行情、历史价格、OHLC、供应数据。
- 市场与交易所 - 我们跟踪的各场所的交易对、行情、成交量及交易所详情。
- 钱包 - 带有规格和支持资产的钱包目录。
- 全球市场 - 总市值、成交量与主导地位,包括历史序列。
- 情绪与指标 - 恐惧与贪婪、牛熊态势信号,以及每个资产的技术指标(RSI、移动均线等)。
- 清算 - 多单/空单清算数据。
- 换算与计算器 - 基于实时汇率的加密货币↔法币换算,以及平台的计算接口。
- 编辑内容 - 文章与术语表内容。
- 警报与网络钩子 - 通过 API 创建价格警报,并在触发时接收带签名的 webhook 投递。
- 元数据 - 使用量、计划和可机器读取的规范。
完整参考,包含每个端点的可执行示例,位于 API 文档。
按你想要的方式构建
我们在设计上坚持的几个决策:
- 小数字符串的精度。 价格、汇率和供应量以 字符串 形式返回,而非浮点数。浮点数无法可靠地表示 0.00000001842,因此我们不去强求。你的解析器会保留市场产生的每一个数字。
- 一个信封、处处皆有。 成功响应是 { data, meta }; 每个 4xx 或 5xx 的错误都是 { "error": { "code", "message", "details" } }。根据 error.code 进行匹配:消息可能会改写,但代码保持稳定。
- 你的配额随每次响应而变化。 X-Quota-Limit、X-Quota-Used 和 X-Quota-Reset 头在每次调用时返回,因此你永远不必猜测自己的状态——当然你也可以只 GET /usage。
- 可预测的限制。 per_page 上限是基于计划设定的,超过上限将返回真实的 422。API 从不在不告知的情况下截断你的请求并返回你没有请求的内容。
- 带签名的网络钩子。 警报投递带有 Stripe 风格的 X-Bitculator-Signature 头部,你可以在信任有效载荷之前验证真实性。
- 公开规范。 整个接口在 OpenAPI 规范 中有描述,文档还提供现成的 Postman 集合。
从免费开始的计划
数据 API 拥有自己独立的月度配额,独立于 Bitculator 的嵌入式小部件。免费层无需卡信息——获取密钥并开始构建。付费计划会提升每月调用额度以及 per_page 上限;详情和当前价格请见 数据 API 页面。
不想手动处理 HTTP?这里有一个 SDK
除了 API,我们还提供 八个官方、MIT 授权的 SDK——TypeScript、Python、PHP、Go、Rust、Java、C# 和 C++——每个都覆盖全部 85 个端点,具备自动分页、类型化错误、智能重试以及内置的十进制字符串保证。所有八个 SDK 的安装命令、图标和仓库链接都在 API 页面的 SDK 部分,并且源码在 github.com/bitculator 开源。不过需要明确的是:你不需要 SDK。这只是纯 HTTP,带 Bearer 头——curl、fetch、requests 或 Guzzle 的工作方式与你预期的一样。


