Coil Scanner Agent API

Endpoints (23 live)

• GET /api/board/agent — Coil Scanner — decide what to trade now instead of rebuilding it. Scored stock rankings for agents: which of ~565 S&P 500, Nasdaq-100 and macro names are set up to buy, with per-name opportunity, entry-timing and hold-strength scores; risk-on / be-selective / stand-down regime verdicts; ranked buy-list lanes; plus a long-only BTC/ETH trend book. Not raw OHLCV (that's free) — the judgment, read top-down. Refreshed ~5 min in market hours, timestamped. Research, not advice. (0.1 USDC on Solana)
• GET /api/live/session — Buy 1 hour of Coil Live for $0.10 with a wallet instead of a subscription — the engine-grade board the live record trades from: per-name structural stop and target levels, risk-reward, conviction, lane and ladder placement, plus the served rulebook. Pay once over x402 and receive a session token that works anywhere the X-License-Key header is read, HTTP and MCP alike. The feed behind it refreshes about every 5 minutes in US market hours. No account, no card, no human. Research, not advice. (0.1 USDC on Solana)
• GET /api/crypto/setup — Which of 81 Robinhood-tradable coins are in a WASHED SETUP right now? One read scans the full universe for the two washed-shape patterns (daily uptrend + washed-out 5-minute tape) and returns every hit with its GO score, fuel multiple vs BTC, grade and room — plus the setup column for all 81 names. Recomputed every ~5 minutes, 24/7. Shapes were backtest-confirmed on equities; on crypto they are forward-graded, disclosed per read. Research, not advice. (0.05 USDC on Solana)
• GET /api/board/asof — Point-in-time score history — what did Coil actually publish on a given date? Returns the as-published per-name scores (opportunity percentile, entry quality, hold strength) for every S&P 500 / Nasdaq-100 / macro name on any archived date (?date=YYYY-MM-DD; omit for the list of archived dates). Lookahead-bias-clean by construction: served verbatim from the append-only publish log, never recomputed. Immutable: one new date per session, never revised. Research, not advice. (20000 on Base)
• GET /api/board/brief — The whole market read in one small answer — a morning brief for agents: the regime verdict per book (S&P 500, Nasdaq-100, macro, BTC/ETH crypto), today's top-5 buy candidates, the biggest gainers and losers, the crypto trend-gate state, and the awareness read: the five names leading today, sector money flows in and out, the five most coiled setups, coverage. One $0.02 call instead of four. Refreshed ~5 min in US market hours. Research, not advice. (0.02 USDC on Base)
• GET /api/board/sectors — Sector rotation scores — which sectors are strong right now? One read returns every S&P 500 sector ETF (XLK, XLF, XLV, XLE, XLI and the rest) scored 0-100 with percentile, green/yellow/red light and entry state, plus which sectors each book's regime currently calls green. Spot leadership rotation top-down without scanning 500 single names. Refreshed ~5 min in market hours, timestamped. Research, not advice. (0.01 USDC on Solana)
• GET /api/board/buylist — Which stocks to buy now — trading signals as a ranked buy list for agents. Returns today's top candidate names per book (S&P 500, Nasdaq-100, macro) across two lanes, risk-adjusted and swing, each with buy / entry / growth / hold scores, a leadership flag and an entry-window note — plus the regime mode telling you whether the list is actionable at all. Ranked judgment, not raw data. Refreshed ~5 min in market hours. Research, not advice. (20000 on Base)
• GET /api/board/crypto — Bitcoin and Ethereum trend signal — is crypto risk-on right now? One read returns the long-only trend state for BTC and ETH (LONG or CASH per sleeve), each sleeve's 50-day trend gate, and the BTC 200-day master gate that overrides both — all evaluated strictly on UTC daily closes, with live price and day change. A rules-based regime verdict for agents, not raw price data. Long-only: the answer is in or out, never short. Research, not advice. (0.005 USDC on Base)
• GET /api/board/movers — Today's biggest movers, scored — the top gainers and losers across the S&P 500, Nasdaq-100 and macro book, each with the day's % change AND the Coil read: opportunity 0-100 + percentile, entry state (READY / WAIT / CHASE / FALLING), hold strength and overnight gap-risk score — so an agent can tell which moves are chaseable structure and which are falling knives. Refreshed ~5 min in market hours, timestamped. Research, not advice. (0.005 USDC on Base)
• GET /api/board/hold — Per-symbol HOLD-STATE read — is the published trend state behind a name intact? GET /api/board/hold?sym=NVDA (up to 10, comma-separated, one price) returns each name's state, hold strength 0-100, readiness, maturity-late flag, overnight gap-risk grade and its book's regime, with the mechanical rules states flip on. BTC-USD/ETH-USD return the crypto book's IN|CASH daily-close state. Impersonal publication — never your entry or size. ~5-min refresh in market hours. Research, not advice. (0.005 USDC on Base)
• GET /api/crypto/day — 24/7 crypto day-state board — 81 Robinhood-tradable coins (BTC, ETH, SOL, XRP, DOGE…). Per coin: price, 24h/7d change, trend vs 20/50/200-day, ATR%, RS vs BTC, tape lights, volume z, room to the 20d high, UP/CHOP/DOWN state, ranks — PLUS day-trade grades: GO, FUEL and EFF vs the BTC anchor, SETUP shape and ROOM in bars. Publishes every ~5 minutes around the clock when the market moved. A state map, not a ranking. Research, not advice. (0.005 USDC on Base)
• GET /api/board/rotation — Sector and macro ROTATION map for agents: where money is actually going, measured as each ETF's ratio to SPY against its own 50-day. ~50 sector + macro ETFs, each labelled GO (leading), HOLDING (paused), TURNING (money arriving) or OUT (lagging), with distance-to-50d %, 20-day slope % and ratio RSI. Pre-bucketed led_by/paused/turning/lagging lists. States and percentages only, never levels. Refreshed every ~5 min in US market hours. Research, not advice. (0.005 USDC on Base)
• GET /api/board/top-volume — Scores for the most-traded US stocks — the liquid mega-caps agents actually trade. One read returns the top names by 20-day average dollar volume in every S&P 500 sector, each scored: opportunity 0-100 plus board percentile, entry state (READY / SETUP / WAIT / CHASE / FALLING), hold strength, leadership flag, and the dollar-volume figure that ranked it. High-liquidity names only, no illiquid tail. Refreshed ~5 min in market hours. Research, not advice. (0.02 USDC on Solana)
• GET /api/board/sector — Every stock in one sector, scored — GET /api/board/sector?name=Energy (or ?etf=XLE) returns each member of that sector with the full Coil read: opportunity 0-100 + percentile, entry quality and state, hold strength, growth score, overnight gap-risk score, leadership flag and dollar volume, ranked by opportunity, plus the sector's own ETF row. All 20 sector groups across the S&P 500, Nasdaq-100 and macro book. ~5-min refresh. Research, not advice. (0.01 USDC on Solana)
• GET /api/board/name — Score one name or a whole watchlist in one read. GET /api/board/name?sym=NVDA (or ?sym=NVDA,AMD,MSFT — up to 10 names, one price) returns each name's full Coil read: opportunity 0-100 + percentile, entry quality and state (READY / SETUP / WAIT / CHASE / FALLING), hold strength, growth score, gap-risk, leadership flag, dollar volume, its coil read (coil_score, coil_kind, coil_note) and its book's regime. Any S&P 500, Nasdaq-100 or macro name. ~5-min refresh. Research, not advice. (0.005 USDC on Base)
• GET /api/board/leaders — Today's market leaders, ranked — which stocks are leading the tape right now? Top leadership names per book (S&P 500, Nasdaq-100, macro) by opportunity score, each with opportunity 0-100 + percentile, entry state, hold strength, growth score, dollar volume and coil read. Plus the AWARENESS block: sector money flows (mean move + breadth), coiled setups (compression or held post-catalyst, coil_score 0-100) and coverage. Refreshed ~5 min in market hours, timestamped. Research, not advice. (0.01 USDC on Solana)
• GET /api/board/regime — Market regime classifier for trading agents — is the tape risk-on or risk-off right now? Returns a regime verdict per book (S&P 500, Nasdaq-100, macro, crypto): trade, be selective, or stand down — with the market-state mode, which sectors are green, and the top-down permission ladder (index → sector → name) saying whether individual names are enterable at all. Refreshed ~5 min in market hours, timestamped. Research, not advice. (0.005 USDC on Solana)
• GET /api/board/indices — Index scores for trading agents — how strong is each major index right now? One read returns the scored index row per book: S&P 500 (SPY) and Nasdaq-100 (QQQ) plus the macro and BTC/ETH crypto books — 0-100 opportunity score, percentile, green/yellow/red light and entry state for each index, with every book's regime verdict alongside. The cheapest top-down read of the whole tape. Refreshed ~5 min in market hours, timestamped. Research, not advice. (0.005 USDC on Base)
• GET /api/board/day — Day-trade STATE MAP for agents: intraday multi-timeframe conditions on ~70 liquid names (14 market leaders + AI/semis + software cohorts), refreshed ~5 min in US market hours. Per name: an 18-cell lights grid (price/RSI/MACD x 5m-1D), GO (lights x fuel), FUEL vs the tab's anchor ETF, efficiency, ATR%, 20-day vs SPY, entry-window state, and ROOM to the nearest overhead level in % and bars. A state map, NOT a ranking - fully-lit boards flag ext:true (late). Research, not advice. (0.01 USDC on Solana)
• GET /api/tradfi-risk — TradFi risk-on/risk-off in one $0.003 call for crypto agents. Returns the S&P 500 and Nasdaq-100 regime state, how many equity sectors are green out of 11 (breadth), whether the permission ladder allows risk at all, and the same engine's BTC/ETH trend gate — size against equity risk appetite instead of guessing. Regime states flip rarely (days, not minutes); recomputed ~5-9 min in-session by a live long-only engine scoring ~565 US names. Research, not advice. (0.003 USDC on Base)

+3 more endpoints.

MCP tools (46)

coil-scanner https://coil.trade/mcp

• add_to_cart — Storefront: add a billing variant (e.g. coil-scanner-monthly). One licence per person, quantity 1.
• checkout_handoff — Storefront: the hosted checkout link for each cart line (Gumroad, merchant of record; promo code applied while a sale is live). The person completes payment there; nothing is charged by this tool.
• get_board_asof — Point-in-time archive: the scores Coil actually published on an archived date, sha256-committed before outcomes were known, append-only, never revised. Backtest-grade provenance. Without `date` it returns the list of archived dates. Paid per call via x402. $0.02 USDC per call (x402).
• get_board_changes — What changed on the board since a stored state_hash: names that entered or left the READY candidate pool, per-name trend-state / light / leadership / hold-band flips, and any regime or permission-ladder move per book. Takes `since`, the state_hash of a previous board-state poll. An unchanged hash is answered free and never billed. Otherwise paid per call via x402. $0.01 USDC per call (x402).
• get_buy_list — Today's ranked buy-list candidates per book across two lanes (risk-adjusted and swing), each with buy/entry/growth/hold scores, a leadership flag and an entry-window note, plus the regime mode showing whether the list is actionable at all. Free; data is one market day delayed.
• get_buy_list_live — Live intraday ranked buy-list candidates while their entry windows (READY/SETUP) are still open. Paid per call via x402; live intraday data. $0.02 USDC per call (x402).
• get_cart — Storefront: the session's cart (X-Session-Id / Mcp-Session-Id).
• get_crypto_day — 24/7 crypto day-state PREVIEW: the top-3 of 81 Robinhood-tradable coins by trend rank, plus the board's BTC anchor, the daily BTC/ETH gate regime and breadth counts. A live trimmed slice of the full state map (trend distances, tape lights, ATR%, relative strength vs BTC, room, volume z-score, UP/CHOP/DOWN state per coin), not a delayed copy. A state map, not a ranking or advice. Free.
• get_crypto_day_live — The FULL 24/7 crypto day-state board: all 81 Robinhood-tradable coins with trend distances (20/50/200-day), multi-timeframe tape lights, ATR%, relative strength vs BTC, room to the 20-day high, volume z-score, mechanical UP/CHOP/DOWN state and cross-sectional ranks, plus the daily BTC/ETH gate and breadth. Publishes about every 5 minutes around the clock when the market moved. A state map, not a ranking. Paid per call via x402. $0.005 USDC per call (x402).
• get_crypto_night — Overnight crypto continuation PREVIEW: the #1 session-momentum coin (of the top-5) heading into the 20:00 UTC signal across 81 Robinhood-tradable coins, plus the BTC 200-day regime gate, the pre/post-signal phase and the pre-registered study receipts. The ranking beat its random null at every fee tier in the cold study; at Robinhood retail fees the studied trade was REFUTED (the refutation ships in the read). A state read, not advice. Free.
• get_crypto_night_live — The FULL overnight continuation read: all top-5 session-momentum coins into the 20:00 UTC signal (81-coin Robinhood-tradable universe), the BTC 200-day regime gate state, the pre/post-signal phase clock, eligibility counts and the registered rule + study receipts (gross edge, null comparison, the retail-fee REFUTATION and breakeven bps, attached to every read). ~15-min refresh, 24/7. Paid per call via x402. $0.001 USDC per call (x402).
• get_crypto_setups — Crypto SETUP scan PREVIEW: how many of the 81 Robinhood-tradable coins currently show one of the two washed-shape SETUP patterns, plus the top-3 hits by grade with GO, fuel vs BTC and room. A live trimmed slice of the full scan. Shapes were backtest-confirmed on equities and are forward-graded on crypto; a descriptive marker, not advice. Free.
• get_crypto_setups_live — Scan of all 81 Robinhood-tradable coins for the two WASHED SETUP shapes (daily uptrend + washed-out 5-minute tape): every hit with GO, fuel multiple vs BTC, grade and room, plus the setup column for the full universe. Recomputed about every 5 minutes, 24/7. Shapes were backtest-confirmed on equities and are forward-graded on crypto (disclosed per read). Paid per call via x402. $0.05 USDC per call (x402).
• get_crypto_trend — Bitcoin and Ethereum trend signal: the long-only state for each sleeve (LONG or CASH), the 50-day trend gate each trades on, and the BTC 200-day master gate that overrides both, evaluated on UTC daily closes with price and day change. A rules-based risk-on/risk-off verdict for crypto, not raw price data. Free; exactly one completed UTC close behind, evaluated every calendar day including weekends and stamped with the close used (signal_close_date).
• get_crypto_trend_live — Bitcoin and Ethereum trend signal (LONG or CASH per sleeve, 50-day trend gates, BTC 200-day master gate) on the newest completed UTC daily close, evaluated every calendar day including weekends and stamped with the close used (one close ahead of the free tier). Paid per call via x402. $0.005 USDC per call (x402).
• get_day_board — Yesterday's day-trade state map: per-name intraday lights grid (price/RSI/MACD x 5m-1D), GO, FUEL vs anchor ETF, entry-window state and ROOM for ~70 liquid names. Day states decay in minutes, so this delayed tier is a schema/shape preview, not a trading input. Free; data is one market day delayed.
• get_day_board_live — LIVE day-trade state map (~5 min refresh in market hours): 18-cell lights grid, GO, FUEL vs the tab's anchor ETF, efficiency, ATR%, vs-SPY, entry-window state and ROOM (% + bars to the nearest overhead level) on ~70 liquid names. A STATE MAP, not a ranking; all-lit boards flag ext:true (late). Paid per call via x402; live intraday data. $0.01 USDC per call (x402).
• get_engine_feed — THE COIL LIVE FEED: the engine-grade board Coil's live record trades from, a superset of the complete live board that adds per-name structural stop and target levels, stop/target basis, risk-reward, buy_score, conviction, lane, leveraged vehicle and ladder placement (engine_fields, including coil_score / coil_kind). Optional symbols[] filter. Refreshed about every 5 minutes in market hours; identical for every subscriber; research, not advice. Engine fields are self-described in the payload's `schema` block (key · tier · description · since). Access: a Coil Live license in the X-License-Key header.
• get_fulfillment_options — Storefront: digital delivery — instant, no fee.
• get_full_board — The complete live board in one payload: every scored name (~565 across S&P 500, Nasdaq-100, macro), sector lanes, both buy-list lanes, regime and crypto books. Every name carries its coil read (coil_score / coil_kind / coil_note) and the payload carries the awareness block (leaders, sector flows, coiled, coverage). Fields are self-described in the payload's `schema` block (key · tier · description · since). Paid per call via x402; live intraday data. $0.10 USDC per call (x402).
• get_hold_state — THE SELL-SIDE READ: is the case for a name you already hold still intact, or deteriorating? Returns published trend state, hold strength 0-100, readiness, maturity-late flag, overnight gap-risk grade, the book's regime, and watch_flags: which deterioration conditions are TRUE right now (structure light off green, leadership lost, mature leg, trend cold, high gap risk, earnings inside a week), plus the mechanical rules those states flip on. BTC-USD / ETH-USD return the crypto IN|CASH daily-close state. Up to 10 comma-separated symbols. Reports conditions only; impersonal, it never reads your entry, size or account. Free; data is one market day delayed.
• get_hold_state_live — Live intraday SELL-SIDE read on names you already hold: current-session trend state, hold strength, readiness, maturity-late flag, gap-risk grade, book regime, and watch_flags naming which deterioration conditions are true right now. Up to 10 symbols per call. Reports conditions only; it never reads your entry or size. Paid per call via x402; live intraday data. $0.005 USDC per call (x402).
• get_live_rules — The Coil Live served rulebook (versioned): cycle order, exits-first, stop derivation, day-lane rhythm, sizing and fail-closed rules for the engine-grade feed. The payload states when rules changed. Access: a Coil Live license in the X-License-Key header.
• get_live_setup — Coil Live connection details: what the subscription unlocks (every live-tier read without per-call payment, the engine feed and the live rulebook), how the license key is sent, the recommended polling cadence, and what happens fail-closed if the subscription lapses. Free; no key needed.
• get_market_leaders — Today's market leaders, ranked: the top 10 leadership names per book by opportunity score (names in confirmed uptrends carrying the market's strength), each with the full score read. Includes the awareness block: sector money flows, coiled setups (coil_score 0-100, compression or held post-catalyst) and coverage. Rows carry every board-tier field the payload's `schema` block names. Free; data is one market day delayed.
• get_market_leaders_live — Top 10 leadership names per book by opportunity score, recomputed on the intraday board. Includes the live awareness block: sector money flows, coiled setups with coil_score, coverage. Paid per call via x402; live intraday data. $0.01 USDC per call (x402).
• get_market_regime — The top-down market regime read: risk-on, be-selective or stand-down. Returns the regime verdict, mode and permission ladder (index → sector → name) for each book (S&P 500, Nasdaq-100, macro, BTC/ETH crypto). Each book's regime carries `posture` (headline, tone, tape_posture and a note fusing the daily read, the intraday tape and the engine's management posture). Free; data is one market day delayed.
• get_market_regime_live — Live intraday market regime: the verdict, mode and permission ladder recomputed about every 5 minutes in market hours. Paid per call via x402; live intraday data. $0.005 USDC per call (x402).
• get_morning_brief — The whole market read in one payload: regime verdict per book, today's top-5 ranked buy candidates, the biggest gainers and losers, the BTC/ETH crypto trend-gate state and the awareness read (today's leaders, sector money flows in/out, the most coiled setups, coverage). Free; data is one market day delayed.
• get_morning_brief_live — Regime, top-5 candidates, movers and the crypto gate from the current session in one payload, including the live awareness read (leaders, money flows, coiled setups, coverage). Paid per call via x402; live intraday data. $0.02 USDC per call (x402).
• get_order_status — Storefront: NotOffered; Coil holds no order status.
• get_orders — Storefront: NotOffered — receipts and licence keys live with Gumroad.
• get_preferences — Storefront: guest profile — Coil keeps no customer accounts.
• get_product_details — Storefront: one product family with every billing variant, price, access terms and merchant of record.
• get_rotation — Sector and macro ROTATION map showing where the money is going. Each of ~50 sector and macro ETFs is scored on its ratio to SPY 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; the payload's `reading` field notes that confirmed rotation is late for a pullback buyer. Free; data is one market day delayed.
• get_rotation_live — Sector + macro X/SPY leadership states (GO / HOLDING / TURNING / OUT) recomputed on the intraday board. The payload's `reading` field notes that confirmed rotation is late for a pullback buyer. Paid per call via x402; live intraday data. $0.005 USDC per call (x402).
• get_sector_read — One sector's drill-down: every member of the sector scored and ranked by opportunity, plus the sector's own ETF row. Accepts a sector name (e.g. 'Energy', 'Information Technology') or its ETF symbol (e.g. XLE, XLK); unknown values return the sector directory. Free; data is one market day delayed.
• get_sector_read_live — A sector's members scored and ranked from the current session. Paid per call via x402; live intraday data. $0.01 USDC per call (x402).
• get_stock_read — One stock's full Coil read: opportunity 0-100 and board percentile, entry quality and state (READY / SETUP / WAIT / CHASE / FALLING), hold strength, leadership flag, its book's regime and its coil read (coil_score / coil_kind / coil_note). Covers any S&P 500, Nasdaq-100 or macro name; unknown symbols return the valid-symbol directory. Free; data is one market day delayed.
• get_stock_read_live — One stock's current-session scores and entry state, including the live coil read (coil_score / coil_kind / coil_note). Paid per call via x402; live intraday data. $0.005 USDC per call (x402).
• recall_memories — Storefront: memories saved in this session.
• remove_from_cart — Storefront: remove a line.
• save_memory — Storefront: save a session memory (kept one day).
• search_policies — Storefront: refunds, cancellation, delivery, merchant of record, risk disclosures, privacy, current promotion.
• search_products — Storefront: search Coil's two products (Coil Scanner, Coil Live). Returns product families with a from-price and their billing variants.
• update_cart_item — Storefront: set a line's quantity (0 removes; anything above 1 is held at 1).