Cognivo Developer API
通过 Cognivo Developer API，你可以在自己的应用、机器人、仪表盘或后端中，调用与 Cognivo Chat、dApp 和 Telegram 机器人背后完全相同的链上情报能力。
- 基础 URL：
https://api.cognivolabs.io - 认证： 在 Developer 门户中自助创建的、带权限范围的 API 密钥
- 当前已上线的链： Ethereum（
eth）、Base（base）、BNB Smart Chain（bsc） - Solana： 即将支持（尚未上线）
- Webhook： 规划中（尚未上线）
- OpenAPI 规范： cognivo-public-api.yaml - 完整的机器可读规范，可导入 Postman、Insomnia 或 SDK 生成器
我能用它构建什么？
任何需要对代币或钱包做出快速、诚实判断的东西。一些具体的想法：
- 代币安全检查机器人 - 用户粘贴一个合约地址，机器人在一条消息里返回风险信号、流动性与锁仓情况，以及"为什么在跌"
- 钱包监控仪表盘 - 盯住金库、巨鲸或团队钱包：授权（approval）敞口、精确的近期资金动向、每个代币的已实现盈亏
- 社区 Telegram 或 Discord 工具 - 为你的社区提供一个
/check <token>命令，背后是与 Cognivo Chat 相同的情报能力 - 投资组合盈亏视图 - 基于有据可查的链上活动（而非自报数字）计算并展示用户每个代币的已实现盈亏
- 研究笔记本 - 把风险、流动性、团队钱包和资金动向数据拉进 Python 或 JavaScript 笔记本，用于代币研究和复盘
- 发现信息流 - 把 Discover 信息流中近期的高质量公开情报卡片呈现在你自己的应用或网站里
这个 API 不是什么
- 它不是原始节点/RPC 访问。你调用的始终是经过整理的 Cognivo 情报端点，原始链 RPC 绝不会被暴露或转售。
- 它不包含交易、订单执行或 MEV 工具。
- 结果是情报信号，不是投资建议，也不是保证。干净的结果绝不等于"安全"。
访问模型与定价
在早期访问阶段，Developer API 是受访问控制的。每个密钥都可以探索：阅读文档、调用 GET /v1/api/health、通过 GET /v1/api/me 查询自身信息，以及进行有限的沙盒/演示调用。实时情报端点需要试用、合作伙伴、付费或企业级访问权限。
- 付费使用按每次成功调用消耗 Cognivo 积分计费；失败的调用不收费。
- 沙盒（
cogv_test_）密钥用于集成测试：上限严格（25 次请求/小时，100 次/天），且仅在管理员启用后才能运行少量实时演示额度。 - 试用访问由管理员授予，有限且会过期。
- 企业级为定制方案：定价、更高的限额和按端点划分的访问权限。请在 Developer 门户申请访问。
在没有访问权限的情况下调用可执行端点，会返回明确的错误（例如 access_required、trial_expired 或 payment_required），而不是免费运行。各端点的积分费用公布在端点参考和速率限制页面。
隐私与数据安全
API 只返回公开的链上情报。响应中绝不会包含 Cognivo 账户标识、邮箱、余额或其他私密账户数据，无论是你的还是任何其他人的。
开始使用
- 使用你平时的 Cognivo 账户在 dapp.cognivolabs.io/en/developers 登录。
- 创建一个项目和一个 API 密钥（完整密钥只显示一次，请立即复制）。
- 按照快速开始操作。