{
 "openapi": "3.1.0",
 "info": {
  "title": "Luminus Signals",
  "version": "1.0.0",
  "contact": {
   "name": "Luminus Signals",
   "email": "lum1@mail.grokbot.com"
  },
  "description": "Paper-trading signals from automated agents (crash short, big short, 4h swing, 0-DTE). Sold per request over x402 in USDC. General information; same for every caller; not financial advice.",
  "x-guidance": "Call GET /track-record and GET /signals/delayed for free. GET /signals/latest returns the current paper signals for $0.10 USDC (x402 exact, eip155:8453); the first request returns 402 with a PAYMENT-REQUIRED header; sign an EIP-3009 USDC authorization and retry with a PAYMENT-SIGNATURE header. All data is PAPER/SIMULATED, not financial advice, no personalised advice."
 },
 "servers": [
  {
   "url": "https://luminus-signals.luminus-signals.workers.dev"
  }
 ],
 "paths": {
  "/signals/latest": {
   "get": {
    "operationId": "signals_latest",
    "summary": "Current paper-trading signals",
    "tags": [
     "Signals"
    ],
    "x-payment-info": {
     "price": {
      "mode": "fixed",
      "currency": "USD",
      "amount": "0.100000"
     },
     "protocols": [
      {
       "x402": {}
      }
     ]
    },
    "responses": {
     "200": {
      "description": "Current signals",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "paid": {
           "type": "object"
          },
          "updated_at": {
           "type": "string",
           "description": "when the box last pushed this data (ISO UTC)"
          },
          "generated": {
           "type": "string"
          },
          "count": {
           "type": "integer"
          },
          "items": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "type": {
              "type": "string",
              "enum": [
               "open_position",
               "closed_position",
               "daily_result"
              ]
             },
             "agent": {
              "type": "string"
             },
             "coin": {
              "type": "string"
             },
             "side": {
              "type": "string"
             },
             "entry": {
              "type": "number"
             },
             "stop": {
              "type": "number"
             },
             "text": {
              "type": "string"
             }
            }
           }
          },
          "disclaimer": {
           "type": "object"
          }
         },
         "required": [
          "items",
          "disclaimer"
         ]
        },
        "example": {
         "paid": {
          "tx": "0x...",
          "network": "eip155:8453",
          "payer": "0x...",
          "amount_atomic_usdc": "100000"
         },
         "updated_at": "2026-11-19T08:00:00Z",
         "generated": "2026-11-19 09:00 CET",
         "count": 1,
         "items": [
          {
           "type": "open_position",
           "agent": "bigshort",
           "name": "Big short",
           "coin": "BTC",
           "side": "SHORT",
           "entry": 63000,
           "stop": 66000,
           "stop_text": "...",
           "target_text": "...",
           "size_pct_of_paper_book": 150,
           "venue": "Hyperliquid perps (paper)",
           "opened_epoch": 1795000000,
           "text": "[PAPER] NEW POSITION ..."
          }
         ],
         "disclaimer": {
          "tag": "PAPER TRADING / SIMULATED - NOT FINANCIAL ADVICE"
         }
        }
       }
      }
     },
     "402": {
      "description": "Payment Required"
     }
    }
   }
  },
  "/signals/delayed": {
   "get": {
    "operationId": "Delayed_signals",
    "summary": "Delayed signals",
    "description": "Signals at least 24h old. Free.",
    "security": [],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/track-record": {
   "get": {
    "operationId": "Paper_track_record",
    "summary": "Paper track record",
    "description": "Paper track record per agent. Free.",
    "security": [],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/mcp": {
   "post": {
    "operationId": "mcp",
    "summary": "Remote MCP server (Streamable HTTP)",
    "description": "JSON-RPC 2.0 over POST. Free tools (service info, health, track record, delayed signals) and an explanation of how to pay for /signals/latest via x402. Stateless, no auth, no keys.",
    "security": [],
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object"
       }
      }
     }
    },
    "responses": {
     "200": {
      "description": "JSON-RPC response",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "202": {
      "description": "Accepted (notification)"
     }
    }
   }
  },
  "/": {
   "get": {
    "operationId": "Service_info",
    "summary": "Service info",
    "description": "Landing info and disclaimer. Free.",
    "security": [],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  }
 },
 "x-discovery": {
  "ownershipProofs": [
   "0xf27c1decf30539c9711406556d78490d344b6f82d25965881c02f04ab612979a6861481510d2b619c18894d0bb93530df6ca2c2fcf6db6aade9d31877020f8c61c"
  ]
 }
}