快速开始
你的第一次 Cognivo API 调用
Cognivo 开发者 API 让你自己的代码可以提出与 dApp 和 Cognivo 聊天 中相同的链上问题。本页走的是最短的一条路径：创建项目，创建密钥，运行一次真实调用，读取答案。
何时使用
当你想把代币、钱包或流动性检查放进自己正在做的东西里时，就用 API，比如交易机器人、内部看板、告警任务或后端服务，而不必每次都在 dApp 里点来点去。如果你只想手动跑检查，dApp 和 Chat 已经能做到，你并不需要密钥。
在哪里找到它
登录 dApp，在侧边栏打开 账户，然后选择 Developers。未登录的访客只会看到一个介绍页面，所以请先登录。本页涉及的所有操作都在这一个页面上完成。
先创建项目，再创建密钥
项目把你的 API 密钥和它们的用量归拢在一起，所以从这里开始。
- 点击 New project，在项目选择器下方展开这个简短表单。
- 在 Project name 中输入一个名称，方便你以后区分不同项目。
- 点击 Create 添加项目，或点击 Cancel 关闭表单且不保存。
- 点击 Create live key 为该项目生成一个密钥，然后在你自己的代码中随请求一起发送。
项目名称只是给你自己看的标签。它不会出现在你的请求里，你可以创建多个项目，上限以页面上显示的为准。
当你选择 创建正式密钥 时，Cognivo 会在一个带复制按钮的对话框中完整显示密钥，且仅此一次。请当场复制并妥善保存。之后页面只会显示掩码版本，也就是前缀和最后四个字符，因为 Cognivo 以一种无法反读的形式存储密钥。如果你弄丢了密钥，或者认为它已泄露，请在密钥所在行使用 轮换 或 吊销。旧密钥会立即停止工作。
每个密钥还带有 权限，用来控制它能调用什么：情报、安全 和 Liquidity。只给密钥它真正需要的权限。下面的示例需要 Liquidity。
同一张卡片上还有两个按钮。充值积分 会带你去账单页面。企业级访问 会打开支持流程，它是唯一需要提交申请的路径，用于定制定价或更高的限额。普通的正式密钥无需审批，创建后立即可用。
运行示例调用
打开 快速开始 标签页。里面有一个可以直接复制运行的示例，你不用自己写任何东西。
测试密钥与正式密钥 卡片解释了两者的区别。测试密钥发起的是限额很紧的安全调用，适合用来打通链路。正式密钥发起的是真实调用，会从你的 Cognivo 积分余额中扣费。测试一个正式端点 卡片则给出五个编号步骤和命令本身，并配有复制图标。
这条命令是对一个真实 Base 合约的真实流动性检查：
curl -X POST 'https://api.cognivolabs.io/v1/api/intel/liquidity' \
-H 'X-API-Key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"chain":"base","address":"0xe2b1dc2d4a3b4e59fdf0c47b71a7a86391a8b35a"}'
同样的调用，用 JavaScript 或 TypeScript 写：
const res = await fetch("https://api.cognivolabs.io/v1/api/intel/liquidity", {
method: "POST",
headers: {
"X-API-Key": process.env.COGNIVO_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({ chain: "base", address: "0xTOKEN_CONTRACT" }),
});
const json = await res.json();
if (json.ok) {
console.log(json.data);
console.log(json.meta.request_id);
} else {
console.error(json.error);
}
返回的内容
每个端点都用同一种信封结构作答，快速开始标签页上的 预期响应 代码块就展示了它：
{
"ok": true,
"data": { "identity": { "name": "...", "symbol": "..." }, "marketSnapshot": {} },
"meta": {
"chain": "base",
"request_id": "capi_...",
"credits_charged": 0,
"generated_at": "..."
}
}
data 里是结果。meta.request_id 值得记录下来，因为支持团队可以凭它查到某一次具体调用。meta.credits_charged 精确告诉你这次调用花了多少。
某个字段可能返回为空、未知或不可用。这表示 Cognivo 无法从它能触及的数据中核实该项，而不是说那里什么都没有。请把它读作"未确认"，不要把安静的结果当成一切正常。Cognivo 报告的是它检查了什么、发现了什么，响应中的任何内容都不能证明某个代币是骗局，也不能证明某个代币是安全的。
失败的调用返回的 ok 为 false，并带有一个 error 代码和一个 request_id。失败的调用不收费。
费用、网络与限额
- 有些端点用任意有效密钥都免费。其他端点按每次成功调用从你的 Cognivo 积分余额中扣费。端点 标签页列出了每个端点及其 Cognivo 积分价格，免费的会标为 Free，所以在基于某个端点开发之前请先在那里查看。
- 你只为成功的调用付费，
meta.credits_charged会确认具体金额。错误、超时和被拒绝的调用都不花钱。 - 每个账户每天获得 5 个免费积分。它们在 UTC 午夜重置，并且会在任何付费积分之前被使用。
- 目前 API 在共用的
chain参数中覆盖 Ethereum、Base 和 BNB Chain，并通过一个专属端点覆盖 Robinhood Chain。有些端点支持的网络比其他端点少。 - 测试密钥的上限卡得很紧，它不是免费的生产层级。密钥 标签页上的每一行都会显示 Cognivo 当前对该密钥实际施加的限额，它可能低于该层级的默认值。
- 被暂停的密钥，或处于被暂停项目中的密钥，无法运行任何东西，门户会显示原因。
保管好你的密钥
请从服务器调用 API，绝不要从浏览器或移动端应用代码中调用。把密钥放在环境变量或密钥管理服务里，绝不要放进公开仓库、聊天消息或截图中。如果某个密钥可能已泄露，请在 密钥 标签页轮换或吊销它。
下一步
阅读 认证与 API 密钥 了解完整的权限和密钥管理，阅读 端点参考 了解每个调用返回什么、花费多少，阅读 速率限制与错误 了解重试和错误代码。关于你的积分余额和充值，参见 账单与积分包。