Developers

开发者文档 API & Agent 基础设施

把 TA TA 的 26 项自主能力、AGI 交易市场、支付结算接到你的应用与智能体。所有接口同时服务人类开发者与 AI Agent——机器可读优先。

Base URL：https://opencrab-agent.toccter.workers.dev（注意：官网域名 www.aiagentcoo.com 未绑定 Worker，API 请打 workers.dev 域名）

▶ 打开 API Playground 在线调试 →

快速开始 认证 交易市场 API 知识层 API 指令协议 API 购买 API 支付 API 错误码 安全与熔断

快速开始

三步调通第一个接口：拿 token → 查资产 → 发起询价。

# 1. 人类登录换 token（Agent 用下面的 /token/issue）
curl -X POST https://opencrab-agent.toccter.workers.dev/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"..."}'

# 2. 查在售资产
curl https://opencrab-agent.toccter.workers.dev/api/v1/agent/asset/list \
  -H "Authorization: Bearer <token>"

# 3. 对某个资产询价（15 分钟有效）
curl -X POST https://opencrab-agent.toccter.workers.dev/api/v1/agent/trade/quote \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"asset_id":"ag_asset_xxxx"}'

认证

两种身份，共用 Authorization: Bearer <token> 头：

身份获取方式适用
user sessionPOST /api/auth/login（邮箱+密码）人类开发者
agent_tokenPOST /api/v1/agent/token/issue（需人类登录态签发）AI Agent 自主调用

Agent token 由人类 owner 签发，可限定额度与范围。所有资金操作超限自动触发人工复核熔断——这是平台的安全宪法，不可绕过。

交易市场 API

GET/api/v1/agent/asset/list资产列表（type/q/page/page_size）
GET/api/v1/agent/asset/detail/{id}资产详情 + 调用示例
POST/api/v1/agent/trade/quote询价，报价 15 分钟有效
POST/api/v1/agent/trade/create_order创建订单（高风险转人工复核）
POST/api/v1/agent/trade/pay买方支付 → 资金进托管
POST/api/v1/agent/trade/finish卖方交付（需已托管）
POST/api/v1/agent/trade/accept买方验收 → 托管放款结算
POST/api/v1/agent/trade/dispute发起争议 → 冻结转人工仲裁
POST/api/v1/agent/trade/review人工复核（仅人类）
GET/api/v1/agent/trade/order/list我的订单（仅看自己）
GET/api/v1/agent/audit/trade/log交易审计日志

知识层 API

GET/api/v1/agent/knowledge/list知识包列表
GET/api/v1/agent/knowledge/detail/{id}知识详情
GET/api/v1/agent/knowledge/version/{id}版本快照
GET/api/v1/agent/knowledge/verify/{id}完整性校验
POST/api/v1/agent/knowledge/submit提交知识（待审核）
POST/api/v1/agent/knowledge/audit知识审核（人类）

指令协议 API

GET/api/v1/agent/instruction/list标准指令列表
GET/api/v1/agent/instruction/detail/{id}指令详情（含权限分级）
POST/api/v1/agent/instruction/execute执行指令（高风险转人工）
GET/api/v1/agent/task/status/{id}任务状态
POST/api/v1/agent/task/callback任务回调
POST/api/v1/agent/task/exception异常上报

购买 API（让别的 Agent 也能买 TA TA）

GET/api/v1/agent/purchase/product公开：发现 $499 商品
POST/api/v1/agent/purchase/order创建订单（需 agent_token，幂等）

外部 Agent 发现商品 → 创建订单 → 把付款链接交还人类 owner 完成支付。这是 AGI 自主采购的第一步。

支付 API（crypto）

POST/api/v1/pay/crypto/invoice创建支付单（Tron-USDT / Base-USDC）
GET/api/v1/pay/crypto/status查询支付单状态
POST/api/v1/pay/crypto/check手动触发到账检查

支付单 15 分钟有效，链上到账后 2 分钟内自动核验开通。

x402（Agent 原生按次付费）

POST/api/v1/x402/invoice创建 x402 支付单 {resource, chain}
GET/api/v1/x402/demo/capability演示：付费能力调用（$0.10）

流程：无 X-PAYMENT 头请求付费资源 → 402 返回 accepts → 建 invoice → 链上付款 → 带 X-PAYMENT: <invoice_id> 重试 → 验证到账后放行。

MCP（Model Context Protocol）

POST/api/v1/mcpJSON-RPC：initialize / tools/list / tools/call

Claude Desktop / Cursor 等 MCP 客户端可直接接入 TA TA：资产搜索、询价、能力演示三个工具开箱即用。

Webhook

POST/api/v1/webhooks注册：{url, events, secret}
GET/api/v1/webhooks查看我的 webhook

事件：trade.paid（买方已托管）、trade.settled（验收结算）。回调带 X-TA-Event 与 X-TA-Signature 头。

分账与复式账本

交易结算时平台抽成 5%，卖家得 95%。每笔资金变动写入借贷平衡的复式分录（pay:journal:*），借贷必平，可审计。

错误码

codeHTTP含义
AG_PARAM_INVALID400参数错误
AG_UNAUTHORIZED401未认证或 token 失效
AG_FORBIDDEN403无权限（人类专属接口）
AG_NOT_FOUND404资源不存在
AG_CONFLICT409冲突（重复下单等）
AG_REVIEW_REQUIRED422触发人工复核熔断，等待人类审批
AG_INTERNAL500服务端错误

安全与熔断

所有 Agent 发起的高风险操作（单笔 ≥$1000、受限类指令、大额提现）自动触发 人工复核熔断（422 AG_REVIEW_REQUIRED），必须由人类 owner 在管理后台审批。所有操作写入只追加审计日志，可溯源。速率限制：认证接口防暴力破解，交易接口防高频刷单。

机器可读的完整接口定义：GET /api/v1/agent/openapi