joeyfife/coil-board-skill

Coil Board API

Coil veröffentlicht eine bewertete, gerankte Analyse des US-Aktienmarktes (sowie ein reines Long-Trendbuch für BTC/ETH), die ein Agent über x402 jeweils einzeln kaufen kann. Du kaufst keine rohen OHLCV-Daten – die gibt es überall kostenlos. Du kaufst das Urteil: welche Werte sind für einen Kauf bereit, wie stark das Regime ist und wie das Board heute von oben nach unten rankt.

Alles hier ist eine unpersönliche Forschungspublikation – identisch für jeden Käufer, nur Bewertungen und Zustände, niemals Stopp- oder Zielkurse, niemals individualisierte Beratung. Märkte können Geld verlieren.

Wann diese Fertigkeit verwenden

• Du brauchst eine Marktregime-Prüfung, bevor du etwas Kostspieliges tust: Ist gerade Risk-On oder Risk-Off? → rufe /api/board/regime auf ($0,005).
• Du möchtest die heutigen gerankten Kaufkandidaten, ohne selbst 500 Namen zu durchsuchen → rufe /api/board/buylist auf ($0,02).
• Du möchtest das gesamte Board – jeden bewerteten Namen in vier Büchern, Sektorspuren, beide Kauflistenspuren – um deine eigene Auswahl zu treffen → rufe /api/board/agent auf ($0,25).

Die Endpunkte (15 – vollständiger Katalog unter GET https://coil.trade/api)

Endpunkt	Preis (USDC)	Rückgabe
GET https://coil.trade/api/board/regime	0.005	Regimeurteil pro Buch (Risk-On / Be-Selective / Stand-Down) + die Index→Sektor→Name-Berechtigungsleiter.
GET https://coil.trade/api/board/crypto	0.005	BTC/ETH reines Long-Trendsignal: LONG oder CASH pro Abschnitt, 50-Tage-Gates + der BTC-200-Tage-Master-Gate (UTC-Tagesschlusskurse).
GET https://coil.trade/api/board/indices	0.005	Die bewertete Indexzeile pro Buch (SPY, QQQ, Makro, BTC/ETH) – die günstigste Top-down-Analyse.
GET https://coil.trade/api/board/name?sym=NVDA	0.005	Ein Aktienwert vollständig gelesen + das Regime seines Buches. Einer von ~560 Namen.
GET https://coil.trade/api/board/movers	0.005	Top 10 Gewinner + 10 Verlierer, vollständig bewertet.
GET https://coil.trade/api/board/sectors	0.01	Jeder Sektor-ETF bewertet + die grünen Sektoren des Regimes.
GET https://coil.trade/api/board/sector?name=Energy	0.01	Ein Sektor und seine Mitglieder, vollständig bewertet und gerankt (?etf=XLE funktioniert auch).
GET https://coil.trade/api/board/leaders	0.01	Top 10 Führungsnamen pro Buch nach Chance.
GET https://coil.trade/api/board/buylist	0.02	Die heutigen gerankten Kandidaten pro Buch in zwei Spuren, mit Einstiegsfenstern und Führungsflags.
GET https://coil.trade/api/board/top-volume	0.02	Top-5 nach 20-Tage-Dollarvolumen in jedem Sektor, vollständig bewertet.
GET https://coil.trade/api/crypto/gate	0.001	Die günstigste Prüfung: Ist der BTC-200-Tage-Master-Gate offen? LONG/CASH pro Abschnitt + Urteil.
GET https://coil.trade/api/tradfi-risk	0.003	TradFi-Risk-On/Off für Crypto-Agenten: S&P + Nasdaq-Regime, Sektorbreite, Leiter + das BTC/ETH-Gate.
GET https://coil.trade/api/board/brief	0.02	Das Morgenbriefing: Regime pro Buch + Top-5-Picks + größte Bewegungen + Crypto-Gate in einem Aufruf.
GET https://coil.trade/api/board/asof?date=YYYY-MM-DD	0.02	Zeitpunktbezogene archivierte Bewertungen, wörtlich aus dem Append-Only-Log – überprüfbar gegen das kostenlose /api/board/proof.
GET https://coil.trade/api/board/agent	0.25	Das vollständige Board: ~560 bewertete Namen, alle vier Bücher, Sektorboards, beide Kauflistenspuren.

Kostenlos, vor jeder Zahlung: GET /api/perf (die Erfolgsbilanz des Systems gegenüber SPY/QQQ) und GET /api/board/proof (Append-Only-Sha256-Verpflichtungen mit einem reproduzierbaren Verifikationsrezept) – prüfe den Herausgeber, bevor du ihm vertraust. POST /api/key mit einer E-Mail-Adresse gibt sofort einen kostenlosen Schlüssel (~25 Live-Aufrufe/Tag auf den günstigen Slice, X-Coil-Key-Header).

Kein Wallet? Dasselbe Board ist auch ein Remote-MCP-Server – Gratisstufe, volles Board mit einem Handelstag Verzögerung: claude mcp add --transport http coil https://coil.trade/mcp

Kopplung mit einem Broker (den Kreislauf schließen)

Coil veröffentlicht, was man sich ansehen sollte; es platziert niemals Aufträge und sieht niemals ein Konto. Wenn der Agent auch eine Ausführung hat – Robinhoods Trading MCP (Agentenkonten, budgetiertes Unterkonto) oder Alpacas MCP/CLI (Papierhandel, kein finanziertes Konto erforderlich) – lade beide Server im selben Client und folge dieser Lesereihenfolge:

1. get_market_regime – wenn die Leiter keine Namen zulässt, stehe still. Platziere keine Aufträge.
2. get_buy_list – berücksichtige nur Namen, die darauf erscheinen.
3. get_stock_read / get_sector_read – bohre in Kandidaten, bevor du dich festlegst.
4. Erst dann die Tools des Brokers, dimensioniert nach den eigenen Regeln des Betreibers.

get_morning_brief fasst die Schritte 1–2 in einem Aufruf zusammen. Coil gibt keine Positionsgrößen, keine Stoppkurse und keine Zielkurse aus – die Risikodefinition obliegt dem Betreiber, nicht dem Herausgeber. Vollständiges Rezept: https://coil.trade/agents/robinhood

Alle Live-Slices lesen aus demselben aktuellsten Payload (das As-of-Archiv bedient stattdessen das angeforderte Datum), sodass ein günstiger Slice nie älter ist als das vollständige Board. Während der US-Marktzeiten wird das Board etwa alle 5 Minuten neu berechnet; der Payload trägt computed_at und ein intraday-Flag sowie einen freshness-Block, der dir sagt, wann es sich wieder lohnt zu zahlen.

Zuerst kostenlos testen

Bevor du zahlst, validiere deinen Parser anhand der kostenlosen Vorschau – identisches Schema wie das kostenpflichtige Board, vorheriger Tag, Top-3-Namen pro Buch:

GET https://coil.trade/api/board/agent?preview=1

Es gibt auch eine immer kostenlose, verzögerte Stichprobe unter GET https://coil.trade/api/board/free.

Wie die Zahlung funktioniert (x402)

1. GET den Endpunkt ohne Zahlung. Er gibt HTTP 402 mit einem JSON-Body zurück, dessen accepts[0] die Anforderung beschreibt: amount (atomare USDC, 6 Dezimalstellen – 5000 = $0,005), asset (USDC 0x8335…2913), network (eip155:8453, Base) und payTo.
2. Signiere eine EIP-3009 TransferWithAuthorization für diesen Betrag an payTo und sende die Anfrage mit dem PAYMENT-SIGNATURE-Header erneut (Base64-x402-v2-Payload).
3. Bei Erfolg erhältst du HTTP 200 mit dem JSON-Board und einer On-Chain-Quittung im PAYMENT-RESPONSE-Header.

Jeder Standard-x402-Client erledigt diese Schleife für dich – z. B. x402-fetch mit einem EVM-Signer, Coinbase AgentKit oder einer x402-MCP-Bridge. Die Endpunkte sind im Coinbase CDP x402 Bazaar indiziert; Entdeckungsmetadaten gibt es auch unter https://coil.trade/.well-known/x402 und die OpenAPI-Spezifikation unter https://coil.trade/openapi.json.

Den Payload lesen

Jeder bewertete Name trägt (Feldnamen wie zurückgegeben):

• opp_pct – Chance, 0–100. Die Überschriften-Mischung des Boards.
• entry_q – Einstiegsqualität, 0–100. Jetzt kaufbar vs. überdehnt. Timing, keine Beratung.
• hold_q – Haltestärke, 0–100. Trendhaltbarkeit.
• state – firing / ready / setup / wait / chase / falling.
• sector, is_leader und (in Kauflistenspuren) ein window-Hinweis wie READY.

Jedes Buch trägt ein regime-Objekt: mode, ein verdict in Klartext, welche Sektoren grün sind und eine ladder (Index → Sektor → Name), die angibt, ob einzelne Namen überhaupt eingestiegen werden können. Lies von oben nach unten: Wenn das Regime Stand-Down sagt, sind die darunter gerankten Namen Kontext, kein grünes Licht.

Wissen, wann man zurückkommen sollte

Das Board ist eine dynamische Lektüre, keine einmalige Datei. Befrage regime günstig, um zu entscheiden, ob du die umfassenderen Slices kaufen solltest. Das Feld freshness.next_refresh_at sagt dir, wann es sich frühestens lohnt, für eine neue Payload zu zahlen; schnellere Abfragen geben dieselben Bytes zurück. Außerhalb der US-Marktzeiten erhältst du den morgendlichen Schnappschuss.

Was dies nicht ist

Keine Anlageberatung, kein verwaltetes Konto, kein Signaldienst, der Renditen verspricht, und keine Gewinngarantie. Bewertungen werden aus historischen und technischen Daten abgeleitet und sagen keine zukünftigen Ergebnisse voraus. Siehe https://coil.trade/terms.