{
  "schema_version": "v1",
  "name": "SignalPulse",
  "description": "Cross-asset trading intelligence engine. Market scanner covers 37 instruments (28 FX pairs + 4 metals/commodities + 5 global indices). FX-only scanner for 28 pairs. Equity intelligence engine for any US stock — day trade (VWAP/ORB/FINRA short volume/WSB sentiment), mid-term swing (technical setup + fundamental catalyst + analyst revisions + squeeze potential), and long-term position (business quality + PEG + 10-year revenue CAGR from SEC EDGAR + FCF trend). Equity screener finds the best stock to buy right now. Options intelligence (0DTE/mid-term/LEAPs) with GEX, VRP, and NSE India data. Sports picks for 35+ sports. Polymarket prediction market scanner. Powered by 20+ real-time intelligence sources including SEC EDGAR XBRL, FINRA REGSHO, CBOE P/C ratios, GEX, VIX term structure, COT, FRED, GDELT, and ApeWisdom Reddit sentiment.",
  "url": "https://signalpulse-peach.vercel.app",
  "api": {
    "type": "openapi",
    "url": "https://signalpulse-peach.vercel.app/openapi.json"
  },
  "payment": {
    "protocol": "x402",
    "network": "eip155:8453",
    "asset": "USDC",
    "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc",
    "price_range_usd": "1.99–2.49"
  },
  "capabilities": [
    "market-scanner",
    "forex-scanner",
    "cross-asset",
    "trading-signals",
    "technical-analysis",
    "macro-fundamentals",
    "institutional-positioning",
    "news-sentiment",
    "sports-picks",
    "weather-analysis",
    "prediction-markets",
    "polymarket-scanner",
    "probability-estimation",
    "forex",
    "equities",
    "crypto",
    "commodities",
    "indices",
    "metals",
    "gamma-exposure",
    "vix-term-structure",
    "real-yields",
    "seasonality"
  ],
  "use_cases": [
    "Scan all 37 instruments (FX + metals + indices) and find the single best trade right now",
    "Scan all 28 forex pairs and return the highest-probability currency trade",
    "Get a scalp signal — what is the best trade to make right now with a tight stop?",
    "Get an intraday signal — best opportunity to exit before end of session today",
    "Get a longterm position idea — where does multi-week macro and COT data align?",
    "Generate a BUY/SELL/NEUTRAL signal for EURUSD on the daily timeframe",
    "Signal for Gold (XAUUSD) with real yield, COT, seasonality, and LBMA timing context",
    "S&P 500 trade — check VIX term structure, gamma exposure, and put/call sentiment",
    "NFL pick for Bills vs Chiefs with weather impact analysis",
    "Scan Polymarket economics markets for value — find Fed rate decision mispricing",
    "What is the best US stock to buy right now for a day trade?",
    "What is the best equity for a 4-6 week swing trade with a fundamental catalyst?",
    "Give me a long-term signal for NVDA — is it a quality business at a reasonable price?",
    "What is the best stock to buy for a long-term position (6-24 months)?",
    "Is AAPL above VWAP today? What is the opening range breakout status?"
  ],
  "data_sources": [
    "Yahoo Finance / Twelve Data — real-time OHLCV for all 37 instruments",
    "CFTC COT Legacy + TFF Report — FX, gold, crude, E-mini S&P/Nasdaq positioning",
    "FRED — TIPS real yield (DFII10), VIX (VIXCLS), VIX3M (VXMTCLS), GDPNow, macro dashboard",
    "EIA — weekly petroleum inventory (crude, gasoline, distillate)",
    "FlashAlpha — gamma exposure (GEX) and gamma flip levels for SPX and NDX",
    "CBOE — equity put/call ratio (^CPCE contrarian sentiment)",
    "MOVE Index — Treasury bond volatility (ICE BofA, via Yahoo Finance)",
    "LBMA Fix Timing — AM/PM gold benchmark windows (pure datetime logic)",
    "Gold Seasonality — Baur 2013 autumn effect statistical bias",
    "GDELT — global news sentiment (15-min delay)",
    "Polymarket Gamma API — macro event probabilities",
    "Central bank policy rates — carry differential matrix",
    "10Y yield spreads — FRED cross-country differential analysis",
    "SOFR + Fed swap lines — USD funding stress monitor",
    "The Odds API — consensus bookmaker odds (sports)",
    "ESPN — injury reports and team news",
    "Open-Meteo — venue weather",
    "SEC EDGAR XBRL — 10-20 years of US company financial history (revenue CAGR, EPS trend, FCF)",
    "FINRA REGSHO — daily short sale volume (squeeze fuel vs distribution signal)",
    "ApeWisdom — real-time Reddit/WallStreetBets mention rank and sentiment trend",
    "Tavily — real-time web search context"
  ],
  "endpoints": [
    {
      "path": "/api/instruments",
      "method": "GET",
      "description": "Free discovery endpoint. Lists all supported instruments, sports, prediction market categories, and full endpoint documentation. Call this first.",
      "price_usd": 0,
      "payment_required": false
    },
    {
      "path": "/api/scan/market",
      "method": "GET",
      "description": "Cross-asset market scanner. Screens all 37 instruments (28 FX pairs + Gold, Silver, WTI Crude, Copper + S&P 500, Nasdaq-100, DAX, FTSE 100, Nikkei 225). Applies asset-class-specific intelligence: TIPS real yield + LBMA timing + seasonality for metals; VIX term structure + GEX + put/call sentiment + GDPNow for indices; ICT structure + carry + COT for FX. Returns the single best opportunity across all markets.",
      "parameters": [
        {"name": "style", "required": false, "values": ["scalp", "intraday", "longterm"], "default": "intraday", "description": "scalp: tight targets, 1H chart. intraday: exit before NY close, 4H chart. longterm: full intelligence briefing, daily chart."}
      ],
      "price_usd": 2.49,
      "payment_required": true
    },
    {
      "path": "/api/scan/forex",
      "method": "GET",
      "description": "FX-only scanner. Screens all 28 major and minor currency pairs. Returns single best opportunity with full ICT structure (FVG, Order Block, VWAP), COT institutional positioning, FRED macro, GDELT sentiment, carry differential, and yield spread analysis.",
      "parameters": [
        {"name": "style", "required": false, "values": ["scalp", "intraday", "longterm"], "default": "intraday"}
      ],
      "price_usd": 1.99,
      "payment_required": true
    },
    {
      "path": "/api/signal/generate",
      "method": "GET",
      "description": "On-demand signal for a specific instrument — forex, equity, crypto, commodity, or index. Full technical analysis + COT + FRED + GDELT synthesis.",
      "parameters": [
        {"name": "instrument", "required": true},
        {"name": "timeframe", "required": true},
        {"name": "risk_points", "required": false},
        {"name": "reward_ratio", "required": false}
      ],
      "price_usd": 1.99,
      "payment_required": true
    },
    {
      "path": "/api/signal/sports",
      "method": "GET",
      "description": "Sports pick for 35+ sports worldwide — consensus odds + venue weather + ESPN injuries + GDELT sentiment. 3 ranked picks returned.",
      "parameters": [
        {"name": "sport", "required": true},
        {"name": "event", "required": false},
        {"name": "market", "required": false}
      ],
      "price_usd": 1.99,
      "payment_required": true
    },
    {
      "path": "/api/signal/polymarket",
      "method": "GET",
      "description": "Polymarket prediction market scanner — finds value opportunities where data-driven probability differs from market price by >10%.",
      "parameters": [
        {"name": "category", "required": true, "values": ["crypto","economics","geopolitics","politics"]}
      ],
      "price_usd": 1.99,
      "payment_required": true
    },
    {
      "path": "/api/signal/futures",
      "method": "GET",
      "description": "Institutional futures signal using CFTC COT positioning data. Identifies extreme Managed Money / Leveraged Fund crowding — mean-reversion setups in grains (corn/wheat/soybeans), financial futures (E-Mini S&P 500/Nasdaq/T-Bonds), and SOFR rate path. Returns 3 ranked picks with COT edge, entry/stop notes, and hold period.",
      "parameters": [
        {"name": "market", "required": false, "values": ["grains","financial","rates","all"], "default": "all"}
      ],
      "price_usd": 2.49,
      "payment_required": true
    },
    {
      "path": "/api/signal/options",
      "method": "GET",
      "description": "Options intelligence signal for any equity ticker. Three timeframe tiers: 0DTE (same-day expiry — GEX regime primary, max pain gravity, VIX1D spike check), mid_term (VRP systematic edge, unusual options activity, CBOE P/C ratios, NSE India NIFTY cross-signal), LEAPs (VIX1Y/VIX ratio, DITM call strategy, January expiry targeting). Synthesises GEX computed from Black-Scholes applied to Yahoo Finance chains (no premium data required), VIX term structure (VIX1D/VIX9D/VIX/VIX3M/VIX6M/VIX1Y/VVIX/SKEW), and NSE India option chain.",
      "parameters": [
        {"name": "ticker", "required": true, "description": "Equity ticker (e.g. AAPL, SPY, QQQ)"},
        {"name": "signal_type", "required": false, "values": ["0dte","mid_term","leaps"], "default": "mid_term", "description": "0dte=same-day expiry; mid_term=weeks to months; leaps=1+ year expiry"}
      ],
      "price_usd": 2.49,
      "payment_required": true
    },
    {
      "path": "/api/signal/equities",
      "method": "GET",
      "description": "Equity trading signal for any US stock — LONG signals only (no shorting). Three tiers: day_trade (VWAP position #1 signal, Opening Range Breakout, 5-min momentum, FINRA daily short volume, ApeWisdom WSB sentiment for squeeze detection), mid_term (RSI/MA alignment, fundamental catalyst, analyst revision trend, earnings setup, squeeze potential, Reddit sentiment), long_term (business quality — gross margins/ROE/FCF, 5-year revenue CAGR from SEC EDGAR XBRL, PEG ratio, earnings acceleration, balance sheet health). Returns LONG or WAIT with specific entry, stop, target, and hold period.",
      "parameters": [
        {"name": "ticker", "required": true, "description": "US equity ticker (e.g. AAPL, NVDA, MSFT, SPY)"},
        {"name": "signal_type", "required": false, "values": ["day_trade","mid_term","long_term"], "default": "mid_term", "description": "day_trade=same day close by 3:45pm ET; mid_term=2-8 weeks; long_term=6-24 months"}
      ],
      "price_usd": 2.49,
      "payment_required": true
    },
    {
      "path": "/api/signal/screener",
      "method": "GET",
      "description": "Equity screener — scans a curated universe of stocks and returns the best long opportunity for a given timeframe. Day trade screener identifies the highest-momentum stock above VWAP with an active breakout. Mid-term screener finds the best RSI oversold bounce + upcoming catalyst setup. Long-term screener identifies quality businesses at the most compelling valuations. Returns top 1-3 ranked candidates.",
      "parameters": [
        {"name": "signal_type", "required": false, "values": ["day_trade","mid_term","long_term"], "default": "mid_term"}
      ],
      "price_usd": 2.49,
      "payment_required": true
    }
  ],
  "openapi": "https://signalpulse-peach.vercel.app/openapi.json",
  "llms_txt": "https://signalpulse-peach.vercel.app/llms.txt",
  "contact": "info@theaslangroupllc.com",
  "provider": "The Aslan Group LLC"
}
