Isocast — 面向 AI Agent 的 Polymarket 天气信号 API

API 地址：https://api.isocast.dev。Isocast 监测 37 个城市；当某城市当日实测最高气温跨越一个 Polymarket 温度区间、进入另一个区间时，即为该（城市，日期，区间跃迁）生成且仅生成一条信号。每条信号均包含对应 Polymarket 市场 URL、旧/新 {reading, unit, bucket} 值，以及所有区间的实时 YES/NO/中点赔率（当日已无法抵达的区间将标记 dead: true）。浏览类接口完全免费，无需认证；深度信号需按城市购买预付费套餐，按次计费。

完整 API 文档：api.isocast.dev/llms.txt｜OpenAPI 规范：api.isocast.dev/openapi.json

什么是信号（Signal）

当某城市的日最高气温读数进入一个新的 Polymarket 区间时，即触发一条信号。信号内容包括市场 URL、新旧区间的读数值，以及所有区间的当前赔率，并附带 bucketsAsOf（赔率更新时间戳，约 10 秒延迟）和 observedAt（观测时间）。每条（城市，日期，区间）组合最多仅投递一次信号；seq 是一个严格单调递增的每城计数器，供你追踪已接收信号。

免费端点（无需认证，无需付费）

所有 JSON 响应均附带一个 disclaimer 字符串字段。

快速开始 — 浏览单个城市（免费）

// 全部免费，无需认证，无需初始化
const BASE = "https://api.isocast.dev";

// 1. 获取活跃城市列表
const cities = await (await fetch(`${BASE}/v1/cities`)).json();
// cities: [{ slug, unit, bucketWidth, timezone, latestSeq }, ...]

// 2. 查看某城市今日市场详情
const city = await (await fetch(`${BASE}/v1/cities/istanbul`)).json();
// city: { slug, targetDate, marketUrl, ... }

// 3. 在付费前查看示例信号结构
const sample = await (await fetch(`${BASE}/v1/sample?city=istanbul`)).json();
// sample.signal: { marketUrl, old, new, buckets, observedAt, ... }, sample: true

付费信号

最经济的读取方式是 GET /v1/spot?city=SLUG —— 仅 $0.01 即可获取某城市最新信号的快照，支持由 STOCK x402 客户端直接支付（使用标准 @x402/fetch 的 wrapFetchWithPayment，无需自定义 nonce）。如需持续流式接收信号，请通过 /v1/subscribe 购买按城市预付费套餐（x402 按次支付；套餐越大，单位价格越低），再调用 /v1/signals 读取。AI Agent 可直接使用 isocast-mcp npm 包（一个 MCP server），它会自动处理支付流程；也可查阅完整流程说明：api.isocast.dev/llms.txt。已获授权的信号亦可推送至 Telegram 聊天（完全免费 —— 注册推送通道的路由永不收费）。

错误处理

• 402 — 请求付费信号时未完成支付。请参阅上方文档了解支付流程。
• 429 — 请求频率超限。请遵守响应头 Retry-After 中指定的等待秒数。
• 404 — 城市不存在或当前未激活。

机器可发现性（Machine Discovery）

免责声明

本数据仅供信息参考，不构成金融或博彩建议。不保证数据准确性或预测结果；预测市场在部分司法管辖区受限制。服务条款：https://isocast.dev/terms