# News Gurus Intel API — API Documentation Pay-per-call trading intelligence for AI agents over x402 (HTTP 402 + USDC on Base, no account or API key). See /skill.md for the agent contract and /x402/catalog for the live machine-readable menu. - Base URL: `https://api.newsgurus.ai` - Network: Base mainnet (eip155:8453) · Asset: USDC · Auth: x402 per call - Free probe: `GET https://api.newsgurus.ai/x402/catalog` ## Endpoints | Method | Path | Price (USDC) | Description | | ------ | ---- | ------------ | ----------- | | GET | `/x402/regime` | $0.002 | live crypto & equity market regime classification (TRENDING / MEAN_REVERTING / VOL_EXPANSION) with confidence, VIX and ADX context, from a 40-source trading intelligence bot | | GET | `/x402/brain/recent` | $0.005 | most recent cross-agent market intelligence ideas (institutional flow, options flow, on-chain, news catalysts) from a 40-source SharedBrain | | GET | `/x402/brain/anomalies` | $0.01 | recent ANOMALY detections: pump/psyop mention spikes with no institutional confirmation, token rug precursors, coordinated wallet activity, data-integrity divergences | | GET | `/x402/signals/composite/{symbol}` | $0.05 | composite signal read for one symbol: latest 50 signals across all generators merged into bullish/bearish counts and average confidence | | GET | `/x402/signals/{symbol}` | $0.01 | recent trading signals for one symbol (options flow, dark pool, technical, sentiment, congressional and more), with direction, strength, confidence and source agent | | GET | `/x402/mlb/props-sheet` | $5 | the FULL daily MLB props sheet: News Guru's derived HR & hits+runs+RBIs picks, batter-vs-pitcher matchups, SP strikeout plays, F5 plays, per-game model predictions and per-game props | | GET | `/x402/mlb/picks` | $3 | condensed daily MLB picks: top-10 HR picks, top-10 hits+runs+RBIs picks, top SP strikeout plays, best matchups, F5 plays and slate risk flags | | GET | `/x402/options/flow` | $0.05 | recent unusual options-flow signals: sweep clusters and large-premium prints across the active equity universe, with direction, strength, confidence and a derived size_bucket (block/large/mid/small) | | GET | `/x402/options/gex/{symbol}` | $0.1 | dealer-regime classification for one equity/ETF symbol: regime label (e.g | | GET | `/x402/darkpool/recent` | $0.05 | recent institutional dark-pool prints: symbol, direction, strength, confidence and a derived size_bucket (block/large/mid/small) for significant institutional-scale blocks | | GET | `/x402/congress/trades` | $0.05 | recent US congressional stock transactions: member, party, state, buy/sell, ticker, amount range, transaction and disclosure dates | | GET | `/x402/futures/{symbol}` | $0.05 | crypto futures/derivatives read for one symbol (BTC, ETH, SOL, XRP...): latest APEX multi-source confluence signals (direction, score, momentum surge, timeframe) plus the current market regime | | GET | `/x402/memecoin/verify/{mint}` | $0.01 | token authenticity verdict for one Solana mint: 0-1 realness score, confidence, recommended action (PASS / SMALL_SNIPER / MONITOR / REJECT), rug-risk flags, psyop/pump detection and narrative tags, from a 6-probe on-chain+social verifier with creator rug-history | | GET | `/x402/memecoin/movers` | $0.02 | liquidity- and volume-gated memecoin movers for one chain (?chain= solana|base|bsc|ethereum): top gainers, losers and volume leaders with price, liquidity and 24h stats — wash-trade noise filtered out | | GET | `/x402/stocks/rankings` | $0.25 | full quality-compounder rankings (high-margin / low-debt / high-cash / growing-revenue US equities + revenue-generating crypto protocols, percentile-scored) PLUS growth-stock LEAPS candidates, in one call | | GET | `/x402/prediction/markets` | $0.1 | full Polymarket market landscape (up to 2000 markets): category-grouped odds, liquidity, volume and direction from the bot's Polymarket intelligence agents | | GET | `/x402/prediction/whales` | $0.1 | Polymarket flagged-wallet groupings + coordinated-betting cabal intel from the bot's on-chain wallet tracker: address, buy/sell volume, counts, markets touched, plus any known cabal cluster ideas | | GET | `/x402/prediction/whale-leaders` | $0.1 | Polymarket smart-money leaderboard: whale wallets ranked by informed score, win rate, realized PnL or volume, with specialization and average entry odds | | GET | `/x402/prediction/new-wallets` | $0.05 | first-time Polymarket bettor fills: fresh wallets taking positions, with fill size, side, outcome price and the wallet's rolling totals | | GET | `/x402/prediction/market-stats/{condition_id}` | $0.05 | aggregate wallet intelligence for one Polymarket market (by condition_id): unique wallets, buy/sell volume split, new-wallet count and volume share, and the top-10 buyers | | GET | `/x402/sentiment/{symbol}` | $0.02 | per-symbol social sentiment: recent sentiment/retail signals (bullish vs bearish counts + net bias) merged with social-intelligence ideas (LunarCrush, StockTwits, Telegram, X) for one ticker | | GET | `/x402/macro/snapshot` | $0.02 | macro one-call read: current market regime plus the latest Fed-speech, BIS, prediction-market and geopolitical intelligence entries from the macro agents | | GET | `/x402/btc/snapshot` | $0.05 | BTC one-call read: dormant/Satoshi-era wallet movement state, the five most recent dormant-wallet moves (BTC, USD value, years dormant), latest APEX BTC confluence signals and the market regime | | GET | `/x402/institutions/recent` | $0.05 | recent institutional 13F position moves across tracked funds: new / increased / decreased / sold positions with shares, value, portfolio weight and filing date | | GET | `/x402/institutions/{symbol}` | $0.1 | per-stock institutional composite for one ticker: STOCK Act congressional trades (public government disclosures) + 13F institution-holding moves (new/increased/decreased/sold from public SEC filings) | | GET | `/x402/brain/decisions` | $0.1 | full LLM trade-reasoning chain: every routing decision with thesis, signal attribution, kelly_fraction, gate result and exit detail | | GET | `/x402/brain/kelly` | $0.05 | Kelly-criterion outcome ledger: per-trade signal_type, pnl, r_multiple, kelly_fraction, narrative_score and llm_provider — the strategy's live performance history | | GET | `/x402/apex/signals` | $0.05 | APEX v10.2 multi-source confluence signals feed from the bot's live apex_signals table: symbol, direction, score, entry price, timeframe and momentum_surge flag | | GET | `/x402/volatility/scan` | $0.05 | VolatilityScanner per-symbol ATR%/volume squeeze scoring from the bot's live volatility_scores table: symbol, atr_pct, volume_usd, galaxy_score, composite_score, asset_class and rank | | GET | `/x402/launch-ta/{token}` | $0.05 | VWAP/Bollinger/RSI/MACD confluence read on a fresh memecoin launch computed over GeckoTerminal OHLCV (public/keyless) | | GET | `/x402/satoshi/moves` | $0.05 | dormant/Satoshi-era BTC wallet movement feed: on-chain moves with BTC amount, years dormant and transaction timestamps (public on-chain — no upstream-license restriction) | | GET | `/x402/narratives` | $0.02 | NG-derived NARRATIVE_SYNTHESIS and CATALYST_CONVERGENCE intelligence from SharedBrain website_intelligence_agent: macro themes in motion, catalyst-convergence events and confidence scores | | GET | `/x402/sports/props` | $0.1 | player prop edges from the player_prop_intelligence_agent: NG-derived edge_pct, fair_prob, market_prob, direction, and pick identifiers | | GET | `/x402/tearsheet/{symbol}` | $0.5 | one-call per-symbol tearsheet: market regime, composite signal conviction (bullish/bearish counts + avg confidence), social sentiment (net bias + signal read) and recent 13F institutional moves for one ticker | | GET | `/x402/agents/status` | $0.002 | liveness probe: per-agent intelligence output counts over the last 24h with last-seen timestamps, across the 40+ data agents | | GET | `/api/v1/signals` | $0.01 | market-wide active trading signals feed (all symbols, all signal types) with direction and confidence (dual-auth: subscriber key OR x402) | | GET | `/api/v1/sentiment` | $0.01 | aggregated market sentiment snapshot from social, news and options-flow sources, per symbol and market-wide (dual-auth: subscriber key OR x402) | | GET | `/api/v1/brain/{symbol}` | $0.02 | full SharedBrain intelligence context for one symbol: recent ideas, catalysts, and anomaly flags across 40+ data sources (dual-auth: subscriber key OR x402) | ## Endpoint detail ### GET /x402/regime — $0.002 News Gurus Intel API — live crypto & equity market regime classification (TRENDING / MEAN_REVERTING / VOL_EXPANSION) with confidence, VIX and ADX context, from a 40-source trading intelligence bot. Cheapest first call on this API. Educational data, not financial advice. ### GET /x402/brain/recent — $0.005 News Gurus Intel API — most recent cross-agent market intelligence ideas (institutional flow, options flow, on-chain, news catalysts) from a 40-source SharedBrain. Optional symbol filter, up to 25 ideas per call. Educational data, not financial advice. Query params: `symbol`, `limit` ### GET /x402/brain/anomalies — $0.01 News Gurus Intel API — recent ANOMALY detections: pump/psyop mention spikes with no institutional confirmation, token rug precursors, coordinated wallet activity, data-integrity divergences. The bot's own risk filters, exposed as a feed. Educational data, not financial advice. Query params: `limit` ### GET /x402/signals/composite/{symbol} — $0.05 News Gurus Intel API — composite signal read for one symbol: latest 50 signals across all generators merged into bullish/bearish counts and average confidence. The flagship per-symbol conviction snapshot. Educational data, not financial advice. ### GET /x402/signals/{symbol} — $0.01 News Gurus Intel API — recent trading signals for one symbol (options flow, dark pool, technical, sentiment, congressional and more), with direction, strength, confidence and source agent. Lookback window via ?hours= (default 24). Educational data, not financial advice. Query params: `hours` ### GET /x402/mlb/props-sheet — $5 News Gurus Intel API — the FULL daily MLB props sheet: News Guru's derived HR & hits+runs+RBIs picks, batter-vs-pitcher matchups, SP strikeout plays, F5 plays, per-game model predictions and per-game props. Park/weather/sim/Statcast used internally — not redistributed. Roster/injury/lineup verified. One call = the whole day's sheet ($5/day). Entertainment/educational only, not betting advice. 21+. Query params: `date` ### GET /x402/mlb/picks — $3 News Gurus Intel API — condensed daily MLB picks: top-10 HR picks, top-10 hits+runs+RBIs picks, top SP strikeout plays, best matchups, F5 plays and slate risk flags. News Guru's derived picks/edges (park/weather/sim/Statcast used internally, not redistributed). Roster/injury/lineup verified. Headline plays only ($3/day). Entertainment/educational only, not betting advice. 21+. Query params: `date` ### GET /x402/options/flow — $0.05 News Gurus Intel API — recent unusual options-flow signals: sweep clusters and large-premium prints across the active equity universe, with direction, strength, confidence and a derived size_bucket (block/large/mid/small). The per-call alternative to $50-150/mo flow subscriptions. Lookback via ?hours= (default 24). Educational data, not financial advice. Query params: `hours`, `limit` ### GET /x402/options/gex/{symbol} — $0.1 News Gurus Intel API — dealer-regime classification for one equity/ETF symbol: regime label (e.g. positive_gamma_pinning / negative_gamma_amplifying) and gamma_bias (positive/negative/neutral) for squeeze and volatility analysis. Raw gamma dollar exposures are not redistributed. Educational data, not financial advice. ### GET /x402/darkpool/recent — $0.05 News Gurus Intel API — recent institutional dark-pool prints: symbol, direction, strength, confidence and a derived size_bucket (block/large/mid/small) for significant institutional-scale blocks. Raw notional/price figures are not redistributed. Lookback via ?hours= (default 48). Educational data, not financial advice. Query params: `hours`, `limit` ### GET /x402/congress/trades — $0.05 News Gurus Intel API — recent US congressional stock transactions: member, party, state, buy/sell, ticker, amount range, transaction and disclosure dates. Optional ?symbol= filter. The per-call alternative to $25-75/mo congressional-data plans. Educational data, not financial advice. Query params: `limit`, `symbol` ### GET /x402/futures/{symbol} — $0.05 News Gurus Intel API — crypto futures/derivatives read for one symbol (BTC, ETH, SOL, XRP...): latest APEX multi-source confluence signals (direction, score, momentum surge, timeframe) plus the current market regime. Educational data, not financial advice. ### GET /x402/memecoin/verify/{mint} — $0.01 News Gurus Intel API — token authenticity verdict for one Solana mint: 0-1 realness score, confidence, recommended action (PASS / SMALL_SNIPER / MONITOR / REJECT), rug-risk flags, psyop/pump detection and narrative tags, from a 6-probe on-chain+social verifier with creator rug-history. Returns found:false if the address has never been scanned. Educational data, not financial advice. ### GET /x402/memecoin/movers — $0.02 News Gurus Intel API — liquidity- and volume-gated memecoin movers for one chain (?chain= solana|base|bsc|ethereum): top gainers, losers and volume leaders with price, liquidity and 24h stats — wash-trade noise filtered out. Educational data, not financial advice. Query params: `chain` ### GET /x402/stocks/rankings — $0.25 News Gurus Intel API — full quality-compounder rankings (high-margin / low-debt / high-cash / growing-revenue US equities + revenue-generating crypto protocols, percentile-scored) PLUS growth-stock LEAPS candidates, in one call. A whole ranked universe per request. Educational data, not financial advice. ### GET /x402/prediction/markets — $0.1 News Gurus Intel API — full Polymarket market landscape (up to 2000 markets): category-grouped odds, liquidity, volume and direction from the bot's Polymarket intelligence agents. Optional ?category= filter (sports/crypto/politics/macro/geopolitics/stocks/commodities/entertainment/other) and ?limit= (default 100, cap 2000). Educational data, not financial advice. Query params: `limit`, `category` ### GET /x402/prediction/whales — $0.1 News Gurus Intel API — Polymarket flagged-wallet groupings + coordinated-betting cabal intel from the bot's on-chain wallet tracker: address, buy/sell volume, counts, markets touched, plus any known cabal cluster ideas. Raw public-chain-derived data — no upstream-license restriction. Optional ?limit= (default 25, cap 100). Educational data, not financial advice. Query params: `limit` ### GET /x402/prediction/whale-leaders — $0.1 News Gurus Intel API — Polymarket smart-money leaderboard: whale wallets ranked by informed score, win rate, realized PnL or volume, with specialization and average entry odds. Insider/algo detection per-call — elsewhere this data class sits behind $599/mo API plans. Educational data, not financial advice. Query params: `limit`, `sort_by`, `min_bets` ### GET /x402/prediction/new-wallets — $0.05 News Gurus Intel API — first-time Polymarket bettor fills: fresh wallets taking positions, with fill size, side, outcome price and the wallet's rolling totals. The 'suspiciously confident new wallet' insider-pattern feed. Filter by ?condition_id= / ?side=. Educational data, not financial advice. Query params: `limit` ### GET /x402/prediction/market-stats/{condition_id} — $0.05 News Gurus Intel API — aggregate wallet intelligence for one Polymarket market (by condition_id): unique wallets, buy/sell volume split, new-wallet count and volume share, and the top-10 buyers. Educational data, not financial advice. ### GET /x402/sentiment/{symbol} — $0.02 News Gurus Intel API — per-symbol social sentiment: recent sentiment/retail signals (bullish vs bearish counts + net bias) merged with social-intelligence ideas (LunarCrush, StockTwits, Telegram, X) for one ticker. Educational data, not financial advice. ### GET /x402/macro/snapshot — $0.02 News Gurus Intel API — macro one-call read: current market regime plus the latest Fed-speech, BIS, prediction-market and geopolitical intelligence entries from the macro agents. Educational data, not financial advice. ### GET /x402/btc/snapshot — $0.05 News Gurus Intel API — BTC one-call read: dormant/Satoshi-era wallet movement state, the five most recent dormant-wallet moves (BTC, USD value, years dormant), latest APEX BTC confluence signals and the market regime. Educational data, not financial advice. ### GET /x402/institutions/recent — $0.05 News Gurus Intel API — recent institutional 13F position moves across tracked funds: new / increased / decreased / sold positions with shares, value, portfolio weight and filing date. Optional ?symbol= filter. Educational data, not financial advice. Query params: `limit`, `symbol` ### GET /x402/institutions/{symbol} — $0.1 News Gurus Intel API — per-stock institutional composite for one ticker: STOCK Act congressional trades (public government disclosures) + 13F institution-holding moves (new/increased/decreased/sold from public SEC filings). Analyst-ratings and company-fundamentals numeric fields excluded (vendor licensing). Educational data, not financial advice. Query params: `limit` ### GET /x402/brain/decisions — $0.1 News Gurus Intel API — full LLM trade-reasoning chain: every routing decision with thesis, signal attribution, kelly_fraction, gate result and exit detail. Unique dataset: the AI's own trade logic, per decision. Optional ?symbol= / ?stage= filters. Educational data, not financial advice. Query params: `limit`, `symbol`, `stage` ### GET /x402/brain/kelly — $0.05 News Gurus Intel API — Kelly-criterion outcome ledger: per-trade signal_type, pnl, r_multiple, kelly_fraction, narrative_score and llm_provider — the strategy's live performance history. Optional ?signal_type= filter for per-strategy slicing. Educational data, not financial advice. Query params: `limit`, `signal_type` ### GET /x402/apex/signals — $0.05 News Gurus Intel API — APEX v10.2 multi-source confluence signals feed from the bot's live apex_signals table: symbol, direction, score, entry price, timeframe and momentum_surge flag. Optional ?symbol= LIKE filter, ?limit= (default 25, cap 50), ordered by created_at DESC. Proprietary News Guru computation. Educational data, not financial advice. Query params: `symbol`, `limit` ### GET /x402/volatility/scan — $0.05 News Gurus Intel API — VolatilityScanner per-symbol ATR%/volume squeeze scoring from the bot's live volatility_scores table: symbol, atr_pct, volume_usd, galaxy_score, composite_score, asset_class and rank. Optional ?asset_class= filter, ?limit= (default 25, cap 50), ordered by composite_score DESC. Proprietary News Guru computation. Educational data, not financial advice. Query params: `asset_class`, `limit` ### GET /x402/launch-ta/{token} — $0.05 News Gurus Intel API — VWAP/Bollinger/RSI/MACD confluence read on a fresh memecoin launch computed over GeckoTerminal OHLCV (public/keyless). Token = mint address or symbol. Optional ?chain= (default solana; solana/base/bsc/ethereum). Returns NG-derived bias/score/factors verdict only — raw candles are not redistributed. Educational data, not financial advice. Query params: `chain` ### GET /x402/satoshi/moves — $0.05 News Gurus Intel API — dormant/Satoshi-era BTC wallet movement feed: on-chain moves with BTC amount, years dormant and transaction timestamps (public on-chain — no upstream-license restriction). Optional ?limit= (default 25, cap 50). Educational data, not financial advice. Query params: `limit` ### GET /x402/narratives — $0.02 News Gurus Intel API — NG-derived NARRATIVE_SYNTHESIS and CATALYST_CONVERGENCE intelligence from SharedBrain website_intelligence_agent: macro themes in motion, catalyst-convergence events and confidence scores. Pure NG synthesis output — no raw third-party vendor data redistributed. ?limit= applies per idea-type (NARRATIVE_SYNTHESIS and CATALYST_CONVERGENCE are capped separately), so limit=25 can return up to ~50 total. Educational data, not financial advice. Query params: `limit` ### GET /x402/sports/props — $0.1 News Gurus Intel API — player prop edges from the player_prop_intelligence_agent: NG-derived edge_pct, fair_prob, market_prob, direction, and pick identifiers. Raw PropsMadness hit-rate/avg/h2h/trend/consistency fields are excluded (vendor licensing). Sorted by absolute edge_pct descending. Optional ?limit= (default 25, cap 50). Educational data, not financial advice. Query params: `limit` ### GET /x402/tearsheet/{symbol} — $0.5 News Gurus Intel API — one-call per-symbol tearsheet: market regime, composite signal conviction (bullish/bearish counts + avg confidence), social sentiment (net bias + signal read) and recent 13F institutional moves for one ticker. Pure composition of existing derived reads — no raw vendor data redistributed. Educational data, not financial advice. ### GET /x402/agents/status — $0.002 News Gurus Intel API — liveness probe: per-agent intelligence output counts over the last 24h with last-seen timestamps, across the 40+ data agents. Verify the engine is live before buying data — same price tier as /x402/regime. Educational data, not financial advice. ### GET /api/v1/signals — $0.01 · dual-auth (subscriber API key OR x402) News Gurus Intel API — market-wide active trading signals feed (all symbols, all signal types) with direction and confidence. Same data served to human subscribers; pay per call instead. Educational data, not financial advice. Query params: `limit` ### GET /api/v1/sentiment — $0.01 · dual-auth (subscriber API key OR x402) News Gurus Intel API — aggregated market sentiment snapshot from social, news and options-flow sources, per symbol and market-wide. Educational data, not financial advice. ### GET /api/v1/brain/{symbol} — $0.02 · dual-auth (subscriber API key OR x402) News Gurus Intel API — full SharedBrain intelligence context for one symbol: recent ideas, catalysts, and anomaly flags across 40+ data sources. Educational data, not financial advice. Educational data, not financial advice.