Developer API 概览

Developer API 是什么

Cognivo Developer API 让你可以在自己的代码中调用与 Cognivo Chat、dApp 和 Telegram 机器人背后相同的链上情报。你创建一个项目，创建一个 API 密钥，然后通过普通的 HTTPS 发送请求。

当你希望在自己正在构建的产品里、而不是在 Cognivo 里获得 Cognivo 的答案时，就用它。常见场景：

它不是原始节点或 RPC 访问。你调用的始终是经过整理的 Cognivo 端点。这里没有交易、下单执行或 MEV 工具。返回的结果是情报信号，不是投资建议，而且一个干净的结果绝不代表某个代币是安全的。

在 dApp 中打开侧边栏，依次进入 Account 和 Developers。直达链接是 dapp.cognivolabs.io/en/developers。你需要用你常用的 Cognivo 账户登录。未登录时，该页面只显示一个介绍界面，没有项目也没有密钥。

页面顶部的卡片包含了完成第一次调用所需的三样东西：

Base URL： https://api.cognivolabs.io。在它后面加上端点路径即可发起请求。
Auth： 在每个请求的 X-API-Key 头中发送你的 API 密钥。请把密钥保存在你的服务器上，绝不要放进浏览器代码里。
Chains： 页面显示 Ethereum、Base 和 BSC 已上线，以及 更多链即将推出。有些端点支持的链比其他端点少，具体请见端点参考。

同一张卡片还链接到这份文档，以及可供机器读取的 OpenAPI 规范，你可以把它导入 Postman、Insomnia 或 SDK 生成器。

页面本身有四个标签页：Quickstart、Keys、Endpoints 和 Usage。Endpoints 是一份参考文档，附带可复制的示例和每次调用的价格。页面上没有实时运行器，因此你在那里阅读的内容不会产生任何花费。

正式密钥是自助创建的。创建之后立即可用，无需申请，也没有审批队列。门户直白地说明了这个模式：有些端点凭任何有效密钥即可免费使用，另一些则需要付费或企业级访问权限，并按每次成功调用从你的 Cognivo 积分余额中扣费。

正式密钥（cogv_live_）用于发起真实调用。每次成功调用都会按该端点公布的价格以 Cognivo 积分计费。失败的调用永远不收费。目前 Developer API 调用的计费处于关闭状态，因此成功调用不会扣除任何积分，你的余额也不会变化。
测试密钥（cogv_test_）在门户中标记为 Test。它们的限额很严格，适合试用 API，而不适合真实流量。
每个密钥都会在 Keys 标签页显示它的访问模式，例如 Paid、Trial、Partner、Sandbox、Enterprise 或 Request access。处于 Request access 状态的密钥必须先获批才能调用付费端点，而被 Suspended 的密钥无法调用任何内容。门户会显示原因。
Enterprise 是唯一需要你申请访问权限的路径，用于定制的价格和限额。Enterprise access 按钮会打开支持流程。

积分来自你在 Cognivo 各处使用的同一个余额，每个账户每天获得 5 个免费积分，并在 UTC 午夜重置。如果你的余额不足以支付一次调用，你会收到 402 错误，错误码为 payment_required，并且不会扣费。充值后再试一次。余额的运作方式请见账单与积分。

GET /v1/api/health 免费且无需密钥。GET /v1/api/me 凭任何有效密钥免费使用。GET /v1/api/discover 免费，但每日上限很严格。各端点的价格见端点参考和速率限制、错误与计费。

响应中只包含公开的链上情报。它们绝不会包含 Cognivo 账户标识、邮箱、余额或其他私密账户数据，无论是你的还是别人的。唯一的例外是 GET /v1/api/me，它会报告调用方密钥自身的积分余额，方便你监控开销。

某个字段为空或值为未知，表示 Cognivo 无法在这条链上为这个代币或钱包核实该项内容。这并不意味着该项不存在，也不意味着对象是干净的。请把缺失的结果视为未经核实，如果需要跟进，请使用响应中的请求 ID。