# SignalPulse

> Two-product market intelligence engine. **Market Analysis** — ask any question about any market and receive a comprehensive report. **Trade Signals** — scan a market and receive the single highest-probability trade call with full rationale. Credits are isolated between products. Analysis credits: $1.49–$7.99/pack. Signal credits: $2.49–$16.99/pack. x402 USDC micropayments accepted on all endpoints.

SignalPulse applies 15+ real-time intelligence layers across FX, metals, equity indices, equities, futures, options, crypto, sports, racing, and prediction markets. The trade signal engine screens instruments simultaneously and picks one winner with entry, stop, and target. The analysis engine routes natural-language questions to dedicated fetchers and synthesises a full market report.

## Endpoints

GET /api/instruments — free discovery, lists all instruments and endpoints
POST /api/analysis — market analysis/commentary for any question (analysis credit, x402)
GET /api/scan/market — cross-asset market scanner, 37 instruments (signal credit, x402)
GET /api/scan/forex — FX-only scanner, 28 pairs (signal credit, x402)
GET /api/signal/generate — on-demand signal for any instrument (signal credit, x402)
GET /api/signal/equities — equities-specific signal with signal type (signal credit, x402)
GET /api/signal/basket — thematic-basket / sector-ETF signal: breadth, dispersion, rotation (signal credit, x402)
GET /api/signal/futures — futures scanner by category (signal credit, x402)
GET /api/signal/options — options signal with strategy selector (signal credit, x402)
GET /api/signal/sports — sports pick for 35+ sports worldwide (signal credit, x402)
GET /api/signal/racing — horse or greyhound racing pick (signal credit, x402)
GET /api/signal/polymarket — Polymarket prediction market scanner (signal credit, x402)

## Market Analysis (/api/analysis)

POST with JSON body `{"question": "..."}` and `X-API-KEY` header (analysis credit) or x402 payment.

Ask any natural-language question about any instrument, market, sport, race, or prediction market. The engine detects the topic from the question and routes to the appropriate data fetchers before synthesising a comprehensive report.

Supported topics (auto-detected):
- forex / metals / oil / indices — `What's the outlook for EUR/USD?`
- crypto — `Best crypto opportunities this week?`
- equities — `Is NVDA overvalued right now?`
- futures — `Crude oil supply picture and direction?`
- options — `Best options strategy on SPY this week?`
- sports — `Who should I back in the next UFC main event?`
- racing — `Best value bets in today's horse racing?`
- prediction_markets — `Which Polymarket contracts are mispriced?`
- macro (broad queries) — `Give me a full rundown of financial markets`

Returns: `{analysis: "...", _meta: {topic, credits_remaining, generated_at}}`

## Market Scanner (/api/scan/market)

Screens all 37 instruments and returns the single best opportunity.
style: scalp | intraday | longterm (default: intraday)

Instrument universe:
- 28 FX pairs: EURUSD, GBPUSD, USDJPY, AUDUSD, USDCAD, USDCHF, NZDUSD, EURGBP, EURJPY, GBPJPY, and all major/minor crosses
- 4 Metals/Commodities: Gold (XAU/USD), Silver (XAG/USD), WTI Crude, Copper
- 5 Equity Indices: S&P 500 (SPX), Nasdaq-100 (NDX), DAX 40, FTSE 100, Nikkei 225

Intelligence layers active per asset class:
- FX: ICT structure (Fair Value Gaps, Order Blocks, VWAP), session timing, COT speculator positioning, carry differential, 10Y yield spread, GDELT sentiment
- Metals: TIPS 10Y real yield, LBMA AM/PM fix timing, Baur gold seasonality, MOVE bond volatility index, CFTC COT (gold + crude), EIA weekly inventory (crude)
- Indices: VIX/VIX3M term structure ratio, CBOE equity put/call ratio, GDPNow (Atlanta Fed), gamma exposure (GEX via FlashAlpha), CFTC TFF E-mini positioning

## FX Scanner (/api/scan/forex)

FX-only scanner for 28 currency pairs.
style: scalp | intraday | longterm (default: intraday)

## Signal Generation (/api/signal/generate)

On-demand signal for any instrument.
instrument: required — EURUSD, AAPL, BTC-USD, GOLD, GC=F, CL=F, ^GSPC, etc.
timeframe: required — 1h | 4h | 1d | 3d | 1w | 1m | 3m
risk_points: optional — points at risk (default: 1.5x ATR)
reward_ratio: optional — risk:reward multiplier (default: 1.0)

## Sports (/api/signal/sports)

sport: required — nfl, nba, mlb, nhl, epl, ucl, laliga, seriea, bundesliga, ligue1, afl, nrl, ufc, boxing, tennis, golf, mls, cricket, greyhound, esports
event: optional — team name or slug
market: optional — h2h | spreads | totals

## Polymarket (/api/signal/polymarket)

category: required — crypto | economics | geopolitics | politics

## Supported Instruments

Forex: All 28 major and minor pairs including USD, EUR, GBP, JPY, AUD, CAD, CHF, NZD crosses
Commodities: GOLD (XAUUSD), SILVER, OIL (CL=F), BRENT, NATGAS, WHEAT, CORN, COPPER
Crypto: BTC-USD, ETH-USD, SOL-USD, ADA-USD, DOGE-USD, XRP-USD
Indices: SPX, NDX, DJI, FTSE, DAX, NIKKEI, HSI
Equities: Any ticker — AAPL, TSLA, NVDA, MSFT, AMZN, META, GOOGL, etc.

## Intelligence Data Sources

Price Data:
- Yahoo Finance (primary) — real-time OHLCV, 15-min delay for all instruments
- Twelve Data (fallback) — higher-volume coverage

FX Intelligence:
- CFTC COT Legacy report — non-commercial net positioning for 7 currency futures
- Central bank policy rates — carry differential matrix (8 central banks)
- 10Y yield spreads — FRED cross-country yield differential analysis
- ICT/SMC structure — Fair Value Gaps, Order Blocks, VWAP (pure OHLCV math)

Metals Intelligence:
- FRED DFII10 — 10-Year TIPS real yield (gold's primary macro driver)
- FRED GOLDAMGBD228NLBM — LBMA gold AM fix (daily)
- LBMA fix timing — AM (10:30 London) and PM (15:00 London) benchmark windows
- Baur 2013 seasonality — autumn effect (September/November positive bias)
- MOVE Index via Yahoo Finance ^MOVE — Treasury bond volatility
- CFTC COT — gold and WTI crude speculator positioning
- EIA weekly petroleum report — crude, gasoline, distillate inventory changes

Indices Intelligence:
- FRED VIXCLS + VXMTCLS — VIX/VIX3M term structure ratio (contango vs backwardation)
- Yahoo ^CPCE — CBOE equity put/call ratio (contrarian sentiment indicator)
- FRED GDPNOW — Atlanta Fed real-time GDP nowcast
- FlashAlpha GEX API — gamma exposure and gamma flip levels for SPX and NDX
- CFTC TFF report — E-mini S&P and Nasdaq leveraged fund and asset manager positioning

Macro / Global:
- FRED — Fed funds rate, SOFR, 2Y/10Y yields, breakeven inflation, VIX, swap lines, capital flows
- GDELT — global news sentiment (250+ countries, 65+ languages, 15-min update)
- Polymarket Gamma API — live macro event probabilities
- WMR/LSEG 4pm London Fix timing — institutional FX flow window detection
- USD funding stress — Fed FX swap lines monitoring

Sports:
- The Odds API — consensus odds from US/UK/AU bookmakers
- ESPN — injury reports and team news
- Open-Meteo — venue weather with historical impact analysis
- Tavily — real-time web search context

## Payment

x402 protocol. USDC on Base mainnet.
Analysis credits: $1.49 per call (or buy packs: 1=$1.49, 3=$3.49, 5=$4.99, 10=$7.99)
Signal credits: $2.49 per call (or buy packs: 1=$2.49, 3=$6.49, 5=$9.99, 10=$16.99)
Credit types are isolated — analysis credits cannot redeem signals and vice versa.
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Agent Discovery

OpenAPI: https://signalpulse-peach.vercel.app/openapi.json
Agent: https://signalpulse-peach.vercel.app/.well-known/agent.json

## Contact

info@theaslangroupllc.com | The Aslan Group LLC