用途
Itô Basket Compare 用于将 Itô 预测市场篮子(basket)、主题或市场集合与用户提供或明确选择的上下文进行对比,例如知识库、投资组合笔记、财务背景、观察列表或研究论点。典型请求包括“将此篮子与我的研究对比”“篮子 vs 观察列表”“运行差距分析”“查找冲突与过时假设”。该技能为只读,绝不推荐或执行交易。
主要能力
- 对比篮子与用户提供的对比目标,识别匹配项、冲突项、缺失上下文和过时假设。
- 记录每个输入的来源信息:source_type(user_provided、public 或 ito_authenticated)、source_uri、retrieved_at、as_of 和 freshness_status(fresh、stale 或 unknown)。
- 支持匿名公开产品数据读取,包括 https://itomarkets.com 上的 /api/baskets/bootstrap、/api/baskets/{basket_id}/bootstrap 和 /api/markets/hot 等限速 GET 路由。
- 支持带密钥的开发者 API(https://itomarkets.com/api/v1),使用 Authorization: Bearer <key>,篮子读取需要 baskets:read 权限,市场查询需要 markets:read 权限。
- 支持官方 Python SDK 包 ito-markets(导入为 ito)进行类型化的篮子与市场读取。
- 提供确定性归一化与对比:Unicode NFKC 归一化、时间戳转 UTC RFC 3339、按稳定 ID 精确匹配、按规则排序、明确新鲜度阈值(市场/篮子观察默认 24 小时,笔记/研究默认 30 天)。
- 输出简洁 Markdown 或结构化 JSON,包含篮子摘要、对比目标、来源/新鲜度、匹配、冲突或过时假设、缺失上下文和用户行动清单。
使用方式
输入可以是粘贴的篮子或明确授权的只读来源。最小篮子输入为稳定的 basket_id 或篮子标签,加上一个或多个底层标的;每个底层标的应包含 underlier_id、label、事件或主张,以及来源提供的权重/概率。对比目标必须由用户提供或明确选择。
对于公开数据,可使用匿名限速 GET 路由;当公开数据缺少所需字段时,可使用 SDK 或带密钥 API。使用 SDK 前需记录已安装版本并验证方法、响应类型、来源和所需权限,未经确认不得安装或升级。
认证方面:ecc ito auth --json 是可选的、仅验证的计算身份探测,不启动登录,也不能解锁篮子读取。若具体认证篮子来源的文档契约明确使用规范 Itô 设备凭证,可在缺失、过期或确认撤销凭证时暂停并返回 AUTH_REQUIRED 或 AUTH_REVOKED,提示用户运行 ecc ito login。登录完成后返回原只读请求,不得扩大范围。
适用场景
- 将预测市场篮子与个人研究笔记或投资论点进行差距分析。
- 对比篮子与观察列表,查找冲突或过时假设。
- 在只读、不执行交易的前提下,整理市场篮子与用户上下文的匹配与缺失情况。
限制
- 严格只读:不提供买卖、持有、对冲、杠杆、配置或仓位建议;不准备或提交订单、交易、购买、预留或 RFQ。
- 不得使用 ecc ito find(会提交认证 RFQ)、不得将 ecc ito status 用于篮子数据、不得将 ecc ito evals 用于篮子对比。
- 未经用户明确指定来源,不得使用私人文档、财务背景、记忆或账户数据。
- 绝不打印、回显、记录、持久化或暴露 API 密钥、设备令牌、会话令牌或秘密。
- 若操作可能改变外部状态,停止并返回 UNSUPPORTED_OPERATION。
- 缺失事实(如具体收费、价格、平台支持范围等)暂未提供。
输出
默认输出简洁 Markdown,顺序为:篮子摘要、对比目标、来源/新鲜度、匹配、冲突或过时假设、缺失上下文、用户行动清单(仅研究问题)。结构化输出使用固定键序 JSON,状态为 ok 或 blocked。所有人类可读输出必须以“此对比仅供参考,不构成投资或交易建议”结尾。