{
 "$schema": "https://coil.trade/.well-known/coil.json",
 "_comment": "Machine-readable manifest for AI agents: how to discover, evaluate, buy, install, and update Coil. Keep the checkout URL in sync with assets/data/metrics.json.",
 "spec_version": "0.1",
 "product": {
  "name": "Coil",
  "version": "v4",
  "tagline": "A trading desk's discipline for your AI agent: when to trade, when to wait and when to sit in cash, read from a scored board of 650+ US stocks and ETFs and a crypto book. Under it, a rules-based stock scanner that never sells a stock short (on down days it may buy an inverse ETF, as a hedge or as a same-day trade) for the market's leaders across the Equities book (S&P 500, Nasdaq-100, and Macro — 650+ names). The hosted Scanner board pairs it with the Crypto book (BTC, ETH — long-only trend reads on the UTC daily close, tracked live since 2026-07-15; a published read, not execution). Read the board yourself (Coil Scanner), or point your own AI agent at it over MCP (Coil Live).",
  "category": "FinanceApplication / impersonal research publication (hosted)",
  "homepage": "https://coil.trade/",
  "operated_by": "Coil (hosted subscription); the subscriber, or the subscriber's own AI agent, places any orders at the subscriber's own broker",
  "long_only": false,
  "short_selling": false,
  "inverse_etf_hedges": true,
  "agent_operable": true,
  "agent_purchasable": true,
  "builder": {
   "name": "Joey Fife",
   "url": "https://www.linkedin.com/in/joeyfife/",
   "background": "Product manager and self-directed trader who has traded his own account since 2014; built Coil to hand the daily discipline of trading to an agent and get his time back for his family. Not a financial advisor."
  }
 },
 "offers": [
  {
   "id": "live_subscription",
   "name": "Coil Live (agent feed subscription over MCP)",
   "price": "49.00",
   "currency": "USD",
   "recurrence": "monthly_subscription",
   "yearly_price": "419.00",
   "checkout_url": "https://coiltrade.gumroad.com/l/coil-live",
   "includes": "The board the engine starts from, over MCP (https://mcp.coil.trade/mcp) and HTTPS (/api/live/feed): everything in the full board PLUS per-name structural stop and target levels with basis, risk-reward, buy score, conviction, entry lane, leveraged vehicle and ladder placement (never sold per-call and never on any public surface), the served versioned trading discipline (get_live_rules), every *_live MCP tool without per-call payment at any cadence (refreshed about every 5 minutes in US market hours; 60 calls/min per license), and everything in Coil Scanner (the same key opens the human board and dashboard). The subscriber's agent places all orders at the subscriber's own brokerage; Coil never holds accounts, keys or funds. Impersonal research publication - identical for every subscriber, not investment advice. Since 2026-09-03: the awareness read — market leaders, sector money flows, coiled setups (compression or held post-catalyst, coil_score 0-100 on every name) and coverage (names with 5-minute bars / universe)."
  },
  {
   "id": "scanner_subscription",
   "name": "Coil Scanner (hosted board subscription)",
   "price": "19.00",
   "currency": "USD",
   "recurrence": "monthly_subscription",
   "yearly_price": "159.00",
   "checkout_url": "https://coiltrade.gumroad.com/l/board",
   "includes": "The hosted scored board at https://coil.trade/scanner, re-scored about every 5 minutes through the US market day: the Equities book (every S&P 500 / Nasdaq-100 / Macro name) plus the Crypto book (BTC, ETH — long-only trend reads on the UTC daily close, tracked live since 2026-07-15 and not traded with real money by Coil; Coil does not auto-trade crypto), with regime verdicts, buy-list lanes, and license-keyed board API access for agents. Free tier: the morning's top 3 names per book, on the page. Impersonal research publication — identical for every subscriber, not investment advice. Since 2026-09-03: the awareness read — market leaders, sector money flows, coiled setups (compression or held post-catalyst, coil_score 0-100 on every name) and coverage (names with 5-minute bars / universe)."
  }
 ],
 "purchase": {
  "merchant_of_record": "Gumroad (handles checkout, receipts, and license keys)",
  "refund_policy": "Subscriptions cancel anytime from the Gumroad library, and access continues to the end of the period already paid for. A genuine billing error (e.g. a duplicate charge, the wrong amount, or an unauthorized charge) is always corrected, processed by Gumroad, the merchant of record. Full policy: https://coil.trade/refund.",
  "agent_checkout": "Checkout is a hosted Gumroad flow. There is no live agent-checkout (ACP) integration; an agent with delegated card authority can complete the purchase at the checkout_url like any web checkout.",
  "delivery": "Instant access by license key from Gumroad."
 },
 "updates": {
  "model": "hosted",
  "how": "Coil Scanner and Coil Live are hosted subscriptions: the board and the served discipline update server-side, with nothing for the subscriber to install or update.",
  "announced_at": "https://coil.trade/"
 },
 "install": {
  "time_estimate": "about two minutes for Coil Live; Coil Scanner needs only a browser",
  "steps": [
   "Subscribe to Coil Live at https://coil.trade/buy/live; the license key arrives in the Gumroad receipt.",
   "Add the server to your agent (any MCP-capable agent works; this command is Claude Code's): claude mcp add --transport http coil https://mcp.coil.trade/mcp --header \"X-License-Key: YOUR_GUMROAD_LICENSE_KEY\"",
   "Call get_live_setup, then get_live_rules, then get_engine_feed. Keep the agent in dry-run until you deliberately arm it; the served rulebook says so as its first rule."
  ]
 },
 "requirements": {
  "agent": "For Coil Live: an AI agent that can call MCP tools (Claude Code, Cursor, Codex CLI or any MCP client).",
  "broker": "A brokerage with an automation/MCP connector (built against Robinhood's; any equivalent works). Only needed to place orders — reading the board needs none."
 },
 "performance": {
  "basis": "A point-in-time research backtest of the leadership-rotation backbone that Coil's scoring is built on. Survivorship-free (point-in-time index membership, delisted names included), next-open fills, trading costs modeled, 2017 through 2026 H1. RESEARCH on the scoring backbone — NOT live results, NOT account returns, NOT a track record. The engine itself is newly live.",
  "benchmark": "SPY",
  "honesty_rider": "This is research, not live results, and live results will differ. Past performance does not predict future results."
 },
 "disclosures": [
  "Coil is an impersonal research publication, identical for every subscriber. It never sells a stock short. On down days it may buy an inverse ETF, as a hedge or as a same-day trade. It is not investment advice, not a managed account, and not a guarantee of profit.",
  "Coil holds no funds and places no orders on anyone's behalf — the subscriber's agent, broker, keys, and capital stay entirely on the subscriber's side.",
  "You can lose money. Leveraged ETFs, where the strategy uses them to accelerate leaders, can lose value rapidly, including total loss of the amount committed to them.",
  "Stops and risk rules reduce and bound damage; they do not remove market risk, and a stop can gap straight through its level.",
  "The live record is Coil's engine trading one real brokerage account, published win or lose, not a projection of yours. Backtests (point-in-time, survivorship-free, next-open fills) on the scoring backbone are research, not returns, and do not predict future results.",
  "The cash sweep rate is set by the broker, is variable, requires a paid tier (e.g. Robinhood Gold), and is not paid by Coil."
 ],
 "links": {
  "home": "https://coil.trade/",
  "how_it_works": "https://coil.trade/how-it-works",
  "pricing": "https://coil.trade/#pricing",
  "faq": "https://coil.trade/faq",
  "llms": "https://coil.trade/llms.txt",
  "llms_full": "https://coil.trade/llms-full.txt",
  "claude_directory": "https://claude.ai/directory/connectors/coil"
 },
 "products": {
  "live": {
   "name": "Coil Live (agent feed over MCP)",
   "price_usd_monthly": 49,
   "price_usd_yearly": 419,
   "billing": "subscription (Gumroad)",
   "checkout": "https://coiltrade.gumroad.com/l/coil-live",
   "access": "license key from receipt, sent as the X-License-Key header to https://mcp.coil.trade/mcp (all *_live tools + get_engine_feed + get_live_rules) or https://coil.trade/api/live/feed; the same key also opens the human board at https://coil.trade/scanner",
   "connect_guide": "call the free MCP tool get_live_setup, or GET https://coil.trade/api/live/setup",
   "posture": "impersonal research publication — identical for every subscriber; structural levels included behind the license and its terms; the subscriber's agent places all orders at the subscriber's own brokerage; Coil never holds accounts, keys, or funds; not individualized advice; personal and non-transferable",
   "summary": "The board the coil.trade engine starts from, served to the subscriber's AI agent: structural stops/targets, conviction, lanes and vehicles for 650+ names plus the served, versioned trading discipline — refreshed about every 5 minutes in US market hours. Nothing to install; any strong coding agent that can call MCP or HTTPS and run on a schedule.",
   "freshness": "refreshed about every 5 minutes through the US market day (best-effort, honestly timestamped; freshness.next_refresh_at rides every payload)",
   "url": "https://coil.trade/live-feed"
  },
  "scanner": {
   "name": "Coil Scanner (hosted)",
   "price_usd_monthly": 19,
   "price_usd_yearly": 159,
   "billing": "subscription (Gumroad)",
   "checkout": "https://coiltrade.gumroad.com/l/board",
   "access": "license key from receipt, entered at https://coil.trade/scanner (verified via Gumroad license API)",
   "free_tier": "top 3 names per book from the current publish, at https://coil.trade/scanner",
   "demo": "https://coil.trade/demo/",
   "posture": "impersonal research publication — identical for all subscribers; chart-based levels, never a position size; not individualized advice; personal and non-transferable; no redistribution/scraping",
   "summary": "The hosted AI stock scanner: the Equities book (every S&P 500 / Nasdaq-100 / Macro name) — plus the Crypto book (BTC, ETH; long-only trend signals on the UTC daily close, tracked live since 2026-07-15) — scored each market morning with regime verdicts and buy-list lanes, at https://coil.trade/scanner. Crypto trades 24/7; the board refreshes on US weekdays only.",
   "freshness": "re-scored ~every 5 minutes through the US market day (a fresh board publishes each market morning regardless; best-effort, honestly timestamped)"
  },
  "agent_api": {
   "name": "Coil Agent API (x402)",
   "price_usd_per_read": {
    "full_board": 0.05,
    "regime": 0.005,
    "buylist": 0.05,
    "indices": 0.005,
    "sectors": 0.01,
    "top_volume": 0.05,
    "name": 0.005,
    "leaders": 0.01,
    "movers": 0.005,
    "sector": 0.01,
    "crypto": 0.005,
    "brief": 0.02,
    "crypto_gate": 0.001,
    "asof": 0.05,
    "tradfi_risk": 0.003,
    "crypto_setup": 0.05,
    "crypto_day": 0.005,
    "crypto_night": 0.001,
    "hold": 0.005,
    "day_states": 0.01,
    "rotation": 0.005,
    "why_not": 0.005,
    "check_my_trade": 0.01,
    "diff": 0.01,
    "live_session": 0.25,
    "study_chase_full": 0.10,
    "study_pivot_candle_full": 0.10,
    "study_opening_range_full": 0.10,
    "study_trend_template_full": 0.10,
    "study_breadth_at_high_full": 0.10,
    "study_gap_up_trail_full": 0.10,
    "study_sector_laggards_full": 0.10,
    "study_inverse_fund_gap_full": 0.10,
    "study_oversold_rebound_full": 0.10,
    "study_pair_turn_full": 0.10
   },
   "billing": "pay-per-read, USDC on Base, Solana, Algorand, or Polygon via the x402 protocol (v2, scheme 'exact') — no account, no card, no email",
   "endpoint": "GET https://coil.trade/api/board/agent",
   "network": "eip155:8453",
   "networks": [
    "eip155:8453",
    "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73k",
    "eip155:137"
   ],
   "asset": "USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base; EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v on Solana; ASA 31566704 on Algorand; 0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359 on Polygon)",
   "freshness": "paid reads refresh ~every 5 min during US market hours (best-effort; payload carries computed_at + intraday flag), morning snapshot otherwise — the free endpoint rides the same cycle but carries only the top 3 per book",
   "flow": "unpaid request → HTTP 402 with requirements (JSON body + base64 PAYMENT-REQUIRED header) → resend with PAYMENT-SIGNATURE header → full board + on-chain receipt in PAYMENT-RESPONSE header",
   "clients": [
    "@x402/fetch + @x402/evm (npm)",
    "@x402/avm (npm, Algorand — fees sponsored, zero ALGO needed)",
    "@x402/svm (npm, Solana)",
    "Coinbase AgentKit",
    "x402 MCP bridge (Claude)"
   ],
   "free_sample": "GET https://coil.trade/api/board/free (current publish, top-3 per book, same freshness as paid, no payment)",
   "docs": "https://coil.trade/agents",
   "posture": "same impersonal research publication as the Scanner subscription — identical for every buyer; scores/states only, never stop/target prices; not individualized advice; settled reads are final; markets can lose money",
   "endpoints": {
    "full_board": {
     "url": "GET https://coil.trade/api/board/agent",
     "price_usd": 0.05,
     "returns": "650+ scored names across all four books (S&P 500, Nasdaq-100, Macro, BTC/ETH Crypto), sector boards and both ranked buy-list lanes"
    },
    "regime": {
     "url": "GET https://coil.trade/api/board/regime",
     "price_usd": 0.005,
     "returns": "regime verdict per book (risk-on / be-selective / stand-down) plus the top-down permission ladder (index -> sector -> name); a cheap gate to check before doing anything expensive"
    },
    "buylist": {
     "url": "GET https://coil.trade/api/board/buylist",
     "price_usd": 0.05,
     "returns": "today's ranked candidates per book across both lanes (risk-adjusted + swing) with entry windows and leadership flags"
    },
    "indices": {
     "url": "GET https://coil.trade/api/board/indices",
     "price_usd": 0.005,
     "returns": "the scored index row per book (SPY, QQQ, macro, BTC/ETH) — 0-100 opportunity score, percentile, light and entry state — plus each book's regime verdict; the cheapest top-down read of the tape"
    },
    "sectors": {
     "url": "GET https://coil.trade/api/board/sectors",
     "price_usd": 0.01,
     "returns": "every sector ETF scored 0-100 with percentile, light and entry state, plus which sectors each book's regime currently calls green"
    },
    "top_volume": {
     "url": "GET https://coil.trade/api/board/top-volume",
     "price_usd": 0.05,
     "returns": "top names by 20-day average dollar volume in every sector, each scored (opportunity, entry state, hold strength, leadership flag) with the adv20_usd figure that ranked it"
    },
    "name": {
     "url": "GET https://coil.trade/api/board/name?sym=NVDA (or NVDA,AMD,MSFT — up to 10)",
     "price_usd": 0.005,
     "returns": "one stock's full score read (opportunity, entry, hold, growth, gap-risk, leadership, dollar volume) plus its book's regime; unknown sym returns the symbol directory"
    },
    "leaders": {
     "url": "GET https://coil.trade/api/board/leaders",
     "price_usd": 0.01,
     "returns": "top 10 leadership names per book ranked by opportunity score, fully scored"
    },
    "movers": {
     "url": "GET https://coil.trade/api/board/movers",
     "price_usd": 0.005,
     "returns": "top 10 gainers and 10 losers by day % change, each with the full Coil read"
    },
    "sector": {
     "url": "GET https://coil.trade/api/board/sector?name=Energy",
     "price_usd": 0.01,
     "returns": "every member of one sector (by ?name= or ?etf=XLE) with the full score read, ranked by opportunity, plus the sector's ETF row; unknown values return the sector directory"
    },
    "crypto": {
     "url": "GET https://coil.trade/api/board/crypto",
     "price_usd": 0.005,
     "returns": "BTC/ETH long-only trend signal: LONG or CASH per sleeve, 50-day gates + the BTC 200-day master gate, evaluated on UTC daily closes, with price and day change"
    },
    "brief": {
     "url": "GET https://coil.trade/api/board/brief",
     "price_usd": 0.02,
     "returns": "regime per book + top-5 picks + biggest movers + crypto gate — the whole read in one call"
    },
    "day_states": {
     "url": "GET https://coil.trade/api/board/day",
     "price_usd": 0.01,
     "returns": "day-trade STATE MAP: per-name intraday lights grid (price/RSI/MACD x 5m-1D), GO, FUEL vs anchor ETF, entry-window state, ROOM (% + bars to overhead) — a state map, not a ranking (all-lit = ext:true, late)"
    },
    "crypto_gate": {
     "url": "GET https://coil.trade/api/crypto/gate",
     "price_usd": 0.001,
     "returns": "is the BTC 200-day master gate open; LONG/CASH per sleeve; one-line verdict — the cheapest check on the menu"
    },
    "asof": {
     "url": "GET https://coil.trade/api/board/asof?date=YYYY-MM-DD",
     "price_usd": 0.05,
     "returns": "as-published per-name scores for an archived date, served verbatim from the append-only publish log (lookahead-bias-clean); omit date to list archived dates"
    },
    "tradfi_risk": {
     "url": "GET https://coil.trade/api/tradfi-risk",
     "price_usd": 0.003,
     "returns": "TradFi risk-on/off for crypto agents: S&P/Nasdaq regime, sector breadth, permission ladder + the BTC/ETH gate"
    },
    "crypto_day": {
     "url": "GET https://coil.trade/api/crypto/day",
     "price_usd": 0.005,
     "returns": "24/7 crypto day-state board: 81 Robinhood-tradable coins with trend distances (20/50/200d), tape lights, ATR%, relative strength vs BTC, room, volume z-score, UP/CHOP/DOWN state and ranks, PLUS day-trade grades (GO/FUEL/EFF vs the BTC anchor, SETUP shape, grade) — a state map, not a ranking; publishes every ~5 min around the clock"
    },
    "crypto_night": {
     "url": "GET https://coil.trade/api/crypto/night",
     "price_usd": 0.001,
     "returns": "pre-registered overnight continuation read: the top-5 session-momentum coins into the 20:00 UTC signal, the BTC 200-day regime gate, pre/post-signal phase, eligibility counts and the cold-study receipts (the ranking beat its random null at every fee tier; at Robinhood retail taker fees the studied trade was REFUTED — the refutation ships in every read); ~5-min refresh around the clock"
    },
    "crypto_setup": {
     "url": "GET https://coil.trade/api/crypto/setup",
     "price_usd": 0.05,
     "returns": "crypto SETUP scan: every washed-shape hit across the 81 RH-tradable coins with GO, fuel vs BTC, grade and room, plus the setup column for the whole universe; ~5-min recompute, 24/7; the shapes were backtest-confirmed on equities and are forward-graded on crypto (disclosed per read)"
    },
    "hold": {
     "url": "GET https://coil.trade/api/board/hold?sym=NVDA (or NVDA,AMD,BTC-USD — up to 10)",
     "price_usd": 0.005,
     "returns": "per-symbol hold state: published trend state, hold strength, readiness, maturity-late flag, gap-risk grade and the book regime, with the mechanical rules states flip on; BTC-USD/ETH-USD return the crypto book's IN|CASH daily-close state; never ingests a buyer's entry or size"
    },
    "rotation": {
     "url": "GET https://coil.trade/api/board/rotation",
     "price_usd": 0.005,
     "returns": "sector + macro ROTATION map: each of ~50 sector ETFs and macro instruments (bond, income, metals and commodity ETFs plus a few single mining stocks) scored on its own X/SPY ratio versus that ratio's 50-day and labelled GO (money already here), HOLDING (here but paused), TURNING (money arriving) or OUT (money left), with distance-to-50d %, 20-day slope % and ratio RSI — a state map, not a buy list; confirmed rotation is LATE for a pullback buyer"
    },
    "why_not": {
     "url": "GET https://coil.trade/api/board/whynot?sym=NVDA",
     "price_usd": 0.005,
     "returns": "why one name is not a candidate today, in plain words: the gate for its book and sector, its entry window (READY, SETUP, WAIT, CHASE, FALLING, BASING) and earnings inside five trading days, or the state that makes it a candidate; states and reasons only, no scores; ends with the discipline rule that applies; an unknown symbol fails free with a 400"
    },
    "check_my_trade": {
     "url": "GET https://coil.trade/api/board/checktrade?sym=NVDA&entry=54.20&stop=51.50 (optional day_low, equity)",
     "price_usd": 0.01,
     "returns": "your own long trade checked on the live board against the desk's discipline: the stop distance, a chase or falling state, earnings inside five trading days, the gate, and the Coil Live rulebook's sizing (the position the stop buys at its risk, the one-name cap, the entry guards); a verdict of consistent, wait or pass with every reason; malformed input fails free with a 400"
    },
    "diff": {
     "url": "GET https://coil.trade/api/board/diff?since=<state hash from the free /api/board/state>",
     "price_usd": 0.01,
     "returns": "WHAT CHANGED since the hash you stored: names that entered or left the READY candidate pool, per-name trend/light/leadership/hold-band flips, and any regime or permission-ladder move per book; the board recomputes ~5 min in market hours, so poll the free hash and buy this only when it moves — calling it with an unchanged hash is answered FREE and never billed"
    },
    "live_session": {
     "url": "POST https://coil.trade/api/live/session",
     "price_usd": 0.25,
     "returns": "A 1-hour Coil Live session token, minted on payment. Send it as X-License-Key to unlock every *_live MCP tool plus get_engine_feed and get_live_rules, and the /api/live/* HTTP routes — the board the engine starts from, with structural stops, targets, risk-reward, conviction and lane. The wallet-native alternative to the $49/mo subscription; cheaper to subscribe if you run every day."
    },
    "study_chase_full": {
     "url": "GET https://coil.trade/learn/research/is-chasing-a-strong-stock-a-losing-habit/full",
     "price_usd": 0.1,
     "returns": "the full text of one published backtest (does chasing a stock near its high lose money?): question, pre-registered bar, method, results, controls, limits. Paid per study, per read. A published study, not advice."
    },
    "study_pivot_candle_full": {
     "url": "GET https://coil.trade/learn/research/does-waiting-for-a-30-minute-pivot-candle-improve-a-stock-entry/full",
     "price_usd": 0.1,
     "returns": "the full text of one published backtest (does waiting for a 30-minute pivot candle improve a stock entry?): question, pre-registered bar, method, results, controls, limits. Paid per study, per read. A published study, not advice."
    },
    "study_opening_range_full": {
     "url": "GET https://coil.trade/learn/research/does-buying-the-opening-range-breakout-on-strong-stocks-make-money/full",
     "price_usd": 0.1,
     "returns": "the full text of one published backtest (does buying the opening-range breakout on strong stocks make money?): question, pre-registered bar, method, results, controls, limits. Paid per study, per read. A published study, not advice."
    },
    "study_trend_template_full": {
     "url": "GET https://coil.trade/learn/research/does-a-trend-template-and-volatility-contraction-breakout-beat-the-market/full",
     "price_usd": 0.1,
     "returns": "the full text of one published backtest (does a trend-template and volatility-contraction breakout rule beat the market?): question, pre-registered bar, method, results, controls, limits. Paid per study, per read. A published study, not advice."
    },
    "study_breadth_at_high_full": {
     "url": "GET https://coil.trade/learn/research/does-weak-breadth-at-a-market-high-predict-a-worse-stock-market/full",
     "price_usd": 0.1,
     "returns": "the full text of one published backtest (does weak breadth under a market at its high predict a worse stock market?): question, pre-registered bar, method, results, controls, limits. Paid per study, per read. A published study, not advice."
    },
    "study_gap_up_trail_full": {
     "url": "GET https://coil.trade/learn/research/does-buying-a-neglected-stock-after-a-big-volume-gap-up-beat-the-market/full",
     "price_usd": 0.1,
     "returns": "the full text of one published backtest (does buying a neglected stock after a big volume gap-up beat the market?): question, pre-registered bar, method, results, controls, limits. Paid per study, per read. A published study, not advice."
    },
    "study_sector_laggards_full": {
     "url": "GET https://coil.trade/learn/research/does-buying-the-laggards-of-a-leading-sector-group-beat-the-market/full",
     "price_usd": 0.1,
     "returns": "the full text of one published backtest (does buying the laggards of a leading sector group beat the market?): question, pre-registered bar, method, results, controls, limits. Paid per study, per read. A published study, not advice."
    },
    "study_inverse_fund_gap_full": {
     "url": "GET https://coil.trade/learn/research/does-buying-a-3x-inverse-index-fund-after-a-gap-down-pay/full",
     "price_usd": 0.1,
     "returns": "the full text of one published backtest (does buying a -3x inverse index fund after a gap-down pay?): question, pre-registered bar, method, results, controls, limits. Paid per study, per read. A published study, not advice."
    },
    "study_oversold_rebound_full": {
     "url": "GET https://coil.trade/learn/research/does-buying-a-deeply-oversold-high-volatility-stock-the-next-day-pay/full",
     "price_usd": 0.1,
     "returns": "the full text of one published backtest (does buying a deeply oversold, high-volatility stock the next day pay by the close?): question, pre-registered bar, method, results, controls, limits. Paid per study, per read. A published study, not advice."
    },
    "study_pair_turn_full": {
     "url": "GET https://coil.trade/learn/research/does-buying-a-sector-etf-that-money-is-rotating-into-beat-the-market/full",
     "price_usd": 0.1,
     "returns": "the full text of one published backtest (does buying a sector ETF that money is rotating into beat the market?): question, pre-registered bar, method, results, controls, limits. Paid per study, per read. A published study, not advice."
    },
    "stock_full": {
     "url": "GET https://coil.trade/stocks/{symbol}/full",
     "price_usd": 0.005,
     "returns": "the paid page twin of /api/board/name for one symbol: the same price, rails and data as a readable page (markdown by default; HTML with Accept: text/html; JSON with Accept: application/json). The free page /stocks/{symbol} is unchanged. A symbol the site does not serve is a free 404."
    },
    "board_day_full": {
     "url": "GET https://coil.trade/board/{date}/full",
     "price_usd": 0.05,
     "returns": "the paid page twin of /api/board/asof for one archived date (YYYY-MM-DD): the same price, rails and data as a readable page (markdown by default; HTML with Accept: text/html; JSON with Accept: application/json). A date that is not in the archive is a free 404."
    }
   },
   "free_endpoints": {
    "preview": "GET https://coil.trade/api/board/agent?preview=1 — sample in the IDENTICAL schema to the paid board (current publish, top-3 per book); validate your parser before paying",
    "status": "GET https://coil.trade/api/board/status — reads served, last settlement, benchmark-relative performance (percentages only)",
    "free_tier": "GET https://coil.trade/api/board/free — current publish, top-3 per book (same freshness as paid)",
    "symbols": "GET https://coil.trade/api/board/symbols — FREE directory of every purchasable symbol + sector (the menu for ?sym= and ?name=)",
    "free_key": "POST https://coil.trade/api/key {\"email\":...} — instant key, ~25 live calls/day on regime/indices/movers/crypto-gate/crypto-night/tradfi-risk/hold via the X-Coil-Key header",
    "wallet_auth": "SIWX (CAIP-122) — the same free tier keyed to a wallet, no email: GET https://coil.trade/api/auth/nonce?address=…&chain=base|solana|algorand, sign the message (it moves no funds), POST /api/auth/verify {chain, address, issued_at, signature}",
    "research_index": "GET https://coil.trade/api/research — FREE index of the published Coil Edge Research studies (question, verdict, evidence class, data window, per-read price, paid x402 address); the same rows come from the free MCP tool list_research",
    "change_check": "GET https://coil.trade/api/board/state — FREE, unlimited: per-book hashes (books.spx / books.qqq) plus optional ?syms=NVDA,AMD for per-name hashes. Poll yours; buy only when it changes. If-None-Match -> 304."
   },
   "discovery": "Paid endpoints are discoverable in the Coinbase CDP Bazaar (each is listed after its first settlement) — discoverable via its MCP server and AWS Bedrock AgentCore.",
   "note": "Every live slice reads the SAME freshest payload, so a slice is never staler than the full board.",
   "polling_contract": "Every response (paid AND the free preview) carries a freshness block — market_open, data_age_seconds, next_refresh_at, and a plain-language poll_hint — plus the same values in the X-Coil-Market-Open / X-Coil-Next-Refresh / X-Coil-Data-Age response headers. It tells you when the board will actually change, so you poll only when there is new data instead of re-buying an identical payload. When the US market is shut it says so and gives the next session time. Market holidays are not modelled (a holiday reads as open while the board simply will not advance — data_age_seconds still reveals it).",
   "free_trust_surface": {
    "record": "GET https://coil.trade/api/perf — engine vs SPY/QQQ, funding-adjusted, free",
    "proof": "GET https://coil.trade/api/board/proof — append-only sha256 commitments + a verification recipe reproducible in Python and JavaScript, free"
   },
   "update_cadence": {
    "intraday": "about every 5 minutes while the US market is open (best effort)",
    "daily": "a fresh board every market morning",
    "crypto": "BTC/ETH evaluated on UTC daily closes",
    "crypto_day": "/api/crypto/day and /api/crypto/setup publish every ~5 minutes around the clock (the payload self-dates via computed_at and carries next_refresh_hint)",
    "crypto_night": "/api/crypto/night rides the same ~5-min crypto-day publish; the read carries its own clock — the fixed 20:00 UTC signal time plus a pre-signal/post-signal phase flag",
    "archive": "/api/board/asof is immutable — one new date per session, never revised",
    "how_to_poll": "every paid response and every 402 carries next_refresh_at; poll the $0.005 regime or $0.001 crypto gate and buy fuller reads when the state changes"
   }
  }
 },
 "storefront": {
  "contract": "anthropics/commerce-agents shopping-agent storefront tools (MCP)",
  "mcp_url": "https://mcp.coil.trade/mcp",
  "session_header": "X-Session-Id",
  "tools": [
   "search_products",
   "get_product_details",
   "get_cart",
   "add_to_cart",
   "update_cart_item",
   "remove_from_cart",
   "checkout_handoff",
   "recall_memories",
   "save_memory",
   "search_policies",
   "get_fulfillment_options"
  ],
  "product_ids": [
   "coil-scanner",
   "coil-scanner-monthly",
   "coil-scanner-yearly",
   "coil-live",
   "coil-live-monthly",
   "coil-live-yearly"
  ],
  "checkout": "checkout_handoff returns one hosted Gumroad checkout URL per cart line; a person completes payment there; nothing in the tools charges anything",
  "docs": "https://coil.trade/agents#storefront"
 }
}
