跳到主要内容

快速开始

从零到第一个真实的情报结果，大约只需一分钟：创建一个密钥，粘贴一条命令，读取答案。

1. 创建 API 密钥​

  1. 打开 Developer 门户，用你的 Cognivo 账户登录。
  2. 创建一个项目（例如 "My trading bot"）。
  3. 创建一个 API 密钥。选择它需要的权限（scope）。本快速开始需要授予 Token and wallet intelligence（intel:read）和 Liquidity reads（liquidity:read）。
  4. 立刻复制密钥。 它只显示一次，之后只能看到掩码版本（cogv_live_****abcd）。如果丢失，请轮换密钥。

密钥分为两种环境：

  • cogv_test_... - 用于在实时链上数据上做集成测试的沙盒密钥。上限严格（25 次请求/小时，100 次/天）；仅在管理员启用后才能运行少量实时演示额度。
  • cogv_live_... - 生产密钥。实时情报端点需要试用、合作伙伴、付费或企业级访问权限；参见访问模式。

2. 检查你的密钥​

curl 'https://api.cognivolabs.io/v1/api/me' \
  -H 'X-API-Key: YOUR_API_KEY'

你会得到掩码后的密钥、项目、环境、权限范围和每小时速率限制。

3. 试一个真实端点（curl）​

情报端点使用带 JSON 请求体的 POST。下面这条命令会对一个真实的 Base 代币（RWA Inc，我们在演示中使用的公开合约）执行一次真实的流动性检查。它只对具有访问权限的密钥执行：管理员已启用实时演示额度的沙盒密钥，或具有试用、合作伙伴、付费或企业级访问权限的密钥：

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"}'

有访问权限时，你应该会看到 "ok": true，data 中包含代币身份（名称/符号）、市场快照以及 LP/锁仓情况。meta.credits_charged 显示本次调用的费用：在沙盒演示或试用额度下为 0，在付费使用下则是该端点的积分价格（流动性为 2 积分）；失败的调用永远不收费。没有访问权限时，调用不会免费运行：它会返回明确的 403 错误（例如 access_required），你可以在门户中申请试用或企业级访问。准备好后，把 address 换成 eth、base 或 bsc 上任意代币合约即可。

保管好你的密钥

绝不要把真实的 API 密钥粘贴到公开仓库、聊天或客户端代码中。密钥只在创建时显示一次；如果泄露，请在门户中轮换。

4. 用 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, // never hardcode keys
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ chain: "base", address: "0xTOKEN_CONTRACT" }),
});
const json = await res.json();
if (json.ok) {
  console.log(json.data);        // the intelligence result
  console.log(json.meta.request_id); // keep for support/debugging
} else {
  console.error(json.error);
}

5. 响应结构​

每个端点都用相同的信封（envelope）结构应答：

{
  "ok": true,
  "data": { "...": "the result" },
  "meta": {
    "chain": "base",
    "request_id": "capi_...",
    "credits_charged": 0,
    "generated_at": "2026-07-08T00:00:00.000Z"
  }
}

失败时：

{ "ok": false, "error": "invalid_chain", "request_id": "capi_..." }

保护好你的密钥​

  • 只从服务器调用 API，绝不要在浏览器或移动端客户端代码中调用。
  • 把密钥存放在环境变量或密钥管理器中。
  • 如果密钥可能已泄露，请在门户中吊销或轮换。旧密钥会在一分钟内失效。