Coil Board API
Coil 發布一份經評分與排名的美國權益市場（以及一個僅做多的 BTC/ETH 趨勢書）閱讀報告，代理可以透過 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 | 為加密貨幣代理提供的 TradFi 風險開啟/關閉：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 發布要看什麼；它從不下單，也從不看帳戶。如果代理同時具備執行能力——例如 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 Bazaar 中建立索引；發現元數據也位於 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、以及（在買入清單區塊中）一個window註記，例如READY。
每本書都帶有一個 regime 物件：mode、一個白話文 verdict、哪些行業是綠色的、以及一個 ladder（指數 → 行業 → 名稱），說明個別名稱是否可進場。由上而下閱讀：如果體制說暫停觀望，那麼下面排名的名稱只是背景資訊，並非綠燈。
知道何時回來
板塊是一個動態讀取，而非一次性檔案。便宜地輪詢 regime 來決定是否值得購買更完整的切片。freshness.next_refresh_at 欄位告訴你最早何時值得為新承載付費；更快輪詢只會得到相同的位元組。在美國市場交易時間之外，你會得到早晨的快照。
這不是什麼
不是投資建議、不是管理帳戶、不是承諾報酬的訊號服務，也不是獲利保證。分數是根據歷史與技術數據得出的，並不能預測未來結果。請參閱 https://coil.trade/terms。