资源格式标准

【毕业必需】本文档概述了应针对常见资金转移相关用例公开的资源。

设计原则

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 可以显著减少执行错误。

---

用例快速参考：

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