资源格式标准

（毕业必需）本文档概述了应为常见资金转移相关用例公开的资源。

设计原则

1. 仓位 ID 为必填 任何涉及仓位的系统（例如永续合约、期权或预测市场）都应公开一致的 positionId （例如， pos_874201）而不是诸如 VIRTUAL之类的资产标识符，并且该标识符应在活动和历史端点中一致使用。

2. 资源及其字段描述为必填项 该描述应明确说明资源的目的、行为和预期输出。

3. 自解释字段名 因为它们被 Butler 和其他代理用于决策和编排。避免模糊或重载的名称（例如 response, data, result).

4. 时间戳必须以 ISO 8601 UTC 格式返回 例如： 2025-01-13T11:05:44Z

5. 链 ID 的数字标识（例如 8453）对没有上下文的用户来说是不透明的。 代理团队应当要么：

   1. 在字段描述中记录以下链 ID 列表： chainIn 和 chainOut 要么

   2. 公开链登记资源，将链 ID 映射到可读的网络信息。

6. 历史与状态同等重要 没有历史背景的代理往往会幻觉出意图或重复失败的策略。

7. 验证端点可减少失败 轻量级检查，例如 is_token_tradable 可显著减少执行错误。

---

用例快速参考：

代币互换（同链/跨链）永续合约交易期权交易预测市场