{"uid":"cap_kDpQyP1XuQT04Ahh31_Un","slug":"bullflow-unusual-options-flow-options-profile-828d661c","name":"Bullflow Unusual Options Flow - Options Profile","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/optionsProfile?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":["symbol"],"properties":{"symbol":{"type":"string","examples":["SPY"],"description":"Underlying stock, ETF, or supported index ticker."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["symbol","tradingDate","asOf","activity","premium","execution","concentration","unusualContracts","largestPremiumTrade","flags"],"properties":{"asOf":{"type":"string","description":"Latest recorded trade time across tickers in the selected session; the intraday comparison uses its Eastern time."},"flags":{"type":"array","items":{"enum":["INSUFFICIENT_HISTORY","NO_RECORDED_ACTIVITY","CALL_VOLUME_SPIKE","PUT_VOLUME_SPIKE","CALL_BUYING_SURGE","UNUSUAL_WEEKLY_ACTIVITY"],"type":"string"}},"symbol":{"type":"string"},"premium":{"type":"object","required":["totalPremium","callPremium","putPremium","netDirectionalPremium"],"properties":{"putPremium":{"type":"number","description":"Amount in US dollars."},"callPremium":{"type":"number","description":"Amount in US dollars."},"totalPremium":{"type":"number","description":"Amount in US dollars."},"netDirectionalPremium":{"type":"number","description":"Amount in US dollars."}},"description":"Totals include multi-leg trades. Directional premium excludes multi-leg trades. Directional = call ask premium - call bid premium - put ask premium + put bid premium; mid/unknown executions contribute zero."},"activity":{"type":"object","required":["totalVolume","callVolume","putVolume","relativeVolumeDaily","relativeVolumeIntraday","callRelativeVolumeDaily","callRelativeVolumeIntraday","putRelativeVolumeDaily","putRelativeVolumeIntraday","putCallRatio"],"properties":{"putVolume":{"type":"integer","maximum":9007199254740991,"minimum":0},"callVolume":{"type":"integer","maximum":9007199254740991,"minimum":0},"totalVolume":{"type":"integer","maximum":9007199254740991,"minimum":0},"putCallRatio":{"type":["number","null"]},"relativeVolumeDaily":{"type":["number","null"]},"putRelativeVolumeDaily":{"type":["number","null"]},"relativeVolumeIntraday":{"type":["number","null"]},"callRelativeVolumeDaily":{"type":["number","null"]},"putRelativeVolumeIntraday":{"type":["number","null"]},"callRelativeVolumeIntraday":{"type":["number","null"]}},"description":"Volumes sum recorded trade sizes, including multi-leg trades. Relative volume uses the prior 20 available trading dates, excluding the selected session. Ratios are null with fewer than 20 dates or a zero denominator."},"execution":{"type":"object","required":["callAskSidePercent","putAskSidePercent"],"properties":{"putAskSidePercent":{"type":["number","null"]},"callAskSidePercent":{"type":["number","null"]}},"description":"Contract-volume-weighted ask/above-ask percentages, 0–100, using all recorded call or put volume as denominator."},"tradingDate":{"type":"string","description":"Trading date in YYYY-MM-DD format."},"concentration":{"type":"object","required":["sweepPremium","sweepVolumePercent","shortDatedVolumePercent"],"properties":{"sweepPremium":{"type":"number","description":"Amount in US dollars."},"sweepVolumePercent":{"type":["number","null"]},"shortDatedVolumePercent":{"type":["number","null"]}},"description":"Short dated means 0–7 calendar days from tradingDate, inclusive."},"unusualContracts":{"type":"array","items":{"type":"object","required":["symbol","type","strike","expiration","volume","openInterest","volumeOiRatio","premium","askSidePercent"],"properties":{"type":{"enum":["CALL","PUT"],"type":"string"},"strike":{"anyOf":[{"type":"number","description":"Amount in US dollars."},{"type":"null"}]},"symbol":{"type":"string"},"volume":{"type":"integer","maximum":9007199254740991,"minimum":0},"premium":{"type":"number","description":"Amount in US dollars."},"expiration":{"anyOf":[{"type":"string","description":"Trading date in YYYY-MM-DD format."},{"type":"null"}]},"openInterest":{"type":"integer","maximum":9007199254740991,"minimum":0},"volumeOiRatio":{"type":"number"},"askSidePercent":{"type":["number","null"]}}},"description":"Up to five contracts with recorded volume/OI > 1, sorted by ratio, then premium, then symbol. OI uses the latest available observation. Zero/missing OI is excluded."},"largestPremiumTrade":{"anyOf":[{"type":"object","required":["symbol","type","strike","expiration","timestamp","volume","premium","tradeType","side"],"properties":{"side":{"type":["string","null"]},"type":{"enum":["CALL","PUT"],"type":"string"},"strike":{"anyOf":[{"type":"number","description":"Amount in US dollars."},{"type":"null"}]},"symbol":{"type":["string","null"]},"volume":{"type":"integer","maximum":9007199254740991,"minimum":0},"premium":{"type":"number","description":"Amount in US dollars."},"timestamp":{"type":"string","description":"ISO 8601 timestamp."},"tradeType":{"type":["string","null"]},"expiration":{"anyOf":[{"type":"string","description":"Trading date in YYYY-MM-DD format."},{"type":"null"}]}}},{"type":"null"}]}}}}}}},"responseSchema":{"type":"json","example":{"asOf":"2026-10-14T19:00:00Z","flags":["NO_RECORDED_ACTIVITY","INSUFFICIENT_HISTORY"],"symbol":"SPY","premium":{"putPremium":0,"callPremium":0,"totalPremium":0,"netDirectionalPremium":0},"activity":{"putVolume":0,"callVolume":0,"totalVolume":0,"putCallRatio":null,"relativeVolumeDaily":null,"putRelativeVolumeDaily":null,"relativeVolumeIntraday":null,"callRelativeVolumeDaily":null,"putRelativeVolumeIntraday":null,"callRelativeVolumeIntraday":null},"execution":{"putAskSidePercent":null,"callAskSidePercent":null},"tradingDate":"2026-10-14","concentration":{"sweepPremium":0,"sweepVolumePercent":null,"shortDatedVolumePercent":null},"unusualContracts":[],"largestPremiumTrade":null}},"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_VTsBaVORTkRI8WN39VMqo","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 a real-time options activity profile for a given ticker, including volume, premium, execution, concentration, and unusual contract data.","exampleAgentPrompt":"Pull up the Bullflow options profile for SPY right now — I want to see if there's a call volume spike, sweep activity, any unusual contracts, and what the net directional premium looks like.","exampleUseCases":[{"title":"Detecting smart money options activity","prompt":"Check Bullflow for unusual options flow on NVDA right now — are there any call buying surges, sweep trades, or unusual weekly contracts I should know about?"},{"title":"Pre-earnings options sentiment check","prompt":"Before the AAPL earnings call, pull the Bullflow options profile — I want to see the put-call ratio, total premium, and whether there are any unusual activity flags showing up today."},{"title":"ETF market sentiment monitoring","prompt":"Get me the Bullflow options activity profile for QQQ — show me relative intraday volume, call vs put premium totals, and flag anything unusual in the flow."}],"resultDescription":"A JSON object containing the ticker symbol, trading date, timestamp of latest data, volume metrics (total, call, put, relative daily and intraday), premium totals (total, call, put, net directional), execution side percentages (ask-side for calls and puts), concentration metrics (sweep premium, sweep volume percent, short-dated volume percent), a list of unusual contracts, the largest premium trade, and an array of activity flags such as CALL_VOLUME_SPIKE, PUT_VOLUME_SPIKE, CALL_BUYING_SURGE, or UNUSUAL_WEEKLY_ACTIVITY.","failureModes":["Invalid or unsupported ticker symbol returns empty or null activity data","Non-market-hours requests may return zero-activity results with NO_RECORDED_ACTIVITY flag","Insufficient historical data triggers INSUFFICIENT_HISTORY flag with null relative volume fields","Missing required 'symbol' query parameter causes a validation error","Rate limiting or payment failure returns a 402 status requiring payment"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, real-time options activity snapshot for a specific ticker — especially for detecting unusual flow, sweep trades, directional premium imbalances, or call/put volume spikes. Prefer this over generic financial data APIs when the goal is identifying unusual or institutional options behavior rather than basic price/volume stock data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:08:26.065Z","isFirstParty":false,"canonicalSlug":"bullflow-unusual-options-flow-options-profile-828d661c"}