Agent 模式

CryptoNav 提供公开 RESTful API,让 AI Agent 能够搜索、浏览和推荐加密货币与 AI 工具。

Skill FileBase URL: /api/v1
📦 统一响应格式

成功响应

{
  "success": true,
  "data": [...],
  "total": 100,
  "page": 1,
  "pageSize": 20
}

错误响应

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "资源不存在"
  }
}

🔌 API 端点

GET/api/v1/search

搜索工具(关键词 + 筛选)

参数类型必填说明
qstring必填搜索关键词
categorystring可选分类 slug 筛选
pricingstring可选free | freemium | paid
langstring可选zh | en | both
limitnumber可选每页数量(默认 20,最大 100)
pagenumber可选页码(默认 1)
GET/api/v1/categories

获取所有分类

参数类型必填说明
treeboolean可选是否返回树形结构(默认 false)
GET/api/v1/categories/:slug

获取分类详情(含子分类)

GET/api/v1/categories/:slug/sites

获取分类下的工具列表

参数类型必填说明
sortstring可选hot | latest | featured
pricingstring可选free | freemium | paid
langstring可选zh | en | both
limitnumber可选每页数量
pagenumber可选页码
GET/api/v1/sites

获取工具列表(支持筛选)

参数类型必填说明
qstring可选搜索关键词
categorystring可选分类 slug
pricingstring可选free | freemium | paid
langstring可选zh | en | both
limitnumber可选每页数量
pagenumber可选页码
GET/api/v1/sites/featured

获取精选工具

参数类型必填说明
limitnumber可选数量(默认 8,最大 50)
GET/api/v1/sites/latest

获取最新收录工具

参数类型必填说明
limitnumber可选数量(默认 8,最大 50)
GET/api/v1/sites/:slug

获取工具详情

GET/api/v1/tags

获取所有标签

参数类型必填说明
typestring可选chain | feature | pricing | language
POST/api/v1/sites/submit

提交新工具收录

参数类型必填说明
namestring必填工具名称
urlstring必填工具 URL
categoryIdnumber可选分类 ID
descriptionstring可选工具描述
logostring可选Logo URL
submittedByEmailstring可选提交者邮箱
POST/api/v1/agents/register

Agent 注册(获取 API Key)

参数类型必填说明
namestring必填Agent 名称
descriptionstring可选Agent 描述
homepagestring可选Agent 主页 URL

💡 使用示例

搜索免费 DeFi 工具
GET /api/v1/search?q=defi&pricing=free
浏览交易所分类
GET /api/v1/categories/cex/sites?sort=hot
获取精选工具
GET /api/v1/sites/featured?limit=5
获取工具详情
GET /api/v1/sites/uniswap
⚡ 速率限制
  • • 通用端点:60 次请求 / 分钟 / IP
  • • 搜索端点:30 次请求 / 分钟 / IP
  • • 所有 API 支持 CORS,可从任何域名调用