{"openapi":"3.1.0","info":{"title":"PRO-LO API","version":"3.1.0","description":"Real-time, real-data-only market intelligence for AI agents: a multi-path Coherence Gate (|Σ w·d| / Σ w across independent signal paths) with optional Jev (TypeSafe AI) review, plus live Squeeze, Options, Pre-Ignition and Momentum radars. Unconfigured data sources are reported as unavailable, never simulated.","contact":{"name":"Script Master Labs LLC","url":"https://scriptmasterlabs.com"}},"servers":[{"url":"https://pro-lo.onrender.com"}],"externalDocs":{"url":"https://pro-lo.onrender.com/llms-full.txt"},"x-x402-manifest":"https://pro-lo.onrender.com/.well-known/x402.json","x-mcp-manifest":"https://pro-lo.onrender.com/.well-known/mcp.json","paths":{"/api/health":{"get":{"operationId":"health","summary":"Service health and active data providers","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/setup-status":{"get":{"operationId":"setupStatus","summary":"Which data sources/features are configured (values never returned)","responses":{"200":{"description":"Checklist","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/market/tickers":{"get":{"operationId":"tickers","summary":"Live scanned ticker universe (cached from the background scan)","responses":{"200":{"description":"Tickers","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Live scan still warming up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/market/signal-paths/{symbol}":{"get":{"operationId":"signalPaths","summary":"Independent directional signal paths and coherence for a symbol","description":"coherence = |Σ wᵢ·dᵢ| / Σ wᵢ, d ∈ {+1 long, −1 short, 0 flat}, w = confidence ∈ [0,1]; gate passes when consensus ≠ flat and coherence ≥ threshold.","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Paths + coherence","content":{"application/json":{"schema":{"type":"object"}}}},"500":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"No live provider returned data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/market/coherence":{"post":{"operationId":"coherenceReview","summary":"Coherence Gate review with optional Jev (TypeSafe AI) review","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string"},"jev":{"type":"boolean","default":false}}}}}},"responses":{"200":{"description":"Verdict ACT_LONG | ACT_SHORT | HOLD | NO_DATA","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"ticker is required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"No live provider returned data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/market/squeeze-radar":{"get":{"operationId":"squeezeRadar","summary":"Squeeze Radar","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Warming up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/market/options-radar":{"get":{"operationId":"optionsRadar","summary":"Options Radar","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Warming up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/market/pre-ignition-radar":{"get":{"operationId":"preIgnitionRadar","summary":"Pre-Ignition Radar","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Warming up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/market/momentum":{"get":{"operationId":"momentum","summary":"Momentum / HOD ledger","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"503":{"description":"Warming up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/mcp/manifest":{"get":{"operationId":"mcpManifest","summary":"MCP tool manifest","responses":{"200":{"description":"Manifest","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/mcp.json":{"get":{"operationId":"mcpWellKnown","summary":"MCP discovery manifest","responses":{"200":{"description":"Manifest","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/.well-known/x402.json":{"get":{"operationId":"x402Manifest","summary":"x402 payment manifest (also served at /.well-known/x402)","responses":{"200":{"description":"Manifest","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/mcp/rpc":{"post":{"operationId":"mcpRpc","summary":"MCP JSON-RPC endpoint (10 tools: analyze_narrative_divergence, simulate_counterfactual_stress_test, classify_microstructure_regime, execute_gemini_frontier_reasoning, generate_trade_execution_signals, mandelbrot_fractal_analysis, track_volatility_surface, track_gamma_squeeze_mechanics, live_universe_scanner_scan, coherence_gate_review)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string"},"id":{},"method":{"type":"string"},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"JSON-RPC response","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/x402/trade-signals":{"post":{"operationId":"x402_trade_signals","summary":"Real BUY/SELL/HOLD signal plus real recommended option contracts (real strike/expiration/bid-ask/greeks) selected from a real fetched Tradier/Polygon chain. (0.08 RLUSD per call)","security":[{"x402Token":[]}],"x-x402":{"endpoint_uuid":"a7d09142-826d-4610-ace2-1008ddabfc91","cost_rlusd":0.08,"currency":"RLUSD","network":"XRPL","payment_authority":"https://four02proof.onrender.com","invoice_url":"https://four02proof.onrender.com/v1/invoice","invoice_method":"POST","invoice_body":{"endpoint_id":"a7d09142-826d-4610-ace2-1008ddabfc91"},"token_header":"X-Payment-Token","mcp_tool":"generate_trade_execution_signals","payment_verification_configured":true},"x-payment-info":{"protocol":"x402","price":{"amount":"0.08","currency":"RLUSD"},"network":"XRPL","endpoint_uuid":"a7d09142-826d-4610-ace2-1008ddabfc91"},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required — body.payment_required has invoice_url, cost and instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"503":{"description":"ERR_SECRET_NOT_CONFIGURED — payment verification not configured on this server","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"payment_token":{"type":"string","description":"Alternative to the X-Payment-Token header"}}}}}}}},"/api/x402/mm-obligations":{"post":{"operationId":"x402_mm_obligations","summary":"Real dealer GEX regime, real max-pain/call-wall/put-wall strikes, real FINRA short-volume and Reg SHO threshold status. (0.06 RLUSD per call)","security":[{"x402Token":[]}],"x-x402":{"endpoint_uuid":"eaa09b2c-567a-4dec-aecf-1361508cfe63","cost_rlusd":0.06,"currency":"RLUSD","network":"XRPL","payment_authority":"https://four02proof.onrender.com","invoice_url":"https://four02proof.onrender.com/v1/invoice","invoice_method":"POST","invoice_body":{"endpoint_id":"eaa09b2c-567a-4dec-aecf-1361508cfe63"},"token_header":"X-Payment-Token","mcp_tool":"classify_microstructure_regime","payment_verification_configured":true},"x-payment-info":{"protocol":"x402","price":{"amount":"0.06","currency":"RLUSD"},"network":"XRPL","endpoint_uuid":"eaa09b2c-567a-4dec-aecf-1361508cfe63"},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required — body.payment_required has invoice_url, cost and instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"503":{"description":"ERR_SECRET_NOT_CONFIGURED — payment verification not configured on this server","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"payment_token":{"type":"string","description":"Alternative to the X-Payment-Token header"}}}}}}}},"/api/x402/gamma-squeeze":{"post":{"operationId":"x402_gamma_squeeze","summary":"Real squeeze-pressure score from real chain-derived GEX and real FINRA short-sale volume. (0.05 RLUSD per call)","security":[{"x402Token":[]}],"x-x402":{"endpoint_uuid":"c30415cd-ac70-470d-916c-05384e2ade87","cost_rlusd":0.05,"currency":"RLUSD","network":"XRPL","payment_authority":"https://four02proof.onrender.com","invoice_url":"https://four02proof.onrender.com/v1/invoice","invoice_method":"POST","invoice_body":{"endpoint_id":"c30415cd-ac70-470d-916c-05384e2ade87"},"token_header":"X-Payment-Token","mcp_tool":"track_gamma_squeeze_mechanics","payment_verification_configured":true},"x-payment-info":{"protocol":"x402","price":{"amount":"0.05","currency":"RLUSD"},"network":"XRPL","endpoint_uuid":"c30415cd-ac70-470d-916c-05384e2ade87"},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required — body.payment_required has invoice_url, cost and instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"503":{"description":"ERR_SECRET_NOT_CONFIGURED — payment verification not configured on this server","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"payment_token":{"type":"string","description":"Alternative to the X-Payment-Token header"}}}}}}}},"/api/x402/surface-report":{"post":{"operationId":"x402_surface_report","summary":"Real implied-volatility surface grid built from a real fetched options chain across multiple real expirations. (0.05 RLUSD per call)","security":[{"x402Token":[]}],"x-x402":{"endpoint_uuid":"318162d9-ba8b-4d03-8abc-7dd78ba858da","cost_rlusd":0.05,"currency":"RLUSD","network":"XRPL","payment_authority":"https://four02proof.onrender.com","invoice_url":"https://four02proof.onrender.com/v1/invoice","invoice_method":"POST","invoice_body":{"endpoint_id":"318162d9-ba8b-4d03-8abc-7dd78ba858da"},"token_header":"X-Payment-Token","mcp_tool":"track_volatility_surface","payment_verification_configured":true},"x-payment-info":{"protocol":"x402","price":{"amount":"0.05","currency":"RLUSD"},"network":"XRPL","endpoint_uuid":"318162d9-ba8b-4d03-8abc-7dd78ba858da"},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required — body.payment_required has invoice_url, cost and instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"503":{"description":"ERR_SECRET_NOT_CONFIGURED — payment verification not configured on this server","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"payment_token":{"type":"string","description":"Alternative to the X-Payment-Token header"}}}}}}}},"/api/x402/mandelbrot-fractal":{"post":{"operationId":"x402_mandelbrot_fractal","summary":"Real Rescaled-Range Hurst exponent per real timeframe (15M/1H/4H/1D/1W) from real historical bars. (0.04 RLUSD per call)","security":[{"x402Token":[]}],"x-x402":{"endpoint_uuid":"9814b1fc-efb9-4e8b-966c-4979cd49e576","cost_rlusd":0.04,"currency":"RLUSD","network":"XRPL","payment_authority":"https://four02proof.onrender.com","invoice_url":"https://four02proof.onrender.com/v1/invoice","invoice_method":"POST","invoice_body":{"endpoint_id":"9814b1fc-efb9-4e8b-966c-4979cd49e576"},"token_header":"X-Payment-Token","mcp_tool":"mandelbrot_fractal_analysis","payment_verification_configured":true},"x-payment-info":{"protocol":"x402","price":{"amount":"0.04","currency":"RLUSD"},"network":"XRPL","endpoint_uuid":"9814b1fc-efb9-4e8b-966c-4979cd49e576"},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required — body.payment_required has invoice_url, cost and instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"503":{"description":"ERR_SECRET_NOT_CONFIGURED — payment verification not configured on this server","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"payment_token":{"type":"string","description":"Alternative to the X-Payment-Token header"}}}}}}}},"/api/x402/universe-scan":{"get":{"operationId":"x402_universe_scan","summary":"Real wide-market scan (Polygon grouped-daily across the real US equity universe, no pinned symbols) fused with real per-symbol GEX/squeeze scoring. (0.1 RLUSD per call)","security":[{"x402Token":[]}],"x-x402":{"endpoint_uuid":"33bcbe49-9a7b-43a6-a3bb-b439f62f6a5e","cost_rlusd":0.1,"currency":"RLUSD","network":"XRPL","payment_authority":"https://four02proof.onrender.com","invoice_url":"https://four02proof.onrender.com/v1/invoice","invoice_method":"POST","invoice_body":{"endpoint_id":"33bcbe49-9a7b-43a6-a3bb-b439f62f6a5e"},"token_header":"X-Payment-Token","mcp_tool":"live_universe_scanner_scan","payment_verification_configured":true},"x-payment-info":{"protocol":"x402","price":{"amount":"0.1","currency":"RLUSD"},"network":"XRPL","endpoint_uuid":"33bcbe49-9a7b-43a6-a3bb-b439f62f6a5e"},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required — body.payment_required has invoice_url, cost and instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"503":{"description":"ERR_SECRET_NOT_CONFIGURED — payment verification not configured on this server","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/x402/gemini-reasoning":{"post":{"operationId":"x402_gemini_reasoning","summary":"Google Gemini reasoning grounded only in real, live-fetched market data for the requested ticker. (0.07 RLUSD per call)","security":[{"x402Token":[]}],"x-x402":{"endpoint_uuid":"798ad1c4-09d9-4eab-a520-61c63484b107","cost_rlusd":0.07,"currency":"RLUSD","network":"XRPL","payment_authority":"https://four02proof.onrender.com","invoice_url":"https://four02proof.onrender.com/v1/invoice","invoice_method":"POST","invoice_body":{"endpoint_id":"798ad1c4-09d9-4eab-a520-61c63484b107"},"token_header":"X-Payment-Token","mcp_tool":"execute_gemini_frontier_reasoning","payment_verification_configured":true},"x-payment-info":{"protocol":"x402","price":{"amount":"0.07","currency":"RLUSD"},"network":"XRPL","endpoint_uuid":"798ad1c4-09d9-4eab-a520-61c63484b107"},"responses":{"200":{"description":"Paid result","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment required — body.payment_required has invoice_url, cost and instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"503":{"description":"ERR_SECRET_NOT_CONFIGURED — payment verification not configured on this server","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"ticker":{"type":"string"},"payment_token":{"type":"string","description":"Alternative to the X-Payment-Token header"}}}}}}}}},"components":{"securitySchemes":{"x402Token":{"type":"apiKey","in":"header","name":"X-Payment-Token","description":"Signed token issued by https://four02proof.onrender.com after paying an RLUSD invoice on XRPL."}},"schemas":{"Error":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"},"message":{"type":"string"}}},"PaymentRequired":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"},"payment_required":{"type":"object","properties":{"endpoint_uuid":{"type":"string"},"cost_rlusd":{"type":"number"},"currency":{"type":"string"},"network":{"type":"string"},"invoice_url":{"type":"string"},"verify_url":{"type":"string"},"instructions":{"type":"string"}}}}}}}}