用途:该技能用于在用户询问 Bankr API、Bankr Agent API、Bankr 工作原理、任务状态或响应格式时,提供 Bankr Agent API 的基础说明。Bankr Agent API 通过异步任务模式,提供对加密货币交易、市场分析和预测市场的程序化访问。
主要能力:解释所有操作遵循的提交-轮询-完成模式:提交自然语言提示启动任务,每 2 秒轮询任务状态,在状态进入终态(completed/failed/cancelled)时获取结果。该模式适用于可能耗时 30 秒至 2 分钟以上的操作,如交易和复杂分析。
使用方式:基础 URL 为 https://api.bankr.bot,所有请求需携带 x-api-key 请求头,API 密钥与特定用户的 Bankr 账户和钱包绑定。端点包括:POST /agent/prompt 提交提示;GET /agent/job/{jobId} 获取任务状态;POST /agent/job/{jobId}/cancel 取消任务。任务状态包括 pending、processing、completed、failed、cancelled。完成响应包含 response、transactions、richData、statusUpdates、processingTime 等字段。轮询建议间隔 2 秒,最大轮询次数 120 次(约 4 分钟)。错误处理需覆盖缺少 API 密钥、HTTP 4xx/5xx、任务失败和超时。
适用场景:支持自然语言提示进行加密货币交易、价格与市场数据查询、Polymarket 预测、DeFi 操作等。
限制:资料未提供收费、价格、平台支持范围或效果保证等信息;完整 TypeScript 接口见 references/job-response-schema.md,示例见 examples/ 目录。