SuperAPI AI 工具集

ito-basket-compare

数据与分析

查看项目

更新于 10-15 08:38

技能介绍

用途

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。所有人类可读输出必须以“此对比仅供参考,不构成投资或交易建议”结尾。