{
 "openapi": "3.1.0",
 "info": {
  "title": "Coil Agent API",
  "version": "1.2.0",
  "description": "A trading desk's discipline for your AI agent: when to trade, when to wait and when to sit in cash, plus the scores to act on. Market data and trading signals for AI agents, paid per call in USDC — no account, no API key, no signup. New here? Start with GET /api/crypto/gate — $0.001, the cheapest answer we sell and the most common first call: is crypto risk-on right now. Paid endpoints run from $0.001 to $0.25 per read, plus the published research studies (free index: GET /api/research), plus a $0.25 one-hour Coil Live session: market regime verdicts, 0-100 opportunity / entry-timing / hold-strength scores per name, ranked buy lists, sector and macro rotation, day-trade state maps, per-symbol hold state, a point-in-time archive, and a 24/7 crypto board — across 650+ names (S&P 500, Nasdaq-100, macro ETFs) and 81 Robinhood-tradable crypto pairs. Equities re-score about every 5 minutes through the US market day; crypto runs around the clock. Every response is timestamped (computed_at) and carries an on-chain settlement receipt.\n\nFREE FIRST, no payment and no key: a live top-3 preview per book (/api/board/agent?preview=1, identical schema), a sample of the board's morning read (top 3 per book, headline fields) over MCP (claude mcp add --transport http coil https://mcp.coil.trade/mcp), one complete committed day from the append-only log, our own forward-return audit (/api/board/signal-audit) and a sha256 commitment log (/api/board/proof). A free key or a wallet sign-in (SIWX) unlocks ~25 live calls/day on the cheap reads.\n\nImpersonal research publication — identical for every buyer, not individualized investment advice; scores describe historical and technical structure, not future returns. Markets can lose money; crypto is highly volatile and can lose value rapidly, including total loss.",
  "x-guidance": "The reads follow a trading desk's routine, top-down: the gate first (is the market worth trading today; on a cash reading nothing new opens), then where money is moving, then the set-ups with their entry windows, then one name before any buy, and the hold state of what you own (a broken trend ends the thesis; exits come before entries). Start here: /api/crypto/gate ($0.001) is the cheapest answer we sell and the most common first call — is crypto risk-on right now, straight from the BTC 200-day master gate. /api/board/regime ($0.005) asks the same question of the equity tape and /api/board/indices ($0.005) gives the index ladder; those two are the usual next calls. Then drill in. If the regime is favorable, /api/board/buylist ($0.05) returns today's ranked candidates, or /api/board/name?sym=NVDA ($0.005, up to 10 symbols) scores tickers you hold. /api/board/hold?sym= ($0.005) says whether a position's trend state is intact. /api/crypto/day ($0.005) is the 24/7 board for 81 Robinhood-tradable coins. Call any paid path with no payment header to get HTTP 402 carrying BOTH x402 v2 requirements (also base64 in PAYMENT-REQUIRED) and an MPP 'WWW-Authenticate: Payment' challenge; pay on Base, Solana or Algorand and the same request returns JSON plus an on-chain receipt. 402 amounts are atomic units (USDC 6dp: $0.005 = \"5000\"); OpenAPI price.amount is decimal USD. Free first: ?preview=1, the delayed MCP server, /api/board/signal-audit, /api/board/proof; poll /api/board/state (free) and buy only when its hash moves. Rank by opp_pct; read the book regime before acting on any name score. BEHAVIOUR LAYER: when to call, when to come back and when to STOP is the skill at https://coil.trade/skills/coil-board/SKILL.md (an agent reading only this spec never saw it before). ALGORAND FEES ARE SPONSORED: both Algorand rails carry a feePayer, so you need zero ALGO to pay — Base and Solana require gas tokens. That rail is easiest for a wallet holding only USDC.",
  "contact": {
   "email": "support@coil.trade",
   "url": "https://coil.trade/agents"
  },
  "x-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)."
 },
 "servers": [
  {
   "url": "https://coil.trade"
  }
 ],
 "tags": [
  {
   "name": "Market Data",
   "description": "Paid per-read slices of the scored board — regime, buy list, per-name and per-sector reads, crypto. USDC over x402; no account, no key."
  },
  {
   "name": "Change Detection",
   "description": "The polling loop: hash the board for free, buy the delta only when it moves. An unchanged hash is never billed."
  },
  {
   "name": "Verification",
   "description": "Free, before any payment — the append-only commitment log, the forward-return audit of our own scores, and the engine's record vs SPY/QQQ. Check the publisher before trusting it."
  },
  {
   "name": "Access & Keys",
   "description": "Free credentials — an instant email key, or wallet sign-in (SIWX, CAIP-122). Signatures move no funds."
  },
  {
   "name": "Coil Live",
   "description": "Subscription lane ($49/mo): the engine feed and the served, versioned trading discipline. License key, never sold per call."
  }
 ],
 "paths": {
  "/api/board/agent": {
   "get": {
    "operationId": "getBoardAgent",
    "summary": "The full scored board — 650+ names, every book, sector lanes, both buy lists",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.050000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy one read of the full Coil Scanner board (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy one read of the full Coil Scanner board (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "31566704",
       "description": "Buy one read of the full Coil Scanner board (x402, USDC on Base) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy one read of the full Coil Scanner board (x402, USDC on Base) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "The full scored board (fresh; carries computed_at + intraday flag). Settlement receipt in the PAYMENT-RESPONSE header. Includes a `freshness` object (market_open, data_age_seconds, next_refresh_at, poll_hint) so a client polls only when the board has actually changed.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "product": {
           "type": "string",
           "const": "coil-board"
          },
          "asof_daily": {
           "type": "string",
           "description": "trading day of the scan, YYYY-MM-DD"
          },
          "computed_at": {
           "type": "string",
           "description": "when this scan was computed (PT)"
          },
          "intraday": {
           "type": "boolean"
          },
          "book_order": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "books": {
           "type": "object",
           "description": "per-book regime verdict, index/sector cards, buy-list lanes"
          },
          "names": {
           "type": "array",
           "description": "650+ scored names",
           "items": {
            "type": "object",
            "properties": {
             "sym": {
              "type": "string"
             },
             "name": {
              "type": "string"
             },
             "sector": {
              "type": "string"
             },
             "price": {
              "type": "number"
             },
             "chg_pct": {
              "type": "number"
             },
             "opp_score": {
              "type": "number",
              "description": "0-100 opportunity blend"
             },
             "opp_pct": {
              "type": "number",
              "description": "cross-sectional percentile"
             },
             "state": {
              "type": "string",
              "description": "entry state: READY/SETUP/WAIT/CHASE/FALLING (plus firing/cold light)"
             },
             "entry_q": {
              "type": "number"
             },
             "hold_q": {
              "type": "number"
             },
             "hold_label": {
              "type": "string"
             },
             "is_leader": {
              "type": "boolean"
             }
            }
           }
          },
          "disclaimer": {
           "type": "string"
          }
         }
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "parameters": [
     {
      "name": "preview",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "1"
       ]
      },
      "description": "Set to 1 for a FREE sample in the identical schema to the paid board (previous day, top-3 names per book) — validate your parser before paying. No payment header needed."
     },
     {
      "name": "preview",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "1"
       ]
      },
      "description": "preview=1 returns a FREE identical-schema preview (previous day, top-3 per book) — no payment."
     },
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "description": "The full scored board — 650+ names, every book, sector lanes, both buy lists. $0.05 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. Polling? Read the free /api/board/state, then send the hash you last saw to /api/board/diff as since=: if nothing moved, the answer is free; if something did, it is a $0.01 read of what moved. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/board/free": {
   "get": {
    "operationId": "getBoardFree",
    "summary": "Free sample — today's board, top-3 per book, refreshed about hourly in market hours",
    "tags": [
     "Market Data"
    ],
    "responses": {
     "200": {
      "description": "Today's board trimmed to the top 3 names per book, identical schema to the paid read. It is rebuilt about hourly during US market hours, so during a session it lags the paid board, which re-scores about every 5 minutes; x-coil-data-age and the freshness block say by how much.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/api/board/regime": {
   "get": {
    "operationId": "getBoardRegime",
    "summary": "Stock market regime today: is the market worth trading? Is the tape risk-on or risk-off? Regime verdict + permission ladder, per book",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.005000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the market-regime verdict only (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the market-regime verdict only (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "31566704",
       "description": "Buy the market-regime verdict only (x402, USDC on Base) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the market-regime verdict only (x402, USDC on Base) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Regime verdict per book — risk-on / be-selective / stand-down — plus the top-down permission ladder (index to sector to name). Settlement receipt in the PAYMENT-RESPONSE header. Includes a `freshness` object (market_open, data_age_seconds, next_refresh_at, poll_hint) so a client polls only when the board has actually changed.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "Stock market regime today: is the market worth trading? Is the tape risk-on or risk-off? Regime verdict + permission ladder, per book. $0.005 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. Polling? Read the free /api/board/state, then send the hash you last saw to /api/board/diff as since=: if nothing moved, the answer is free; if something did, it is a $0.01 read of what moved. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     },
     {
      "name": "X-Coil-Key",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Free-tier key (coilfree_/coilwallet_) — ~25 live calls/day on this endpoint instead of paying. Mint at POST /api/key or via SIWX at /api/auth/verify."
     },
     {
      "name": "SIGN-IN-WITH-X",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "SIWX (CAIP-122) wallet sign-in: base64 {message, signature, chainId, type}. Serves the free tier keyed to the wallet — no payment, no key mint."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     },
     {
      "coilKey": []
     }
    ]
   }
  },
  "/api/board/buylist": {
   "get": {
    "operationId": "getBoardBuylist",
    "summary": "Which stocks to buy today: the buy list. Today's ranked buy candidates per book, with entry windows and leadership flags",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.050000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy today's ranked buy list only (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy today's ranked buy list only (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "31566704",
       "description": "Buy today's ranked buy list only (x402, USDC on Base) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy today's ranked buy list only (x402, USDC on Base) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Today's ranked candidate names per book across both lanes (risk-adjusted + swing), with entry windows and leadership flags. Settlement receipt in the PAYMENT-RESPONSE header. Includes a `freshness` object (market_open, data_age_seconds, next_refresh_at, poll_hint) so a client polls only when the board has actually changed.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "Which stocks to buy today: the buy list. Today's ranked buy candidates per book, with entry windows and leadership flags. $0.05 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. Polling? Read the free /api/board/state, then send the hash you last saw to /api/board/diff as since=: if nothing moved, the answer is free; if something did, it is a $0.01 read of what moved. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/board/status": {
   "get": {
    "operationId": "getBoardStatus",
    "summary": "Service status: reads served, last settlement, and benchmark-relative performance (free)",
    "tags": [
     "Market Data"
    ],
    "responses": {
     "200": {
      "description": "Reads served, last settlement timestamp, and the engine's benchmark-relative performance block (percentages only).",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/api/board/indices": {
   "get": {
    "operationId": "getBoardIndices",
    "summary": "The cheapest top-down read — the scored index row for each book",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.005000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the index scores only (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the index scores only (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "31566704",
       "description": "Buy the index scores only (x402, USDC on Base) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the index scores only (x402, USDC on Base) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Scored index row per book — S&P 500 (SPY), Nasdaq-100 (QQQ), macro and BTC/ETH crypto — 0-100 opportunity score, percentile, light and entry state per index, plus each book's regime verdict. The cheapest top-down read of the tape. Settlement receipt in the PAYMENT-RESPONSE header. Includes the same `freshness` object as every Coil endpoint.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "The cheapest top-down read — the scored index row for each book. $0.005 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. Polling? Read the free /api/board/state, then send the hash you last saw to /api/board/diff as since=: if nothing moved, the answer is free; if something did, it is a $0.01 read of what moved. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     },
     {
      "name": "X-Coil-Key",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Free-tier key (coilfree_/coilwallet_) — ~25 live calls/day on this endpoint instead of paying. Mint at POST /api/key or via SIWX at /api/auth/verify."
     },
     {
      "name": "SIGN-IN-WITH-X",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "SIWX (CAIP-122) wallet sign-in: base64 {message, signature, chainId, type}. Serves the free tier keyed to the wallet — no payment, no key mint."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     },
     {
      "coilKey": []
     }
    ]
   }
  },
  "/api/board/sectors": {
   "get": {
    "operationId": "getBoardSectors",
    "summary": "Which sectors are strong right now? Every S&P sector ETF, scored",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.010000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the sector-rotation scores only (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the sector-rotation scores only (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "31566704",
       "description": "Buy the sector-rotation scores only (x402, USDC on Base) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the sector-rotation scores only (x402, USDC on Base) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Every S&P 500 sector ETF (XLK, XLF, XLV, XLE…) scored 0-100 with percentile, light and entry state, plus which sectors each book's regime calls green. Settlement receipt in the PAYMENT-RESPONSE header. Includes the same `freshness` object as every Coil endpoint.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "Which sectors are strong right now? Every S&P sector ETF, scored. $0.01 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. Polling? Read the free /api/board/state, then send the hash you last saw to /api/board/diff as since=: if nothing moved, the answer is free; if something did, it is a $0.01 read of what moved. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/board/top-volume": {
   "get": {
    "operationId": "getBoardTopVolume",
    "summary": "The liquid mega-caps agents actually trade — top 5 by dollar volume per sector",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.050000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy scores for the most-traded US stocks (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy scores for the most-traded US stocks (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "31566704",
       "description": "Buy scores for the most-traded US stocks (x402, USDC on Base) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy scores for the most-traded US stocks (x402, USDC on Base) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Top names by 20-day average dollar volume in every sector, each scored: opportunity 0-100 + percentile, entry state, hold strength, leadership flag, and the adv20_usd figure that ranked it. Settlement receipt in the PAYMENT-RESPONSE header. Includes the same `freshness` object as every Coil endpoint.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "The liquid mega-caps agents actually trade — top 5 by dollar volume per sector. $0.05 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. Polling? Read the free /api/board/state, then send the hash you last saw to /api/board/diff as since=: if nothing moved, the answer is free; if something did, it is a $0.01 read of what moved. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/board/name": {
   "get": {
    "operationId": "getBoardName",
    "summary": "How strong is this stock? Stock strength for any ticker. Score one ticker, or a whole watchlist — up to 10 symbols in a single call, each with its coil read (coil_score / coil_kind / coil_note)",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.005000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy one stock's full score read (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy one stock's full score read (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "31566704",
       "description": "Buy one stock's full score read (x402, USDC on Base) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy one stock's full score read (x402, USDC on Base) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Single-name read via ?sym= (e.g. ?sym=NVDA): opportunity 0-100 + percentile, entry quality/state, hold strength, growth score, overnight gap-risk score, leadership flag, dollar volume, plus its book's regime. Unknown sym returns the valid-symbol directory. Settlement receipt in the PAYMENT-RESPONSE header.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "parameters": [
     {
      "name": "sym",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "example": "NVDA,AMD,MSFT",
      "description": "One ticker, or up to 10 comma-separated for a batch read at the same price."
     },
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "description": "How strong is this stock? Stock strength for any ticker. Score one ticker, or a whole watchlist — up to 10 symbols in a single call, each with its coil read (coil_score / coil_kind / coil_note). $0.005 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. Polling? Read the free /api/board/state, then send the hash you last saw to /api/board/diff as since=: if nothing moved, the answer is free; if something did, it is a $0.01 read of what moved. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.\n\nBatch: ?sym=NVDA,AMD,MSFT returns up to 10 scored names in a single paid read.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/board/leaders": {
   "get": {
    "operationId": "getBoardLeaders",
    "summary": "Leading stocks today. Which names are leading the tape? The top 10 leadership names per book, plus the awareness read: sector money flows, coiled setups (coil_score) and coverage",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.010000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy today's ranked market leaders (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy today's ranked market leaders (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "31566704",
       "description": "Buy today's ranked market leaders (x402, USDC on Base) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy today's ranked market leaders (x402, USDC on Base) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Top 10 leadership names per book ranked by opportunity score, each with the full score read. Settlement receipt in the PAYMENT-RESPONSE header.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "Leading stocks today. Which names are leading the tape? The top 10 leadership names per book, plus the awareness read: sector money flows, coiled setups (coil_score) and coverage. $0.01 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. Polling? Read the free /api/board/state, then send the hash you last saw to /api/board/diff as since=: if nothing moved, the answer is free; if something did, it is a $0.01 read of what moved. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/board/movers": {
   "get": {
    "operationId": "getBoardMovers",
    "summary": "Today's biggest gainers and losers, fully scored rather than just ranked",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.005000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy today's biggest movers, scored (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy today's biggest movers, scored (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "31566704",
       "description": "Buy today's biggest movers, scored (x402, USDC on Base) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy today's biggest movers, scored (x402, USDC on Base) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Top 10 gainers and 10 losers by day % change with the full Coil read on each — which moves are chaseable structure vs falling knives. Settlement receipt in the PAYMENT-RESPONSE header.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "Today's biggest gainers and losers, fully scored rather than just ranked. $0.005 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. Polling? Read the free /api/board/state, then send the hash you last saw to /api/board/diff as since=: if nothing moved, the answer is free; if something did, it is a $0.01 read of what moved. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     },
     {
      "name": "X-Coil-Key",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Free-tier key (coilfree_/coilwallet_) — ~25 live calls/day on this endpoint instead of paying. Mint at POST /api/key or via SIWX at /api/auth/verify."
     },
     {
      "name": "SIGN-IN-WITH-X",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "SIWX (CAIP-122) wallet sign-in: base64 {message, signature, chainId, type}. Serves the free tier keyed to the wallet — no payment, no key mint."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     },
     {
      "coilKey": []
     }
    ]
   }
  },
  "/api/board/sector": {
   "get": {
    "operationId": "getBoardSector",
    "summary": "One sector's members, scored and ranked (?name=Energy or ?etf=XLE)",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.010000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy one sector's full member list, scored (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy one sector's full member list, scored (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "31566704",
       "description": "Buy one sector's full member list, scored (x402, USDC on Base) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy one sector's full member list, scored (x402, USDC on Base) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Every member of one sector with the full Coil read, ranked by opportunity, plus the sector's ETF row. Resolve by ?name=Energy or ?etf=XLE; unknown values return the sector directory. Settlement receipt in the PAYMENT-RESPONSE header.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "parameters": [
     {
      "name": "name",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "example": "Energy",
      "description": "Sector label (case-insensitive). One of the 20 sector groups — see the free /api/board/symbols directory."
     },
     {
      "name": "etf",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "example": "XLE",
      "description": "Alternatively, the sector's ETF symbol (XLE, XLK, XLF…)."
     },
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "description": "One sector's members, scored and ranked (?name=Energy or ?etf=XLE). $0.01 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. Polling? Read the free /api/board/state, then send the hash you last saw to /api/board/diff as since=: if nothing moved, the answer is free; if something did, it is a $0.01 read of what moved. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/board/symbols": {
   "get": {
    "operationId": "getBoardSymbols",
    "summary": "FREE — the purchasable-symbol directory (no payment)",
    "tags": [
     "Market Data"
    ],
    "responses": {
     "200": {
      "description": "Every purchasable symbol (sym, name, sector, book) plus sector member counts and usage pointers for the paid ?sym= / ?name= endpoints. Free, no payment header needed — learn the menu before spending.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/api/board/crypto": {
   "get": {
    "operationId": "getBoardCrypto",
    "summary": "BTC/ETH long-only trend state — LONG or CASH per sleeve, on UTC daily closes",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.005000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the BTC/ETH crypto trend signal (x402, USDC on Base or Algorand) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the BTC/ETH crypto trend signal (x402, USDC on Base or Algorand) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "31566704",
       "description": "Buy the BTC/ETH crypto trend signal (x402, USDC on Base or Algorand) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the BTC/ETH crypto trend signal (x402, USDC on Base or Algorand) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Long-only trend state for BTC and ETH (LONG or CASH per sleeve), each sleeve's 50-day gate and the BTC 200-day master gate, evaluated on UTC daily closes, with price and day change. Settlement receipt in the PAYMENT-RESPONSE header.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "BTC/ETH long-only trend state — LONG or CASH per sleeve, on UTC daily closes. $0.005 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/board/brief": {
   "get": {
    "operationId": "getBoardBrief",
    "summary": "The whole market read in one call — regime, top picks, movers, the crypto gate and the awareness read (leaders, money flows, coiled setups)",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.020000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the morning brief — the whole read in one call (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api Priced on convenience, not bytes: one $0.02 call replaces four separate reads (regime, buylist, movers, crypto gate), so it returns a small summary payload by design. If you want the full data behind each, the four underlying reads together cost about the same and return ~20x the bytes.",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "20000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the morning brief — the whole read in one call (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "20000",
       "currency": "31566704",
       "description": "Buy the morning brief — the whole read in one call (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "20000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the morning brief — the whole read in one call (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "20000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     },
     "price_basis": "Priced on convenience, not bytes: one $0.02 call replaces four separate reads (regime, buylist, movers, crypto gate), so it returns a small summary payload by design. If you want the full data behind each, the four underlying reads together cost about the same and return ~20x the bytes."
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Regime verdict per book, today's top-5 ranked buy candidates, biggest gainers and losers, and the BTC/ETH crypto trend-gate state — one call instead of four.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "The whole market read in one call — regime, top picks, movers, the crypto gate and the awareness read (leaders, money flows, coiled setups). $0.02 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. Polling? Read the free /api/board/state, then send the hash you last saw to /api/board/diff as since=: if nothing moved, the answer is free; if something did, it is a $0.01 read of what moved. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/crypto/gate": {
   "get": {
    "operationId": "getCryptoGate",
    "summary": "START HERE ($0.001) — is crypto risk-on? The BTC 200-day master gate, the cheapest answer we sell",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.001000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the crypto risk-on gate check (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "1000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the crypto risk-on gate check (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "1000",
       "currency": "31566704",
       "description": "Buy the crypto risk-on gate check (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "1000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the crypto risk-on gate check (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "1000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Whether the BTC 200-day master gate is open, the LONG/CASH state per sleeve, and the one-line verdict. The cheapest regime check on the menu — poll it, buy more only on change.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "START HERE ($0.001) — is crypto risk-on? The BTC 200-day master gate, the cheapest answer we sell. $0.001 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     },
     {
      "name": "X-Coil-Key",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Free-tier key (coilfree_/coilwallet_) — ~25 live calls/day on this endpoint instead of paying. Mint at POST /api/key or via SIWX at /api/auth/verify."
     },
     {
      "name": "SIGN-IN-WITH-X",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "SIWX (CAIP-122) wallet sign-in: base64 {message, signature, chainId, type}. Serves the free tier keyed to the wallet — no payment, no key mint."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     },
     {
      "coilKey": []
     }
    ]
   }
  },
  "/api/board/asof": {
   "get": {
    "operationId": "getBoardAsOf",
    "summary": "What did Coil actually publish on a given date? Immutable point-in-time scores",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.050000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy point-in-time published scores for a date (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api Priced on the guarantee, not the bytes: $0.05 buys an as-published, sha256-committed, never-revised snapshot of a past day, verifiable against the free /api/board/proof commitment log. The same-day scores are cheaper on the live endpoints; you are paying for immutability and lookahead-bias-free history.",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy point-in-time published scores for a date (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "31566704",
       "description": "Buy point-in-time published scores for a date (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy point-in-time published scores for a date (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     },
     "price_basis": "Priced on the guarantee, not the bytes: $0.05 buys an as-published, sha256-committed, never-revised snapshot of a past day, verifiable against the free /api/board/proof commitment log. The same-day scores are cheaper on the live endpoints; you are paying for immutability and lookahead-bias-free history."
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "As-published per-name scores (opportunity percentile, entry quality, hold strength) for an archived date. Served verbatim from the append-only publish log — lookahead-bias-clean by construction. Omit ?date= for the list of archived dates.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "parameters": [
     {
      "name": "date",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "format": "date"
      },
      "example": "2026-07-21",
      "description": "Archived publish date (YYYY-MM-DD). Omit to list archived dates."
     },
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "description": "What did Coil actually publish on a given date? Immutable point-in-time scores. $0.05 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.\n\nImmutable archive: one new date per session, never revised.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/tradfi-risk": {
   "get": {
    "operationId": "getTradfiRisk",
    "summary": "TradFi risk-on/off for a crypto agent — S&P + Nasdaq regime, breadth and ladder",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.003000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the TradFi risk-on/off input for a crypto agent (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "3000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the TradFi risk-on/off input for a crypto agent (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "3000",
       "currency": "31566704",
       "description": "Buy the TradFi risk-on/off input for a crypto agent (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "3000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the TradFi risk-on/off input for a crypto agent (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "3000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "S&P 500 + Nasdaq-100 regime state, sector breadth (green of 11), permission ladder, and the BTC/ETH trend gate — macro risk context in one call.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "TradFi risk-on/off for a crypto agent — S&P + Nasdaq regime, breadth and ladder. $0.003 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     },
     {
      "name": "X-Coil-Key",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Free-tier key (coilfree_/coilwallet_) — ~25 live calls/day on this endpoint instead of paying. Mint at POST /api/key or via SIWX at /api/auth/verify."
     },
     {
      "name": "SIGN-IN-WITH-X",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "SIWX (CAIP-122) wallet sign-in: base64 {message, signature, chainId, type}. Serves the free tier keyed to the wallet — no payment, no key mint."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     },
     {
      "coilKey": []
     }
    ]
   }
  },
  "/api/perf": {
   "get": {
    "operationId": "getEngineRecord",
    "summary": "FREE — the engine's record vs SPY and QQQ",
    "description": "Since inception: Engine-only, time-weighted return, net of deposits and withdrawals, with its thin-sample note. Omitted (null) rather than estimated when unavailable. No payment, no key.",
    "responses": {
     "200": {
      "description": "Record + method + link to the proof log"
     }
    },
    "security": [],
    "tags": [
     "Verification"
    ]
   }
  },
  "/api/board/proof": {
   "get": {
    "operationId": "getProofLog",
    "summary": "FREE — append-only sha256 commitments over the archive",
    "description": "Each day's published scores are committed to an append-only public log. Ships a verification recipe that reproduces byte-identically in Python and JavaScript. ?date=YYYY-MM-DD returns one commitment.",
    "parameters": [
     {
      "name": "date",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "format": "date"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Commitment log + recipe"
     }
    },
    "security": [],
    "tags": [
     "Verification"
    ]
   }
  },
  "/api/key": {
   "post": {
    "operationId": "issueFreeKey",
    "summary": "FREE — instant API key, 25 live calls/day",
    "description": "POST {\"email\": \"you@example.com\"} and receive a key immediately: ~25 live calls/day (enforced approximately) on regime, indices, movers, crypto gate, crypto night, tradfi-risk and hold state, sent as the X-Coil-Key header. Email is stored only as a one-way hash. Keys expire 90 days after issue; re-request with the same email.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "required": [
         "email"
        ],
        "properties": {
         "email": {
          "type": "string",
          "format": "email"
         }
        }
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The key + its limits"
     }
    },
    "security": [],
    "tags": [
     "Access & Keys"
    ]
   }
  },
  "/api/board/state": {
   "get": {
    "operationId": "getBoardState",
    "summary": "FREE — has the board materially changed?",
    "description": "Returns a hash of the material state (each book's regime mode and ladder rung, plus the firing/ready candidate set) and nothing else. Poll it free and unlimited; buy a paid read only when the hash changes. Supports If-None-Match for a 304. Deliberately excludes the publish timestamp, which moves ~every 5 minutes without the state meaningfully changing. Also returns PER-BOOK hashes (books.spx, books.qqq, …) so an equities agent is not woken by a crypto change.",
    "parameters": [
     {
      "name": "If-None-Match",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Your last state_hash, quoted. Returns 304 when unchanged."
     },
     {
      "name": "syms",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "example": "NVDA,AMD",
      "description": "Up to 25 tickers — returns a per-symbol hash so a watchlist agent polls only its own names."
     }
    ],
    "responses": {
     "200": {
      "description": "state_hash + freshness + where to buy when it moves"
     },
     "304": {
      "description": "Unchanged since your last read"
     }
    },
    "security": [],
    "tags": [
     "Change Detection"
    ]
   }
  },
  "/api/board/signal-audit": {
   "get": {
    "summary": "FREE — forward-return audit of our own published scores",
    "description": "Marks every committed score to market: top-decile and entry-quality cohorts vs the board median AND a sector-matched ETF control, 1-day and 5-day forward. Methodology was frozen before the first result and we publish it even when it reads negative. Free, no payment or key — the point is that you can check our work before paying for it.",
    "operationId": "getSignalAudit",
    "responses": {
     "200": {
      "description": "Audit payload (or a 'computing' status before the next settle pass)",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "security": [],
    "tags": [
     "Verification"
    ]
   }
  },
  "/api/board/day": {
   "get": {
    "operationId": "getDayStates",
    "summary": "Day-trade state map — intraday lights, GO, FUEL and ROOM across ~70 liquid names",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.010000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the day-trade state map — intraday lights/GO/FUEL/ROOM per name (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer in the endpoint's own 402 response.",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the day-trade state map — intraday lights/GO/FUEL/ROOM per name (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer in the endpoint's own 402 response."
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "31566704",
       "description": "Buy the day-trade state map — intraday lights/GO/FUEL/ROOM per name (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer in the endpoint's own 402 response."
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the day-trade state map — intraday lights/GO/FUEL/ROOM per name (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer in the endpoint's own 402 response."
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "The day-trade state map: per-name intraday lights grid, GO, FUEL vs the tab's anchor ETF, entry-window state and ROOM for ~70 liquid names, plus the reading_guide honesty block. Settlement receipt in the PAYMENT-RESPONSE header.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "Intraday multi-timeframe STATE MAP: per-name 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 (% + estimated 5m bars to the nearest overhead level; null = AIR/extended). A state map, NOT a ranking — the pre-registered backtest refuted GO as a ranking and fully-lit boards were LATE (ext:true flags them). Cohort tabs (AI/semis vs SOXX, software vs IGV) measure FUEL against their own anchor ETF. x402: $0.01 per read in USDC on Base, Solana, or Algorand.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/board/hold": {
   "get": {
    "operationId": "getHoldState",
    "summary": "Is this position's trend still intact? Hold state for up to 10 symbols at once",
    "tags": [
     "Market Data"
    ],
    "parameters": [
     {
      "name": "sym",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "Ticker, e.g. NVDA — or up to 10 comma-separated (NVDA,AMD,BTC-USD). Symbols that are not on the board fail FREE with a 400 pointing at /api/board/symbols — a typo is never billed."
     },
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     },
     {
      "name": "X-Coil-Key",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Free-tier key (coilfree_/coilwallet_) — ~25 live calls/day on this endpoint instead of paying. A free key reads up to 3 symbols per call (extras come back in free_key_sample.ignored); the paid read serves the full batch. Mint at POST /api/key or via SIWX at /api/auth/verify."
     },
     {
      "name": "SIGN-IN-WITH-X",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "SIWX (CAIP-122) wallet sign-in: base64 {message, signature, chainId, type}. Serves the free tier keyed to the wallet — no payment, no key mint."
     }
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.005000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy per-symbol hold-state reads — trend state, hold strength, gap-risk per name (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy per-symbol hold-state reads — trend state, hold strength, gap-risk per name (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "31566704",
       "description": "Buy per-symbol hold-state reads — trend state, hold strength, gap-risk per name (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy per-symbol hold-state reads — trend state, hold strength, gap-risk per name (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Per-symbol hold state for up to 10 names: published trend state, hold strength 0-100, readiness, maturity-late flag, overnight gap-risk grade and each book's regime, with the mechanical rules the states flip on (BTC-USD/ETH-USD return the crypto book's IN|CASH daily-close state). Impersonal publication — never ingests a buyer's entry or size. Settlement receipt in the PAYMENT-RESPONSE header. Includes a `freshness` object (market_open, data_age_seconds, next_refresh_at, poll_hint).",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "Per-symbol HOLD-STATE read for names already tracked: GET /api/board/hold?sym=NVDA (or ?sym=NVDA,AMD,BTC-USD — up to 10 names, one price) returns each name's published trend state, hold strength, readiness, maturity-late flag, overnight gap-risk grade and its book's regime, plus the mechanical rules the states flip on. Refreshed ~5 min in US market hours. Scores and states only, never stop/target prices; an impersonal publication identical for every reader — it never reads a buyer's entry price or position size. Unknown symbols return the valid-symbol directory.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     },
     {
      "coilKey": []
     }
    ]
   }
  },
  "/api/board/diff": {
   "get": {
    "operationId": "getBoardDiff",
    "summary": "What changed since the state hash you hold — poll free, buy only when it moves",
    "tags": [
     "Change Detection"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.010000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the board diff — what changed since your last check (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer in the endpoint's own 402 response.",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the board diff — what changed since your last check (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer in the endpoint's own 402 response."
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "31566704",
       "description": "Buy the board diff — what changed since your last check (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer in the endpoint's own 402 response."
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the board diff — what changed since your last check (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer in the endpoint's own 402 response."
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "The deltas between the hash you passed and the board right now: regime and permission-ladder moves per book, candidates entered/left the READY pool, and per-name trend, light, leadership and hold-band flips, with a deterministic one-line summary. Settlement receipt in the PAYMENT-RESPONSE header.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     },
     "400": {
      "description": "Free, unbilled: ?since= missing, unknown or expired (no stored baseline to diff from). The body carries the current hash and the free /api/board/state endpoint to re-poll."
     }
    },
    "description": "Change detection for polling agents. Pass ?since= the state_hash from a previous FREE /api/board/state poll and receive only the deltas: 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 free hash tells you THAT the board moved; this tells you WHAT moved. Calling it with a hash equal to the current one is answered FREE with changed:false and is never billed; an unknown or expired hash also fails free with a 400. Baselines are stored for 7 days, written the first time a hash is observed.",
    "parameters": [
     {
      "name": "since",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "The state_hash you stored from a previous GET /api/board/state (16 hex chars). Baselines are kept 7 days."
     },
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/crypto/day": {
   "get": {
    "operationId": "getCryptoDayBoard",
    "summary": "24/7 crypto state board — 81 Robinhood-tradable coins: trend, tape, room and ranks",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.005000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the 24/7 crypto day-state board — 81 coins, trend/tape/rank states (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the 24/7 crypto day-state board — 81 coins, trend/tape/rank states (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "31566704",
       "description": "Buy the 24/7 crypto day-state board — 81 coins, trend/tape/rank states (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the 24/7 crypto day-state board — 81 coins, trend/tape/rank states (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "The 24/7 crypto day-state board: 81 Robinhood-tradable coins with trend distances, tape lights, ATR%, relative strength vs BTC, room, volume z-score, UP/CHOP/DOWN state and cross-sectional ranks, plus the daily BTC/ETH gate and breadth. Self-dated: the payload carries computed_at and its own cadence block (no X-Coil equity-freshness headers — this board is not tied to US market hours). Before the first publish it returns {available:false} with the cadence note. Settlement receipt in the PAYMENT-RESPONSE header."
     }
    },
    "description": "24/7 crypto day-state board for the Robinhood-tradable universe (81 coins): per coin price, 24h/7d change, trend distance vs the 20/50/200-day, ATR%, relative strength vs BTC, multi-timeframe tape lights, volume z-score, room to the 20-day high, mechanical UP/CHOP/DOWN state and cross-sectional rank — plus the daily BTC/ETH gate regime and breadth counts. A state map, not a ranking; distances and percentages only, never price levels. Refreshed about every 5 minutes around the clock, every day. x402: $0.005 per read in USDC on Base, Solana, or Algorand.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/crypto/night": {
   "get": {
    "operationId": "getCryptoNightRead",
    "summary": "Overnight continuation read — top-5 session momentum into the 20:00 UTC signal",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.001000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the overnight crypto continuation read — top-5 session momentum + regime gate + study receipts (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "1000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the overnight crypto continuation read — top-5 session momentum + regime gate + study receipts (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "1000",
       "currency": "31566704",
       "description": "Buy the overnight crypto continuation read — top-5 session momentum + regime gate + study receipts (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "1000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the overnight crypto continuation read — top-5 session momentum + regime gate + study receipts (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "1000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "The overnight continuation read: night_board (the 20:00 UTC signal clock, pre/post-signal phase, BTC 200-day gate state, eligible count, the top-5 session-momentum coins, the registered rule prose and the study block — gross edge, null comparison, the retail-fee REFUTATION, breakeven bps) plus universe/eligible counts. Self-dated via computed_at; before the night board's first publish it returns {available:false} with the cadence note. Settlement receipt in the PAYMENT-RESPONSE header."
     }
    },
    "description": "Pre-registered overnight continuation read for the Robinhood-tradable crypto universe (81 coins): the top-5 session-momentum coins heading into the 20:00 UTC signal, the BTC 200-day regime gate, the pre/post-signal phase and the cold-study receipts attached to every read — the ranking beat its random null at every fee tier, and at Robinhood retail taker fees the studied trade was REFUTED (breakeven ~19 bps/side). A state read with its refutation attached, not advice; scores and percentages only, never price levels. Refreshed about every 5 minutes around the clock, every day. x402: $0.001 per read in USDC on Base, Solana, or Algorand — the poll-gate tier.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     },
     {
      "name": "X-Coil-Key",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Free-tier key (coilfree_/coilwallet_) — ~25 live calls/day on this endpoint instead of paying. Mint at POST /api/key or via SIWX at /api/auth/verify."
     },
     {
      "name": "SIGN-IN-WITH-X",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "SIWX (CAIP-122) wallet sign-in: base64 {message, signature, chainId, type}. Serves the free tier keyed to the wallet — no payment, no key mint."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     },
     {
      "coilKey": []
     }
    ]
   }
  },
  "/api/auth/nonce": {
   "get": {
    "operationId": "getWalletAuthNonce",
    "summary": "SIWX wallet auth, step 1 — get the message to sign",
    "description": "Sign In With X (CAIP-122): returns the exact message the wallet must sign, with a stateless server-bound nonce. Free, no payment. Chains: base (any EVM signer), solana, algorand.",
    "parameters": [
     {
      "name": "address",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "description": "The wallet address signing in"
     },
     {
      "name": "chain",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "enum": [
        "base",
        "evm",
        "solana",
        "algorand"
       ],
       "default": "base"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "The message to sign, its nonce, and issued_at (10-minute window)."
     }
    },
    "security": [],
    "tags": [
     "Access & Keys"
    ]
   }
  },
  "/api/auth/verify": {
   "post": {
    "operationId": "verifyWalletAuth",
    "summary": "SIWX wallet auth, step 2 — verify the signature, mint a free-tier key",
    "description": "Verifies the wallet signature over the issued message (EVM personal_sign via keccak/secp256k1 recovery; Solana/Algorand ed25519) and mints a coilwallet_ free-tier key — 25 calls/day on regime, indices, movers, crypto gate, crypto night, tradfi-risk and hold state, sent as the X-Coil-Key header. One key per address; re-verifying returns the same key. The signature is a message, not a transaction — no funds move.",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "required": [
         "address",
         "issued_at",
         "signature"
        ],
        "properties": {
         "chain": {
          "type": "string",
          "enum": [
           "base",
           "evm",
           "solana",
           "algorand"
          ],
          "default": "base"
         },
         "address": {
          "type": "string"
         },
         "issued_at": {
          "type": "string",
          "description": "issued_at from /api/auth/nonce, verbatim"
         },
         "signature": {
          "type": "string",
          "description": "hex (EVM), base64, or base58"
         }
        }
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "The coilwallet_ key, its daily limit, and the endpoints it opens."
     },
     "401": {
      "description": "Signature does not verify for this address."
     }
    },
    "security": [],
    "tags": [
     "Access & Keys"
    ]
   }
  },
  "/api/crypto/setup": {
   "get": {
    "operationId": "getCryptoSetupScan",
    "summary": "Which of 81 coins are in a washed setup right now? A full-universe scan",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.050000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the crypto SETUP scan — washed-shape hits across 81 coins (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the crypto SETUP scan — washed-shape hits across 81 coins (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "31566704",
       "description": "Buy the crypto SETUP scan — washed-shape hits across 81 coins (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the crypto SETUP scan — washed-shape hits across 81 coins (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "50000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "The 24/7 crypto day-state board: 81 Robinhood-tradable coins with trend distances, tape lights, ATR%, relative strength vs BTC, room, volume z-score, UP/CHOP/DOWN state and cross-sectional ranks, plus the daily BTC/ETH gate and breadth. Self-dated: the payload carries computed_at and its own cadence block (no X-Coil equity-freshness headers — this board is not tied to US market hours). Before the first publish it returns {available:false} with the cadence note. Settlement receipt in the PAYMENT-RESPONSE header."
     }
    },
    "description": "One paid read scans all 81 Robinhood-tradable coins for the two washed-shape SETUP patterns (daily uptrend + washed-out 5-minute tape) and returns every hit with GO, fuel multiple vs BTC, grade and room, plus the setup column for the full universe. Recomputed ~5 minutes, 24/7. Shapes were backtest-confirmed on equities; on crypto they are forward-graded and disclosed per read. $0.05 per read over x402. Research, not advice.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/live/feed": {
   "get": {
    "summary": "Coil Live — the engine feed",
    "description": "The board and rulebook the engine starts from, served to your agent: per-name structural stops, targets, conviction, lanes, plus a served candidates[] entry pool (a read-time join of READY picks and day-board grades — an empty list means the discipline is working, not an outage). Refreshed about every 5 minutes in market hours. Payload carries field_notes, timestamps_note and freshness.is_stale so an agent never has to guess at the vocabulary or do clock math. Subscription only — never sold per-call over x402. Engine fields include coil_score / coil_kind (compression or held post-catalyst) since 2026-09-03.",
    "operationId": "getLiveFeed",
    "tags": [
     "Coil Live"
    ],
    "security": [
     {
      "licenseKey": []
     }
    ],
    "parameters": [
     {
      "name": "symbols",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string",
       "example": "NVDA,MU"
      },
      "description": "Comma-separated tickers for a small poll read. candidates[] always rides whole regardless. Measured: unfiltered the payload is about 1.35 MB and a two-name read about 70 KB — never read the unfiltered feed into a model context; add compact=true (about 12 KB for two names)."
     },
     {
      "name": "compact",
      "in": "query",
      "required": false,
      "schema": {
       "type": "boolean"
      },
      "description": "Optional, default false (the full payload, unchanged). true = core fields only: names and engine_fields keep the core keys; schema, rotation, awareness, perf, pair_rotation, book detail beyond regime, and day rows/cohorts are dropped. candidates[], freshness and rules_version always ride."
     },
     {
      "name": "fields",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Optional: comma-separated engine_fields keys to keep per name (e.g. stop,target,rr). Unknown keys are echoed in unknown_fields."
     },
     {
      "name": "limit",
      "in": "query",
      "required": false,
      "schema": {
       "type": "integer",
       "minimum": 1,
       "maximum": 1000
      },
      "description": "Optional: page size, names per page, sorted by symbol (1-1000). The response carries page.next_cursor."
     },
     {
      "name": "cursor",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Optional: the page.next_cursor from the previous page (the last symbol returned). Omit for the first page."
     }
    ],
    "responses": {
     "200": {
      "description": "The engine feed.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "401": {
      "description": "No or invalid license key. Body: {\"error\":\"subscription_required\",\"note\":\"Coil Live ($49/mo or $419/yr) — subscribe at https://coil.trade/live-feed, then send the license as X-License-Key.\"}",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "string",
           "example": "subscription_required"
          },
          "note": {
           "type": "string"
          }
         }
        }
       }
      }
     }
    }
   }
  },
  "/api/live/setup": {
   "get": {
    "summary": "Coil Live — how to connect (free, no key)",
    "description": "Unauthenticated discovery: returns the product name, price, checkout URL and the exact header/MCP instructions for connecting an agent. Call this first.",
    "operationId": "getLiveSetup",
    "tags": [
     "Coil Live"
    ],
    "responses": {
     "200": {
      "description": "Connection instructions.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "product": {
           "type": "string",
           "example": "coil-live"
          },
          "price": {
           "type": "string",
           "example": "$49/mo or $419/yr"
          },
          "checkout": {
           "type": "string",
           "example": "https://coil.trade/live-feed"
          },
          "how": {
           "type": "string"
          },
          "docs": {
           "type": "string",
           "example": "https://coil.trade/agents"
          }
         }
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/api/live/rules": {
   "get": {
    "operationId": "getLiveRules",
    "summary": "Coil Live — the served trading discipline (versioned rulebook)",
    "description": "The versioned rulebook a subscriber's agent runs against /api/live/feed: cycle order, exits-first, the four entry guards (gap-down / broken-read / chase / day-low chase), the 3% max-loss stop, the losing-streak sizing rule, sizing precedence with the PDT bound, and fail-closed staleness. The response carries rules_version and a changelog; agents finish open positions under the version they were opened under and adopt new versions for new entries. Also served over MCP as the get_live_rules tool. Requires an active Coil Live subscription (X-License-Key).",
    "security": [
     {
      "licenseKey": []
     }
    ],
    "responses": {
     "200": {
      "description": "The served discipline",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "product": {
           "type": "string",
           "example": "coil-live-rules"
          },
          "rules_version": {
           "type": "string",
           "example": "1.3.0"
          },
          "changelog": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "version": {
              "type": "string"
             },
             "date": {
              "type": "string"
             },
             "note": {
              "type": "string"
             }
            }
           }
          },
          "rules": {
           "type": "string",
           "description": "The full rulebook, markdown"
          }
         },
         "required": [
          "rules_version",
          "rules"
         ]
        }
       }
      }
     },
     "401": {
      "description": "No or invalid license key. Body: {\"error\":\"subscription_required\",\"note\":\"Coil Live ($49/mo or $419/yr) — subscribe at https://coil.trade/live-feed, then send the license as X-License-Key.\"}",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "error": {
           "type": "string",
           "example": "subscription_required"
          },
          "note": {
           "type": "string"
          }
         }
        }
       }
      }
     },
     "403": {
      "description": "invalid_license"
     }
    },
    "tags": [
     "Coil Live"
    ]
   }
  },
  "/api/board/rotation": {
   "get": {
    "operationId": "getRotation",
    "summary": "Where is money actually going? ~50 sector and macro instruments as GO / HOLDING / TURNING / OUT",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.005000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the rotation map — sector + macro X/SPY leadership states (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer in the endpoint's own 402 response.",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the rotation map — sector + macro X/SPY leadership states (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer in the endpoint's own 402 response."
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "31566704",
       "description": "Buy the rotation map — sector + macro X/SPY leadership states (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer in the endpoint's own 402 response."
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the rotation map — sector + macro X/SPY leadership states (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer in the endpoint's own 402 response."
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "The rotation map: ~50 sector ETFs and macro instruments (bond, income, metals and commodity ETFs plus a few single mining stocks) each scored on its own X/SPY ratio versus that ratio's 50-day and labelled GO / HOLDING / TURNING / OUT, with distance-to-50d %, 20-day slope % and ratio RSI. A state map, not a buy list. Settlement receipt in the PAYMENT-RESPONSE header.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "description": "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.",
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/board/whynot": {
   "get": {
    "operationId": "getBoardWhyNot",
    "summary": "Why is this name not a candidate today? The gate for its book and sector, its entry window and earnings, in plain words \u2014 or the state that makes it one",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.005000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the reason one stock is not a candidate (x402, USDC on Base) \u2014 x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the reason one stock is not a candidate (x402, USDC on Base) \u2014 x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "31566704",
       "description": "Buy the reason one stock is not a candidate (x402, USDC on Base) \u2014 x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the reason one stock is not a candidate (x402, USDC on Base) \u2014 x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "5000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance \u2014 sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required \u2014 x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Single-name read via ?sym= (e.g. ?sym=NVDA): opportunity 0-100 + percentile, entry quality/state, hold strength, growth score, overnight gap-risk score, leadership flag, dollar volume, plus its book's regime. Unknown sym returns the valid-symbol directory. Settlement receipt in the PAYMENT-RESPONSE header.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time \u2014 you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "parameters": [
     {
      "name": "sym",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "example": "NVDA",
      "description": "One ticker. A symbol that is not on the board fails free with a 400, before any payment."
     },
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) \u2014 omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header \u2014 the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "description": "Why is this name not a candidate today? The gate for its book and sector, its entry window and earnings, in plain words — or the state that makes it one. $0.005 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. Polling? Read the free /api/board/state, then send the hash you last saw to /api/board/diff as since=: if nothing moved, the answer is free; if something did, it is a $0.01 read of what moved. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.\n\nOne symbol per read. States and reasons only, no scores; the answer closes with the discipline rule that applies (the `discipline` object).",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/board/checktrade": {
   "get": {
    "operationId": "getBoardCheckTrade",
    "summary": "Check your own long trade against the desk's discipline: the stop distance, chase or falling state, earnings, the gate and the Coil Live rulebook's sizing \u2014 a verdict of consistent, wait or pass",
    "tags": [
     "Market Data"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.010000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy a check of your own trade against the discipline and the rulebook's sizing (x402, USDC on Base) \u2014 x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy a check of your own trade against the discipline and the rulebook's sizing (x402, USDC on Base) \u2014 x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "31566704",
       "description": "Buy a check of your own trade against the discipline and the rulebook's sizing (x402, USDC on Base) \u2014 x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy a check of your own trade against the discipline and the rulebook's sizing (x402, USDC on Base) \u2014 x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "10000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance \u2014 sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required \u2014 x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "Single-name read via ?sym= (e.g. ?sym=NVDA): opportunity 0-100 + percentile, entry quality/state, hold strength, growth score, overnight gap-risk score, leadership flag, dollar volume, plus its book's regime. Unknown sym returns the valid-symbol directory. Settlement receipt in the PAYMENT-RESPONSE header.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time \u2014 you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    },
    "parameters": [
     {
      "name": "sym",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "example": "NVDA",
      "description": "One ticker."
     },
     {
      "name": "entry",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "example": "54.20",
      "description": "Your planned entry price, a positive number."
     },
     {
      "name": "stop",
      "in": "query",
      "required": true,
      "schema": {
       "type": "string"
      },
      "example": "51.50",
      "description": "Your stop price, below the entry."
     },
     {
      "name": "day_low",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "example": "52.80",
      "description": "Optional: the session low at your broker, to apply the rulebook's session-low chase guard when it states one."
     },
     {
      "name": "equity",
      "in": "query",
      "required": false,
      "schema": {
       "type": "string"
      },
      "example": "25000",
      "description": "Optional: account equity in dollars, to turn the size into shares."
     },
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) \u2014 omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header \u2014 the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     }
    ],
    "description": "Check your own long trade against the desk's discipline: the stop distance, chase or falling state, earnings, the gate and the Coil Live rulebook's sizing — a verdict of consistent, wait or pass. $0.01 per call over x402, USDC on Base, Solana or Algorand; the live offer is in this endpoint's 402. No wallet? A sample of the same board is FREE two other ways, with no payment, account, or key: the MCP server at https://mcp.coil.trade/mcp (`claude mcp add --transport http coil https://mcp.coil.trade/mcp`, a sample of the board's morning read: top 3 per book, headline fields), and https://coil.trade/api/board/agent?preview=1 (identical schema, previous day, top-3 per book). Humans/agents without crypto can subscribe at https://coil.trade/scanner.\n\nMalformed input (a missing or non-numeric number, a stop at or above the entry, an unknown symbol) fails free with a 400, before any payment. Impersonal: it reads only the numbers sent and never an account. The answer carries the `discipline` object.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/api/live/session": {
   "get": {
    "operationId": "postLiveSession",
    "summary": "Buy 1 hour of Coil Live with a wallet instead of a subscription",
    "description": "Mints a time-boxed Coil Live session token in exchange for an x402 payment. The token goes wherever a subscription license goes — header X-License-Key — and unlocks every *_live MCP tool plus get_engine_feed and get_live_rules, and the /api/live/* HTTP routes. The token is issued ONLY in the settled response; an unpaid call returns HTTP 402 with the terms. Sessions do not auto-renew. More than about 196 session-hours a month costs more than Coil Live ($49/mo) — subscribe if you run daily, buy a session for burst use.",
    "tags": [
     "Market Data"
    ],
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     },
     {
      "name": "X-Coil-Key",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Free-tier key (coilfree_/coilwallet_) — ~25 live calls/day on this endpoint instead of paying. Mint at POST /api/key or via SIWX at /api/auth/verify."
     },
     {
      "name": "SIGN-IN-WITH-X",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "SIWX (CAIP-122) wallet sign-in: base64 {message, signature, chainId, type}. Serves the free tier keyed to the wallet — no payment, no key mint."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.250000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "USD"
       }
      }
     ],
     "description": "Buy a 1-hour Coil Live session (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units."
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "A Coil Live session token, minted on settlement. Carries session_token, expires_at, duration_hours and the list of what it unlocks. Send the token as X-License-Key to open every *_live MCP tool plus get_engine_feed and get_live_rules, and the /api/live/* HTTP routes, for 6 hours. Issued ONLY in the settled response — an unpaid call returns 402 with the terms and no token.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    }
   },
   "post": {
    "operationId": "postLiveSessionPost",
    "summary": "Buy 1 hour of Coil Live with a wallet instead of a subscription",
    "description": "Mints a time-boxed Coil Live session token in exchange for an x402 payment. The token goes wherever a subscription license goes — header X-License-Key — and unlocks every *_live MCP tool plus get_engine_feed and get_live_rules, and the /api/live/* HTTP routes. The token is issued ONLY in the settled response; an unpaid call returns HTTP 402 with the terms. Sessions do not auto-renew. More than about 196 session-hours a month costs more than Coil Live ($49/mo) — subscribe if you run daily, buy a session for burst use.",
    "tags": [
     "Market Data"
    ],
    "parameters": [
     {
      "name": "PAYMENT-SIGNATURE",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
     },
     {
      "name": "X-PAYMENT",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
     },
     {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
     },
     {
      "name": "X-Coil-Key",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "Free-tier key (coilfree_/coilwallet_) — ~25 live calls/day on this endpoint instead of paying. Mint at POST /api/key or via SIWX at /api/auth/verify."
     },
     {
      "name": "SIGN-IN-WITH-X",
      "in": "header",
      "required": false,
      "schema": {
       "type": "string"
      },
      "description": "SIWX (CAIP-122) wallet sign-in: base64 {message, signature, chainId, type}. Serves the free tier keyed to the wallet — no payment, no key mint."
     }
    ],
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.250000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "USD"
       }
      }
     ],
     "description": "Buy a 1-hour Coil Live session (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units."
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header"
     },
     "200": {
      "description": "A Coil Live session token, minted on settlement. Carries session_token, expires_at, duration_hours and the list of what it unlocks. Send the token as X-License-Key to open every *_live MCP tool plus get_engine_feed and get_live_rules, and the /api/live/* HTTP routes, for 6 hours. Issued ONLY in the settled response — an unpaid call returns 402 with the terms and no token.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      },
      "headers": {
       "X-Coil-Market-Open": {
        "schema": {
         "type": "string",
         "enum": [
          "true",
          "false"
         ]
        },
        "description": "Whether the US equity market is open right now. When false the board will not change until the next session."
       },
       "X-Coil-Next-Refresh": {
        "schema": {
         "type": "string",
         "format": "date-time"
        },
        "description": "When the next board is expected. Do not re-buy before this time — you would receive an identical payload."
       },
       "X-Coil-Data-Age": {
        "schema": {
         "type": "string"
        },
        "description": "Age of the served board in seconds."
       }
      }
     }
    }
   }
  },
  "/api/research": {
   "get": {
    "operationId": "listResearch",
    "summary": "Free index of the published Coil Edge Research studies \u2014 question, pre-registered verdict, evidence class, data window, per-read price and the paid address of each full text",
    "tags": [
     "Research"
    ],
    "responses": {
     "200": {
      "description": "One row per published study: slug, title, question, verdict as the study's pre-registered bar states it, evidence class, data window, price in USD and atomic USDC, the free teaser page and the paid x402 address. The same rows come from the free MCP tool list_research. Each full text is sold separately, one read at a time.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "security": []
   }
  },
  "/learn/research/is-chasing-a-strong-stock-a-losing-habit/full": {
   "get": {
    "operationId": "getStudyChaseFull",
    "summary": "Coil Edge Research ($0.10 per read) — the full text of one published backtest: does chasing a stock near its high lose money?",
    "tags": [
     "Research"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.100000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "31566704",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header (USDC on Base, Solana or Algorand)"
     },
     "200": {
      "description": "The full study text as JSON: question, pre-registered bar, method, results, control comparisons, limits. Served only after the payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "description": "The full read of one published study: the pre-registered question and bar, the method, the results tables, the control comparisons and the limits. Each study is priced and paid for on its own: one payment unlocks this one study for this one read. A published study, not advice.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/learn/research/does-waiting-for-a-30-minute-pivot-candle-improve-a-stock-entry/full": {
   "get": {
    "operationId": "getStudyPivotCandleFull",
    "summary": "Coil Edge Research ($0.10 per read) — the full text of one published backtest: does waiting for a 30-minute pivot candle improve a stock entry?",
    "tags": [
     "Research"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.100000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "31566704",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header (USDC on Base, Solana or Algorand)"
     },
     "200": {
      "description": "The full study text as JSON: question, pre-registered bar, method, results, control comparisons, limits. Served only after the payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "description": "The full read of one published study: the pre-registered question and bar, the method, the results tables, the control comparisons and the limits. Each study is priced and paid for on its own: one payment unlocks this one study for this one read. A published study, not advice.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/learn/research/does-buying-the-opening-range-breakout-on-strong-stocks-make-money/full": {
   "get": {
    "operationId": "getStudyOpeningRangeFull",
    "summary": "Coil Edge Research ($0.10 per read) — the full text of one published backtest: does buying the opening-range breakout on strong stocks make money?",
    "tags": [
     "Research"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.100000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "31566704",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header (USDC on Base, Solana or Algorand)"
     },
     "200": {
      "description": "The full study text as JSON: question, pre-registered bar, method, results, control comparisons, limits. Served only after the payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "description": "The full read of one published study: the pre-registered question and bar, the method, the results tables, the control comparisons and the limits. Each study is priced and paid for on its own: one payment unlocks this one study for this one read. A published study, not advice.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/learn/research/does-a-trend-template-and-volatility-contraction-breakout-beat-the-market/full": {
   "get": {
    "operationId": "getStudyTrendTemplateFull",
    "summary": "Coil Edge Research ($0.10 per read) — the full text of one published backtest: does a trend-template and volatility-contraction breakout rule beat the market?",
    "tags": [
     "Research"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.100000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "31566704",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header (USDC on Base, Solana or Algorand)"
     },
     "200": {
      "description": "The full study text as JSON: question, pre-registered bar, method, results, control comparisons, limits. Served only after the payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "description": "The full read of one published study: the pre-registered question and bar, the method, the results tables, the control comparisons and the limits. Each study is priced and paid for on its own: one payment unlocks this one study for this one read. A published study, not advice.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/learn/research/does-weak-breadth-at-a-market-high-predict-a-worse-stock-market/full": {
   "get": {
    "operationId": "getStudyBreadthAtHighFull",
    "summary": "Coil Edge Research ($0.10 per read) — the full text of one published backtest: does weak breadth under a market at its high predict a worse stock market?",
    "tags": [
     "Research"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.100000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "31566704",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header (USDC on Base, Solana or Algorand)"
     },
     "200": {
      "description": "The full study text as JSON: question, pre-registered bar, method, results, control comparisons, limits. Served only after the payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "description": "The full read of one published study: the pre-registered question and bar, the method, the results tables, the control comparisons and the limits. Each study is priced and paid for on its own: one payment unlocks this one study for this one read. A published study, not advice.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/learn/research/does-buying-a-neglected-stock-after-a-big-volume-gap-up-beat-the-market/full": {
   "get": {
    "operationId": "getStudyGapUpTrailFull",
    "summary": "Coil Edge Research ($0.10 per read) — the full text of one published backtest: does buying a neglected stock after a big volume gap-up beat the market?",
    "tags": [
     "Research"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.100000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "31566704",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header (USDC on Base, Solana or Algorand)"
     },
     "200": {
      "description": "The full study text as JSON: question, pre-registered bar, method, results, control comparisons, limits. Served only after the payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "description": "The full read of one published study: the pre-registered question and bar, the method, the results tables, the control comparisons and the limits. Each study is priced and paid for on its own: one payment unlocks this one study for this one read. A published study, not advice.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/learn/research/does-buying-the-laggards-of-a-leading-sector-group-beat-the-market/full": {
   "get": {
    "operationId": "getStudySectorLaggardsFull",
    "summary": "Coil Edge Research ($0.10 per read) — the full text of one published backtest: does buying the laggards of a leading sector group beat the market?",
    "tags": [
     "Research"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.100000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "31566704",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header (USDC on Base, Solana or Algorand)"
     },
     "200": {
      "description": "The full study text as JSON: question, pre-registered bar, method, results, control comparisons, limits. Served only after the payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "description": "The full read of one published study: the pre-registered question and bar, the method, the results tables, the control comparisons and the limits. Each study is priced and paid for on its own: one payment unlocks this one study for this one read. A published study, not advice.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/learn/research/does-buying-a-3x-inverse-index-fund-after-a-gap-down-pay/full": {
   "get": {
    "operationId": "getStudyInverseFundGapFull",
    "summary": "Coil Edge Research ($0.10 per read) — the full text of one published backtest: does buying a -3x inverse index fund after a gap-down pay?",
    "tags": [
     "Research"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.100000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "31566704",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header (USDC on Base, Solana or Algorand)"
     },
     "200": {
      "description": "The full study text as JSON: question, pre-registered bar, method, results, control comparisons, limits. Served only after the payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "description": "The full read of one published study: the pre-registered question and bar, the method, the results tables, the control comparisons and the limits. Each study is priced and paid for on its own: one payment unlocks this one study for this one read. A published study, not advice.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/learn/research/does-buying-a-deeply-oversold-high-volatility-stock-the-next-day-pay/full": {
   "get": {
    "operationId": "getStudyOversoldReboundFull",
    "summary": "Coil Edge Research ($0.10 per read) — the full text of one published backtest: does buying a deeply oversold, high-volatility stock the next day pay by the close?",
    "tags": [
     "Research"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.100000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "31566704",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header (USDC on Base, Solana or Algorand)"
     },
     "200": {
      "description": "The full study text as JSON: question, pre-registered bar, method, results, control comparisons, limits. Served only after the payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "description": "The full read of one published study: the pre-registered question and bar, the method, the results tables, the control comparisons and the limits. Each study is priced and paid for on its own: one payment unlocks this one study for this one read. A published study, not advice.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
  "/learn/research/does-buying-a-sector-etf-that-money-is-rotating-into-beat-the-market/full": {
   "get": {
    "operationId": "getStudyPairTurnFull",
    "summary": "Coil Edge Research ($0.10 per read) — the full text of one published backtest: does buying a sector ETF that money is rotating into beat the market?",
    "tags": [
     "Research"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.100000"
     },
     "protocols": [
      {
       "x402": {}
      },
      {
       "mpp": {
        "method": "usdc",
        "intent": "charge",
        "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       }
      }
     ],
     "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
     "offers": [
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "31566704",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
       "description": "Buy the full text of one published study (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      },
      {
       "intent": "charge",
       "method": "x402",
       "amount": "100000",
       "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
       "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
      }
     ],
     "mpp": {
      "method": "usdc",
      "intent": "charge",
      "challenge": "WWW-Authenticate: Payment",
      "credential": "Authorization: Payment",
      "network": "eip155:8453"
     },
     "nanopayments": {
      "rail": "circle-gateway",
      "scheme": "exact",
      "network": "eip155:8453",
      "select": "the accepts entry with extra.name=GatewayWalletBatched",
      "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
     }
    },
    "responses": {
     "402": {
      "description": "Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header (USDC on Base, Solana or Algorand)"
     },
     "200": {
      "description": "The full study text as JSON: question, pre-registered bar, method, results, control comparisons, limits. Served only after the payment settles.",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "description": "The full read of one published study: the pre-registered question and bar, the method, the results tables, the control comparisons and the limits. Each study is priced and paid for on its own: one payment unlocks this one study for this one read. A published study, not advice.",
    "security": [
     {
      "x402": []
     },
     {
      "mpp": []
     }
    ]
   }
  },
 "/stocks/{symbol}/full": {
  "get": {
   "operationId": "getStockFull",
   "summary": "Coil Single-Name Score as a page ($0.005 per read) — the paid twin of /api/board/name for one symbol",
   "tags": [
    "Paid reads"
   ],
   "x-payment-info": {
    "price": {
     "mode": "fixed",
     "currency": "USD",
     "amount": "0.005000"
    },
    "protocols": [
     {
      "x402": {}
     },
     {
      "mpp": {
       "method": "usdc",
       "intent": "charge",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
      }
     }
    ],
    "description": "Buy one stock's full score read (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api",
    "offers": [
     {
      "intent": "charge",
      "method": "x402",
      "amount": "5000",
      "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "description": "Buy one stock's full score read (x402, USDC on Base) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
     },
     {
      "intent": "charge",
      "method": "x402",
      "amount": "5000",
      "currency": "31566704",
      "description": "Buy one stock's full score read (x402, USDC on Base) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
     },
     {
      "intent": "charge",
      "method": "x402",
      "amount": "5000",
      "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "description": "Buy one stock's full score read (x402, USDC on Base) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
     },
     {
      "intent": "charge",
      "method": "x402",
      "amount": "5000",
      "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
     }
    ],
    "mpp": {
     "method": "usdc",
     "intent": "charge",
     "challenge": "WWW-Authenticate: Payment",
     "credential": "Authorization: Payment",
     "network": "eip155:8453"
    },
    "nanopayments": {
     "rail": "circle-gateway",
     "scheme": "exact",
     "network": "eip155:8453",
     "select": "the accepts entry with extra.name=GatewayWalletBatched",
     "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
    }
   },
   "responses": {
    "402": {
     "description": "Payment Required — the base product's x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header (USDC on Base, Solana or Algorand). An input the site does not hold is a free 404, never a 402."
    },
    "200": {
     "description": "The same read GET /api/board/name?sym={symbol} sells, as a readable page: markdown by default, HTML with Accept: text/html, JSON with Accept: application/json. Served only after the payment settles. Settlement receipt in the PAYMENT-RESPONSE header.",
     "content": {
      "text/markdown": {
       "schema": {
        "type": "string"
       }
      },
      "text/html": {
       "schema": {
        "type": "string"
       }
      },
      "application/json": {
       "schema": {
        "type": "object"
       }
      }
     }
    }
   },
   "parameters": [
    {
     "name": "symbol",
     "in": "path",
     "required": true,
     "schema": {
      "type": "string"
     },
     "example": "NVDA",
     "description": "An upper-case ticker the free page /stocks/{symbol} serves (for example NVDA, BRK-B)."
    },
    {
     "name": "PAYMENT-SIGNATURE",
     "in": "header",
     "required": false,
     "schema": {
      "type": "string"
     },
     "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
    },
    {
     "name": "X-PAYMENT",
     "in": "header",
     "required": false,
     "schema": {
      "type": "string"
     },
     "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
    },
    {
     "name": "Authorization",
     "in": "header",
     "required": false,
     "schema": {
      "type": "string"
     },
     "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
    }
   ],
   "description": "A paid read for agents: the single-name read /api/board/name sells, for one symbol, at the same price, on the same rails, with the same data. The free page /stocks/{symbol} is open to everyone and unchanged; this page is noindex, nofollow and noarchive. A symbol the free page does not serve is a free 404.",
   "security": [
    {
     "x402": []
    },
    {
     "mpp": []
    }
   ]
  }
 },
 "/board/{date}/full": {
  "get": {
   "operationId": "getBoardDayFull",
   "summary": "Coil Point-in-Time Scores as a page ($0.05 per read) — the paid twin of /api/board/asof for one archived date",
   "tags": [
    "Paid reads"
   ],
   "x-payment-info": {
    "price": {
     "mode": "fixed",
     "currency": "USD",
     "amount": "0.050000"
    },
    "protocols": [
     {
      "x402": {}
     },
     {
      "mpp": {
       "method": "usdc",
       "intent": "charge",
       "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
      }
     }
    ],
    "description": "Buy point-in-time published scores for a date (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api Priced on the guarantee, not the bytes: $0.05 buys an as-published, sha256-committed, never-revised snapshot of a past day, verifiable against the free /api/board/proof commitment log. The same-day scores are cheaper on the live endpoints; you are paying for immutability and lookahead-bias-free history.",
    "offers": [
     {
      "intent": "charge",
      "method": "x402",
      "amount": "50000",
      "currency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "description": "Buy point-in-time published scores for a date (x402) — x402 'exact' charge, USDC on Base (eip155:8453). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
     },
     {
      "intent": "charge",
      "method": "x402",
      "amount": "50000",
      "currency": "31566704",
      "description": "Buy point-in-time published scores for a date (x402) — x402 'exact' charge, USDCa on Algorand mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
     },
     {
      "intent": "charge",
      "method": "x402",
      "amount": "50000",
      "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "description": "Buy point-in-time published scores for a date (x402) — x402 'exact' charge, USDC on Solana mainnet. Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
     },
     {
      "intent": "charge",
      "method": "x402",
      "amount": "50000",
      "currency": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "description": "x402 'exact' charge, USDC on Polygon (eip155:137). Amount in 6-decimal base units. Live offer document: GET https://coil.trade/api"
     }
    ],
    "mpp": {
     "method": "usdc",
     "intent": "charge",
     "challenge": "WWW-Authenticate: Payment",
     "credential": "Authorization: Payment",
     "network": "eip155:8453"
    },
    "nanopayments": {
     "rail": "circle-gateway",
     "scheme": "exact",
     "network": "eip155:8453",
     "select": "the accepts entry with extra.name=GatewayWalletBatched",
     "note": "Gasless batched USDC from a unified Circle Gateway balance — sign with @circle-fin/x402-batching (registerBatchScheme); settles offchain to the seller's Gateway balance."
    },
    "price_basis": "Priced on the guarantee, not the bytes: $0.05 buys an as-published, sha256-committed, never-revised snapshot of a past day, verifiable against the free /api/board/proof commitment log. The same-day scores are cheaper on the live endpoints; you are paying for immutability and lookahead-bias-free history."
   },
   "responses": {
    "402": {
     "description": "Payment Required — the base product's x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header (USDC on Base, Solana or Algorand). An input the site does not hold is a free 404, never a 402."
    },
    "200": {
     "description": "The same day GET /api/board/asof?date={date} sells, as a readable page: markdown by default, HTML with Accept: text/html, JSON with Accept: application/json. Served only after the payment settles. Settlement receipt in the PAYMENT-RESPONSE header.",
     "content": {
      "text/markdown": {
       "schema": {
        "type": "string"
       }
      },
      "text/html": {
       "schema": {
        "type": "string"
       }
      },
      "application/json": {
       "schema": {
        "type": "object"
       }
      }
     }
    }
   },
   "parameters": [
    {
     "name": "date",
     "in": "path",
     "required": true,
     "schema": {
      "type": "string",
      "format": "date"
     },
     "example": "2026-07-21",
     "description": "An archived publish date, YYYY-MM-DD, from the list GET /api/board/asof (free sample: /api/board/asof?sample=1)."
    },
    {
     "name": "PAYMENT-SIGNATURE",
     "in": "header",
     "required": false,
     "schema": {
      "type": "string"
     },
     "description": "x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge."
    },
    {
     "name": "X-PAYMENT",
     "in": "header",
     "required": false,
     "schema": {
      "type": "string"
     },
     "description": "x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients."
    },
    {
     "name": "Authorization",
     "in": "header",
     "required": false,
     "schema": {
      "type": "string"
     },
     "description": "MPP credential: `Payment <base64 credential>` answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge)."
    }
   ],
   "description": "A paid read for agents: the as-published scores /api/board/asof sells for one archived date, at the same price, on the same rails, with the same data. This page is noindex, nofollow and noarchive. A date that is not in the archive is a free 404.",
   "security": [
    {
     "x402": []
    },
    {
     "mpp": []
    }
   ]
  }
 }
 },
 "components": {
  "securitySchemes": {
   "licenseKey": {
    "type": "apiKey",
    "in": "header",
    "name": "X-License-Key",
    "description": "Gumroad license key for a Coil subscription. Coil Live ($49/mo or $419/yr) unlocks /api/live/*; the Coil Scanner key ($19/mo) unlocks the live board endpoints. Sent as a raw header value, no scheme prefix."
   },
   "siwx": {
    "type": "apiKey",
    "in": "header",
    "name": "X-Coil-Key",
    "description": "Wallet auth, two interoperable lanes. (1) STANDARD x402 SIWX extension (docs.x402.org/extensions/sign-in-with-x): every 402 declares extensions['sign-in-with-x'] with nonce/domain/uri and supportedChains (eip191 + ed25519); construct the CAIP-122/SIWE message, sign with the wallet, send base64 {message, signature, chainId, type} as the SIGN-IN-WITH-X header — the free-tier products serve directly, no mint step. (2) KEY-MINT convenience: GET /api/auth/nonce?address=&chain=base|solana|algorand, sign, POST /api/auth/verify to mint a durable coilwallet_ key sent as X-Coil-Key. Both grant the same free tier (25 calls/day on regime, indices, movers, crypto gate, crypto night, tradfi-risk, hold state). Signatures are messages, not transactions — no funds move."
   },
   "x402": {
    "type": "apiKey",
    "in": "header",
    "name": "X-PAYMENT",
    "description": "x402 pay-per-call. Call with no payment header to receive HTTP 402 carrying payment requirements (also base64 in PAYMENT-REQUIRED), pay on Base, Solana or Algorand in USDC, then repeat the request with the signed payload base64 in X-PAYMENT. No account, no API key, no signup. See https://coil.trade/agents"
   },
   "mpp": {
    "type": "http",
    "scheme": "Payment",
    "description": "Machine Payment Protocol. The 402 carries a `WWW-Authenticate: Payment` challenge (method=usdc); answer it on the standard Authorization header as `Authorization: Payment <base64url(JSON{challenge, payload})>` — NOT on a custom header. x402 is the alternative rail and uses X-PAYMENT instead."
   },
   "coilKey": {
    "type": "apiKey",
    "in": "header",
    "name": "X-Coil-Key",
    "description": "Free key (POST /api/key, instant, no card) or a SIWX wallet sign-in. Opens the cheap slices — regime, indices, movers, crypto gate, the overnight crypto read, tradfi-risk and hold state — for 25 calls/day per key without any payment. Endpoints listing coilKey alongside x402 are reachable EITHER way."
   }
  }
 }
}
