{"uid":"cap_vJoYrbJ9Xz4x_JzcT1DX5","slug":"bullflow-options-top-tickers-0e7bfa99","name":"Bullflow Options Top Tickers","description":"Bullflow.io is a real-time unusual options flow and dark pool tracker with advanced tools to view, filter, and analyze market activity as it happens.","url":"https://api.bullflow.io/v1/data/optionsTopTickers?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Inclusive end date. Supply with from; maximum range is 30 calendar days."},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Trading date in YYYY-MM-DD format."},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Inclusive start date. Supply with to; do not combine with date."},"metric":{"enum":["volume","premium","net_premium"],"type":"string","default":"premium"},"sweeps_only":{"type":"boolean","default":false},"exclude_etfs":{"type":"boolean","default":false},"ticker_count":{"enum":[10,20,30,40,50],"type":"integer","default":20},"bullish_bearish":{"type":"boolean","default":false,"description":"Balance bullish and bearish leaders when metric=net_premium."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["tradingDate","from","to","generatedAt","metric","tickerCount","filters","sourceTradeCount","matchedTradeCount","count","rows"],"properties":{"to":{"type":"string","description":"Trading date in YYYY-MM-DD format."},"from":{"type":"string","description":"Trading date in YYYY-MM-DD format."},"rows":{"type":"array","items":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string"},"putVolume":{"type":"integer","maximum":9007199254740991,"minimum":0},"callVolume":{"type":"integer","maximum":9007199254740991,"minimum":0},"putPremium":{"type":"number","description":"Amount in US dollars."},"rankedSide":{"enum":["bullish","bearish"],"type":"string"},"callPremium":{"type":"number","description":"Amount in US dollars."},"totalVolume":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Total option contracts in volume mode."},"totalPremium":{"type":"number","description":"Total option premium in premium mode."},"putAskPremium":{"type":"number","description":"Amount in US dollars."},"putBidPremium":{"type":"number","description":"Amount in US dollars."},"putNetPremium":{"type":"number","description":"Amount in US dollars."},"callAskPremium":{"type":"number","description":"Amount in US dollars."},"callBidPremium":{"type":"number","description":"Amount in US dollars."},"callNetPremium":{"type":"number","description":"Amount in US dollars."},"totalNetPremium":{"type":"number","description":"Directional net premium: call net premium minus put net premium."},"rankedAbsoluteNetPremium":{"type":"number","description":"Amount in US dollars."}},"additionalProperties":{}},"description":"Ranked aggregates for the selected metric and date range."},"count":{"type":"integer","maximum":9007199254740991,"minimum":0},"metric":{"enum":["volume","premium","net_premium"],"type":"string"},"filters":{"type":"object","required":["excludeEtfs","sweepsOnly","bullishBearish"],"properties":{"sweepsOnly":{"type":"boolean"},"excludeEtfs":{"type":"boolean"},"bullishBearish":{"type":"boolean"}}},"generatedAt":{"type":"string","description":"Response generation time, not the trading date."},"tickerCount":{"type":"integer","maximum":9007199254740991,"minimum":0},"tradingDate":{"type":"string","description":"Latest trading date represented in the data."},"sourceTradeCount":{"type":"integer","maximum":9007199254740991,"minimum":0},"matchedTradeCount":{"type":"integer","maximum":9007199254740991,"minimum":0}}}}}}},"responseSchema":{"type":"json","example":{"to":"2026-10-14","from":"2026-10-14","rows":[],"count":0,"metric":"premium","filters":{"sweepsOnly":false,"excludeEtfs":false,"bullishBearish":false},"generatedAt":"2026-10-14T19:00:00Z","tickerCount":20,"tradingDate":"2026-10-14","sourceTradeCount":0,"matchedTradeCount":0}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ViohtrPIhOYWCkYov_p1X","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top stock tickers ranked by unusual options flow activity (volume, premium, or net premium) for a given trading date or date range.","exampleAgentPrompt":"Pull the top 20 tickers from Bullflow's unusual options flow for today, ranked by premium, and exclude ETFs — I want to see which stocks have the heaviest unusual call and put activity.","exampleUseCases":[{"title":"Daily unusual options flow briefing","prompt":"Give me today's top 30 stock tickers ranked by options premium flow from Bullflow, filtering out ETFs, so I can see where the unusual activity is concentrated."},{"title":"Sweep-only momentum scan","prompt":"Show me the top 20 tickers from Bullflow for this week — only sweeps, ranked by volume — so I can spot aggressive directional bets being placed in the options market."},{"title":"Balanced bullish bearish leaders","prompt":"Pull the top 20 tickers from Bullflow for yesterday using net premium as the metric, and balance the results so I see equal numbers of bullish and bearish leaders."}],"resultDescription":"A JSON object containing ranked rows of ticker symbols with their aggregated call/put volume, call/put premium, net premium, and ranked side (bullish or bearish), along with metadata such as trading date, applied filters, total source trade count, matched trade count, and the metric used for ranking.","failureModes":["Invalid date format returns a validation error","Date range exceeding 30 calendar days is rejected","Mixing 'date' with 'from'/'to' parameters causes an error","No trading data available for weekends or market holidays returns empty rows","Invalid metric enum value causes a schema validation error","ticker_count values outside the allowed enum (10,20,30,40,50) are rejected"],"whenToPreferThis":"Use this endpoint when you need a ranked leaderboard of tickers by unusual options activity — not individual trade-level data. Ideal for daily market scans, momentum screening, or identifying where institutional or smart-money options interest is concentrated. Choose this over raw flow endpoints when you want pre-aggregated, ranked summaries across a trading session or date range.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:05:51.544Z","isFirstParty":false,"canonicalSlug":"bullflow-options-top-tickers-0e7bfa99"}