助手说 "this tool call needs an account key"（这次工具调用需要账户密钥）。

连接器里没有密钥，也没有登录。claude.ai 和 Claude Code 会为此显示登录提示：按提示操作即可（在 Claude Code 中输入 /mcp，再选 Authenticate）。否则，在 claude.ai 的连接器里选择 Sign in 或添加 x-api-key 请求头；在 ChatGPT 中选择 OAuth 或使用包含 ?key= 的地址；在 Claude Desktop 中检查 BYKARANTELI_API_KEY 的值。不带密钥可以列出工具，但不能调用工具。

"The account key this connection sent was not recognised"（无法识别此连接发送的账户密钥）。

复制密钥时少了一个字符或多了空格，或者密钥已被吊销。打开 Data & API（数据与 API），吊销它，创建一个新的，再粘贴一次。

claude.ai 要求填写 OAuth Client ID。

两种情况下 OAuth 字段都留空。选 Sign in 时 claude.ai 会自行注册，无需输入 id；选 No sign-in 时把密钥放进 x-api-key 请求头。

ChatGPT 保存了连接器，但一直没有回应。

通常是认证方式和地址不匹配：选 OAuth 时使用不带密钥的地址并登录；选 none 时 URL 必须包含 ?key= 和你完整的密钥。

我的脚本收到 401 "key required"。

请求到达网关时没有可用的密钥：没有密钥头、值为空（变量未设置）、不是完整密钥（示例中的 bk_... 占位符、密钥列表里的前缀）或 Authorization 头未使用 Bearer 方案；401 响应体中的 reason 字段会说明是哪一种。请以 Authorization: Bearer bk_...（或 x-api-key: bk_...）发送完整密钥。在我们自己的页面上，浏览器不需要密钥；程序始终需要。

429 "monthly quota"（月度配额）。

本月免费的 15,000 次调用已经用完。等到下个月 1 日，或者在价格页面升级到 Terminal 或 Builder。

429 "rate limit"（速率限制）。

一分钟内的调用太多。把速度降到 x-ratelimit-limit 给出的数字以内，或者等待 retry-after 给出的秒数。

我的密钥丢了。

密钥不能显示第二次。在 Data & API（数据与 API）吊销旧密钥，再创建一个新的；旧密钥会立即失效。

助手能修改我账户里的内容吗？

只能修改您的提醒、自选列表和追踪地址，而且只通过以下工具：create_alert_recipe、delete_alert_recipe、add_watchlist_symbol、remove_watchlist_symbol、add_tracked_address 和 remove_tracked_address。它们标注为写入操作，所以会确认更改的助手会先询问您。它们使用同一个密钥，计入您的套餐用量，每次更改都会记录在您的账户中，并立即显示在提醒、自选列表和追踪地址页面上。不会进行任何交易或资金转移。如需停止：如果它是登录连接的，请在 Data & API（数据与 API）的“已连接的应用”里断开它；如果它使用密钥，请在那里吊销它持有的密钥。

指南 · 无需任何经验

一步一步连接 AI 助手或你自己的程序

本站的所有数据都可以在站外使用：在 AI 助手（Claude、ChatGPT、Cursor）里，或在你运行的程序里。两种方式都从一个免费账户开始：claude.ai、ChatGPT 和 Claude Code 通过登录这个账户连接，其他方式使用免费的账户密钥。本页列出每一次点击，以及出问题时该怎么做。

写给从没创建过 API 密钥的人。如果你已经会了，直接跳到你所用工具的那一节。

打开数据与 API 查看方案完整开发者文档

1. 你要设置的是什么

通往同一份数据的两扇门，一把密钥两扇都能打开。

AI 助手之门（MCP）
MCP 就像一个插头，让 Claude 或 ChatGPT 这样的助手在你聊天时调用我们的数据。你问“现在 BTC 的资金费率是多少”，助手就从我们这里取回答案。托管版本无需安装任何东西：只要把一个地址粘贴到助手的设置里。
程序之门（API）
API 是一个地址，你自己的脚本、表格或机器人调用它，拿回 JSON 格式的数字。你发出一个附带密钥的请求，我们返回数据。
密钥
密钥是一串以 bk_ 开头的长密码，告诉我们是哪个账户在请求。免费账户带一个密钥和每月 15,000 次调用，AI 助手之门和程序之门共用这个额度。密钥只在创建时显示一次，请像密码一样保管。

2. 创建你的密钥（两分钟）

如果你在 claude.ai、ChatGPT 或 Claude Code 中登录连接（第 3、4、6 节），可以跳过这一步。密钥用于 Claude Desktop、Cursor、你自己的程序，以及不登录而设置的连接器。

登录或创建免费账户
点击右上角的“登录”按钮。新账户只需要一个邮箱地址：我们发给你一个链接，你点一下，就完成了。
打开 Data & API（数据与 API）
登录后，打开右上角的账户菜单，选择 Data & API（数据与 API）。在手机上，它在“我的”标签下。
创建密钥
向下滚动到 Keys（密钥）部分。输入一个能说明密钥用在哪里的名字，例如“我的笔记本”或“ChatGPT”，然后点击 Create（创建密钥）。
密钥只出现一次，显示在一个带 Copy（复制）按钮的框里。马上复制，粘贴到安全的地方。如果没复制就关掉了页面，也没有任何损失：吊销那个密钥，再创建一个。
密钥下方还有一个现成的托管 MCP 地址，密钥已经包含在里面。这个地址是给既不能登录、也不能添加请求头的工具用的。请像密钥一样保密。

3. claude.ai（网页版和手机版）

托管服务器：无需安装，也无需复制任何东西。你只需登录一次。

添加连接器
依次打开 Settings、Connectors、Add custom connector（添加自定义连接器）。
Name（名称）：ByKaranteli。URL：https://mcp.bykaranteli.com。
在 Authentication（认证）下选择 Sign in（now 或 when needed）。OAuth Client ID 和 Client Secret 留空：claude.ai 会自行在 bykaranteli.com 注册。保存。
登录并批准
如果 claude.ai 没有自动打开，点 Connect（连接）。会打开一个 bykaranteli.com 窗口：登录，或在那里创建一个免费账户。
同意页面会写明 claude.ai 以及它能做什么：使用数据工具，读取和修改你的提醒、自选列表和追踪地址，但永远不能修改你的账户、密钥或账单。点 Allow（允许）。
回到 claude.ai 后，连接器显示为已连接。它以你的账户和套餐运行。以后要断开，可以在 Data & API（数据与 API）的“已连接的应用”里操作，或在 claude.ai 中移除这个连接器。
或者改用密钥
在 Authentication（认证）下选择 No sign-in，打开请求头设置（有时在 Advanced 下面），添加一个请求头：名称填 x-api-key，值填第 2 节创建的密钥。保存。
请求头
```
x-api-key: bk_...your key...
```
试一试
开始一个对话，确认这个对话里 ByKaranteli 连接器已经打开，然后问：“给我看 BTC 的强平地图。”助手会列出我们的工具并调用它们。

4. ChatGPT

两种方式：用 OAuth 登录（无需复制任何东西），或把密钥放在地址里。

用登录方式添加连接器
依次打开 Settings、Connectors（有些账户在 Developer mode 下面）、Create。
Name（名称）：ByKaranteli。URL：https://mcp.bykaranteli.com。
Authentication（认证）：OAuth。客户端 ID 和密钥字段留空：ChatGPT 会自行在 bykaranteli.com 注册。保存后在 bykaranteli.com 窗口中登录，并在同意页面点 Allow（允许）。
或者把密钥放在地址里
Authentication（认证）：none（无）。URL：带有你密钥的地址，从 Data & API（数据与 API）复制。它看起来像下面这一行。保存。
URL
```
https://mcp.bykaranteli.com/?key=bk_...your key...
```
这个地址和密码一样重要。如果你把它贴到了公开的地方，请在 Data & API（数据与 API）吊销这个密钥，再创建一个新的。

5. Claude Desktop

Claude Desktop 会在你的电脑上运行一个小程序 bykaranteli-mcp。电脑上需要先安装 Node.js（nodejs.org，下载 LTS 版本）。

编辑配置文件
在 Claude Desktop 中依次打开 Settings、Developer、Edit config。会打开一个名为 claude_desktop_config.json 的文件。
把下面这段粘贴进去（如果文件里已经有 "mcpServers" 部分，就把 "bykaranteli" 这一项加到它里面）。把 bk_... 换成你的密钥。保存，然后重启 Claude Desktop。
claude_desktop_config.json
```
{
  "mcpServers": {
    "bykaranteli": {
      "command": "npx",
      "args": ["-y", "bykaranteli-mcp"],
      "env": { "BYKARANTELI_API_KEY": "bk_...your key..." }
    }
  }
}
```

6. Claude Code 和 Cursor

Claude Code（终端）
托管方式，登录连接：先用第一条命令添加服务器，然后在 Claude Code 中输入 /mcp，选择 bykaranteli，再选 Authenticate（认证）。浏览器会打开一个窗口；登录并点 Allow（允许）。
或者用密钥在你的电脑上运行这个程序包（需要 Node.js）：运行第二条命令。把 bk_... 换成你的密钥。
终端（托管，登录）
```
claude mcp add --transport http bykaranteli https://mcp.bykaranteli.com
```
终端（本地，密钥）
```
claude mcp add bykaranteli -e BYKARANTELI_API_KEY=bk_...your key... -- npx -y bykaranteli-mcp
```
Cursor 和其他编辑器
打开编辑器的 MCP 设置（Cursor：依次打开 Settings、MCP、Add），把下面这段粘贴到 mcp.json。任何接受 URL 加请求头的编辑器都是同样的做法。
mcp.json
```
{
  "mcpServers": {
    "bykaranteli": {
      "url": "https://mcp.bykaranteli.com/mcp",
      "headers": { "Authorization": "Bearer bk_...your key..." }
    }
  }
}
```

7. 从程序调用 API

不用助手，只用你自己的代码或表格。

不写代码，先试一次
Data & API（数据与 API）页面有一个调试台（Playground）：选一个端点，点击“发送”，查看返回的 JSON。它使用你浏览器的登录状态，所以什么都不用粘贴。
在终端里做同样的调用
/api/public/ 下的每个地址都返回 JSON。把密钥放在请求头里。把 bk_... 换成你的密钥。
curl
```
curl -s "https://bykaranteli.com/api/public/funding-heatmap" -H "Authorization: Bearer bk_...your key..."
```
看懂响应头
x-ratelimit-limit 和 x-ratelimit-remaining：你的方案每分钟允许多少次调用，这一分钟还剩多少次。
x-quota-limit、x-quota-used 和 x-quota-reset：你的月度额度、已经用了多少、什么时候重置。
所有端点、字段和示例的完整列表在开发者页面。

8. 用大白话讲额度

免费账户
每分钟 30 次、每月 15,000 次调用，AI 助手之门和程序之门合并计算。当月额度用完后，调用会返回 429（“请求过多”），直到下个月第一天（UTC）。网站上的每个页面照常可用。
如果你需要更多
免费密钥用于评估和个人用途：试用 API、个人脚本或 Jupyter 笔记本、查看数据。持续运行的任何程序，例如机器人、看板或轮询的代理，都需要一个方案：爱好者的机器人用 Terminal，会员深度的个人工具用 Builder，服务他人或产生收入的用途用 Business。
Terminal 是面向个人的会员（价格见定价页），把密钥提升到每分钟 60 次、每月 150,000 次，深度不变，并增加你不在时也在我们这一侧运行的工作台：提醒、看板会员深度与 LiqMap 工作区。
Builder（每月 49 美元）提供每分钟 300 次、每月 1,000,000 次（公平使用）、API 上的会员深度（LiqMap 全部时间周期、5 分钟序列），以及 x402 目录：每月 1,000 次调用，覆盖最近 90 天，仅汇总序列（每次调用还按 10 次请求计入每月公平使用）。Business 和 Scale 再增加商业许可、原始记录、更长的历史窗口、批量导出和实时数据流。
付费方案永远不会被停用：超出公平使用额度后，会按免费速度继续应答，直到当月重置。

9. 出问题时怎么办

下面每条消息都是我们有意发出的，每条都有解决办法。

助手说 "this tool call needs an account key"（这次工具调用需要账户密钥）。: 连接器里没有密钥，也没有登录。claude.ai 和 Claude Code 会为此显示登录提示：按提示操作即可（在 Claude Code 中输入 /mcp，再选 Authenticate）。否则，在 claude.ai 的连接器里选择 Sign in 或添加 x-api-key 请求头；在 ChatGPT 中选择 OAuth 或使用包含 ?key= 的地址；在 Claude Desktop 中检查 BYKARANTELI_API_KEY 的值。不带密钥可以列出工具，但不能调用工具。
"The account key this connection sent was not recognised"（无法识别此连接发送的账户密钥）。: 复制密钥时少了一个字符或多了空格，或者密钥已被吊销。打开 Data & API（数据与 API），吊销它，创建一个新的，再粘贴一次。
claude.ai 要求填写 OAuth Client ID。: 两种情况下 OAuth 字段都留空。选 Sign in 时 claude.ai 会自行注册，无需输入 id；选 No sign-in 时把密钥放进 x-api-key 请求头。
ChatGPT 保存了连接器，但一直没有回应。: 通常是认证方式和地址不匹配：选 OAuth 时使用不带密钥的地址并登录；选 none 时 URL 必须包含 ?key= 和你完整的密钥。
我的脚本收到 401 "key required"。: 请求到达网关时没有可用的密钥：没有密钥头、值为空（变量未设置）、不是完整密钥（示例中的 bk_... 占位符、密钥列表里的前缀）或 Authorization 头未使用 Bearer 方案；401 响应体中的 reason 字段会说明是哪一种。请以 Authorization: Bearer bk_...（或 x-api-key: bk_...）发送完整密钥。在我们自己的页面上，浏览器不需要密钥；程序始终需要。
429 "monthly quota"（月度配额）。: 本月免费的 15,000 次调用已经用完。等到下个月 1 日，或者在价格页面升级到 Terminal 或 Builder。
429 "rate limit"（速率限制）。: 一分钟内的调用太多。把速度降到 x-ratelimit-limit 给出的数字以内，或者等待 retry-after 给出的秒数。
我的密钥丢了。: 密钥不能显示第二次。在 Data & API（数据与 API）吊销旧密钥，再创建一个新的；旧密钥会立即失效。
助手能修改我账户里的内容吗？: 只能修改您的提醒、自选列表和追踪地址，而且只通过以下工具：create_alert_recipe、delete_alert_recipe、add_watchlist_symbol、remove_watchlist_symbol、add_tracked_address 和 remove_tracked_address。它们标注为写入操作，所以会确认更改的助手会先询问您。它们使用同一个密钥，计入您的套餐用量，每次更改都会记录在您的账户中，并立即显示在提醒、自选列表和追踪地址页面上。不会进行任何交易或资金转移。如需停止：如果它是登录连接的，请在 Data & API（数据与 API）的“已连接的应用”里断开它；如果它使用密钥，请在那里吊销它持有的密钥。

本页用到的词

API: 程序调用来取回数据的地址，这里返回的是 JSON 文本。
API 密钥: 以 bk_ 开头的长密码，每次调用时用来识别你的账户。
MCP: Model Context Protocol（模型上下文协议），让 AI 助手调用外部工具（比如我们的工具）的插头。
连接器（Connector）: claude.ai 和 ChatGPT 对你添加到账户里的 MCP 服务器的叫法。
请求头（Header）: 随请求一起发送的小标签；密钥就放在其中一个里。
登录（Sign in，OAuth）: 在 bykaranteli.com 上批准一次，把助手连接到你的账户；助手会获得自己的密钥，你不需要复制任何东西。
速率限制: 一个方案每分钟允许多少次调用。
配额: 一个方案每月允许多少次调用。

1. 你要设置的是什么

AI 助手之门（MCP）

程序之门（API）

密钥

2. 创建你的密钥（两分钟）

登录或创建免费账户

打开 Data & API（数据与 API）

创建密钥

3. claude.ai（网页版和手机版）

添加连接器

登录并批准

或者改用密钥

试一试

4. ChatGPT

用登录方式添加连接器

或者把密钥放在地址里

5. Claude Desktop

编辑配置文件

6. Claude Code 和 Cursor

Claude Code（终端）

Cursor 和其他编辑器

7. 从程序调用 API

不写代码，先试一次

在终端里做同样的调用

看懂响应头

8. 用大白话讲额度

免费账户

如果你需要更多

9. 出问题时怎么办

本页用到的词