Coil Board API
Coil 发布一份评分排名的美国股票市场阅读（以及一份仅做多的 BTC/ETH 趋势手册），Agent 可以通过 x402 按次购买。您购买的不是原始 OHLCV 数据——那些在任何地方都是免费的。您购买的是判断：哪些股票值得买入、市场体制有多强、以及今日板块排名——自上而下地阅读。
此处所有内容均为非个人化的研究出版物——对每个买家相同，仅包含评分和状态，绝不包含止损价或目标价，也绝不提供个性化建议。市场可能导致亏损。
何时使用此技能
- 在您需要执行某项昂贵的操作之前，需要一个市场体制门控：现在是风险偏好还是风险规避？ → 调用
/api/board/regime（$0.005）。 - 您想要今日排名靠前的买入候选股，而无需自己扫描 500 只股票 → 调用
/api/board/buylist（$0.02）。 - 您想要整个板块——所有四个书籍中的每一个评分股票、行业通道、两个买入列表通道——以便自行筛选 → 调用
/api/board/agent（$0.25）。
端点（共 15 个——完整目录在 GET https://coil.trade/api）
| 端点 | 价格（USDC） | 返回内容 |
|---|---|---|
GET https://coil.trade/api/board/regime | 0.005 | 每个书籍的体制判断（风险偏好 / 选择参与 / 观望）+ 指数→行业→个股的权限阶梯。 |
GET https://coil.trade/api/board/crypto | 0.005 | 仅做多 BTC/ETH 趋势信号：每个分仓为 LONG 或 CASH，50 日门控 + BTC 200 日主门控（UTC 日收盘价）。 |
GET https://coil.trade/api/board/indices | 0.005 | 每个书籍的评分指数行（SPY, QQQ, 宏观, BTC/ETH）——最便宜的自上而下阅读。 |
GET https://coil.trade/api/board/name?sym=NVDA | 0.005 | 一只股票的完整阅读 + 其书籍的体制。适用于约 560 只股票。 |
GET https://coil.trade/api/board/movers | 0.005 | 前 10 名涨幅股 + 10 名跌幅股，完整评分。 |
GET https://coil.trade/api/board/sectors | 0.01 | 每个行业 ETF 评分 + 体制中的绿色行业。 |
GET https://coil.trade/api/board/sector?name=Energy | 0.01 | 某个行业的所有成员，完整评分排名（?etf=XLE 同样有效）。 |
GET https://coil.trade/api/board/leaders | 0.01 | 每个书籍中按机会排名的前 10 名领导股。 |
GET https://coil.trade/api/board/buylist | 0.02 | 今日每个书籍在两个通道中的排名候选股，包含入场窗口和领导标志。 |
GET https://coil.trade/api/board/top-volume | 0.02 | 每个行业中按 20 日美元交易额排名的前 5 只股票，完整评分。 |
GET https://coil.trade/api/crypto/gate | 0.001 | 最便宜的检查：BTC 200 日主门控是否打开？每个分仓的 LONG/CASH 状态 + 判断。 |
GET https://coil.trade/api/tradfi-risk | 0.003 | 面向加密货币 Agent 的金融风险偏好/规避：S&P + Nasdaq 体制，行业宽度，阶梯 + BTC/ETH 门控。 |
GET https://coil.trade/api/board/brief | 0.02 | 早间简报：每个书籍的体制 + 前 5 名精选 + 最大波动股 + 加密货币门控，一次调用完成。 |
GET https://coil.trade/api/board/asof?date=YYYY-MM-DD | 0.02 | 时间点存档评分，来自仅追加日志的逐字副本——可通过免费的 /api/board/proof 进行验证。 |
GET https://coil.trade/api/board/agent | 0.25 | 完整板块：约 560 只评分股票，所有四个书籍，行业板块，两个买入列表通道。 |
免费，无需任何支付：GET /api/perf（引擎相对于 SPY/QQQ 的记录）和 GET /api/board/proof（仅追加的 sha256 承诺，附带可复现的验证方法）——在信任发布者之前先检查。使用邮箱 POST /api/key 可立即获得免费密钥（廉价切片每天约 25 次实时调用，使用 X-Coil-Key 标头）。
没有钱包？同样的板块也可以作为远程 MCP 服务器使用——免费层，完整板块延迟一个交易日：claude mcp add --transport http coil https://coil.trade/mcp
与经纪商配对（形成闭环）
Coil 发布应该看什么；它绝不执行订单，也绝不接触账户。如果 Agent 同时拥有执行能力——例如 Robinhood 的 Trading MCP（代理账户、预算子账户）或 Alpaca 的 MCP/CLI（纸面交易，无需资助账户）——则在同一个客户端中加载两个服务器，并遵循以下阅读顺序：
get_market_regime—— 如果阶梯不允许个股操作，则观望。不要下达订单。get_buy_list—— 只考虑出现在买入列表上的股票。get_stock_read/get_sector_read—— 在提交前深入考察候选股。- 然后才使用经纪商工具，由操作者自己决定仓位规模。
get_morning_brief 将步骤 1–2 合并为一次调用。Coil 不输出任何仓位大小、止损价格或目标价格——风险定义属于操作者，而非发布者。完整指南：https://coil.trade/agents/robinhood
所有实时切片都从相同的最新数据负载中读取（存档按日期端点则是返回请求日期的数据），因此廉价切片永远不会比完整板块更陈旧。在美国市场交易时段，板块约每 5 分钟重新计算一次；数据负载包含 computed_at 和一个 intraday 标志，外加一个 freshness 块，告知您何时值得再次付费。
先免费试用
在付费之前，先通过免费预览验证您的解析器——模式与付费板块相同，为前一日数据，每个书籍前 3 名股票：
GET https://coil.trade/api/board/agent?preview=1
另外还有一个始终免费的延迟样本：
GET https://coil.trade/api/board/free。
支付方式（x402）
- 不带支付信息
GET端点。它将返回 HTTP 402，附带一个 JSON 体，其accepts[0]描述了要求：amount（原子 USDC，6 位小数——5000= $0.005）、asset（USDC0x8335…2913）、network（eip155:8453，Base）、以及payTo。 - 对该金额签署一份 EIP-3009
TransferWithAuthorization发送至payTo，并重新发送附带有PAYMENT-SIGNATURE标头（base64 x402 v2 负载）的请求。 - 成功后将返回 HTTP 200，附带 JSON 板块以及
PAYMENT-RESPONSE标头中的链上收据。
任何标准的 x402 客户端都可以为您处理此循环——例如，使用 EVM 签名器的 x402-fetch、Coinbase AgentKit、或 x402 MCP 桥接器。这些端点在 Coinbase CDP x402 集市中有索引；发现元数据也在 https://coil.trade/.well-known/x402 以及 OpenAPI 规范 https://coil.trade/openapi.json 中。
解读数据负载
每个评分股票都携带以下字段（字段名与返回的一致）：
opp_pct—— 机会，0–100。板块的头版综合评分。entry_q—— 入场质量，0–100。现在可买入 vs. 已扩展。时机判断，非建议。hold_q—— 持有强度，0–100。趋势持久性。state——firing/ready/setup/wait/chase/falling。sector、is_leader，以及（在买入列表通道中）一个类似READY的window注释。
每个书籍都携带一个 regime 对象：mode、一条通俗语言的 verdict、哪些行业是绿色的、以及一个 ladder（指数 → 行业 → 个股），说明个股是否可入场。自上而下阅读：如果体制说观望，那么下面的排名股票只是上下文，而非绿灯。
知道何时返回
板块是一个动态阅读，而非一次性文件。廉价地轮询 regime 以决定是否值得购买更全面的切片。freshness.next_refresh_at 字段告诉您最早值得为新的数据负载付费的时间；更频繁地轮询只会返回相同的数据。在美国市场交易时段之外，您将获得早间快照。
这不是什么
这不是投资建议，不是管理账户，不是承诺回报的信号服务，也不是盈利保证。评分来源于历史和技术数据，不能预测未来结果。请参阅 https://coil.trade/terms。