{"uid":"cap_mli9_8n1luYz1j5-FMdaj","slug":"news-gurus-options-flow-intelligence-28e65400","name":"News Gurus Options Flow Intelligence","description":"40+ AI agents scanning dark pools, congressional trades, options flow, and breaking news 24/7. Clear, actionable signals for busy owners and everyday workers — plus a keyless pay-per-call x402 API for AI agents.","url":"https://api.newsgurus.ai/x402/options/flow","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"hours":{"type":"integer","default":24,"maximum":168,"minimum":1},"limit":{"type":"integer","default":25,"maximum":50,"minimum":1}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"flow":[{"symbol":"NVDA","strength":0.8,"direction":"bullish","timeframe":"1D","timestamp":"2026-07-14T13:30:00","confidence":0.7,"size_bucket":"large","source_agent":"options_flow_intelligence_agent"}],"total":1,"fetched_at":"2026-07-14T14:00:00+00:00"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_60fsZ1nK3HBF_DkoPFfUY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves AI-analyzed options flow signals for stocks, including direction, strength, confidence, and size bucket, covering the last 1–168 hours.","exampleAgentPrompt":"Pull the latest options flow signals from News Gurus for the past 48 hours and show me the top 25 results — I want to see which stocks have the strongest directional signals and how confident the AI is in each one.","exampleUseCases":[{"title":"Morning pre-market options briefing","prompt":"Give me the top 25 options flow signals from the last 12 hours — I want to see what the AI agents picked up overnight before the market opens, especially any large bullish or bearish plays."},{"title":"Swing trader signal review","prompt":"Pull the last 72 hours of options flow data from News Gurus and show me everything — I'm looking for high-confidence large-size signals to help me decide which positions to hold into next week."},{"title":"Real-time unusual activity alert","prompt":"Check News Gurus options flow for the past 1 hour and return up to 10 signals — I want to see if anything unusual or large just hit the tape in the last few minutes."}],"resultDescription":"Returns a JSON array of options flow signals, each containing the ticker symbol, directional bias (bullish/bearish), a strength score (0–1), a confidence score (0–1), size bucket (e.g. large), timeframe, ISO timestamp, and the name of the AI source agent that detected it. Also includes total count and fetch timestamp.","failureModes":["Invalid hours value (outside 1–168 range) returns a 400 validation error","Invalid limit value (outside 1–50 range) returns a 400 validation error","Payment not received or insufficient USDC returns a 402 Payment Required response","No flow data available for the requested window returns an empty flow array","Upstream AI agent pipeline delay may return stale or partial data"],"whenToPreferThis":"Choose this endpoint when you need structured, AI-scored options flow signals with directional and confidence metadata, especially in an automated agent workflow that needs keyless pay-per-call access via x402. Prefer this over raw broker feeds or screeners when you want pre-processed, actionable signals rather than raw order data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:52:30.569Z","isFirstParty":false}