{"uid":"cap_tblSFLuqnoEw5s1lFYmWz","slug":"bullflow-net-premium-series-8e0e0226","name":"Bullflow Net Premium Series","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/netPremiumSeries?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":["ticker"],"properties":{"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Inclusive end date for a custom range; supply with from."},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Inclusive start date for a custom range; supply with to."},"period":{"enum":["1D","7D","1M","3M","1Y","MAX"],"type":"string","default":"1D"},"ticker":{"type":"string","examples":["SPY"],"description":"Underlying stock, ETF, or supported index ticker."},"sweeps_only":{"type":"boolean","default":false},"include_multileg":{"type":"boolean","default":false}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ticker","period","from","to","include_multileg","sweeps_only","multilegs_filtered_count","sweeps_filtered_count","bucket_seconds","point_count","points"],"properties":{"to":{"type":"string","description":"Trading date in YYYY-MM-DD format."},"from":{"type":"string","description":"Trading date in YYYY-MM-DD format."},"period":{"enum":["1D","7D","1M","3M","1Y","MAX"],"type":"string"},"points":{"type":"array","items":{"type":"object","required":["timestamp","callsNetPremium","putsNetPremium"],"properties":{"timestamp":{"type":"number","description":"Unix timestamp in seconds."},"putsNetPremium":{"type":"number","description":"Cumulative put net premium in USD."},"callsNetPremium":{"type":"number","description":"Cumulative call net premium in USD."}}}},"ticker":{"type":"string"},"point_count":{"type":"integer","maximum":9007199254740991,"minimum":0},"sweeps_only":{"type":"boolean"},"bucket_seconds":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Bucket duration in seconds; zero denotes individual time points."},"include_multileg":{"type":"boolean"},"sweeps_filtered_count":{"type":"integer","maximum":9007199254740991,"minimum":0},"multilegs_filtered_count":{"type":"integer","maximum":9007199254740991,"minimum":0}}}}}}},"responseSchema":{"type":"json","example":{"to":"2026-10-14","from":"2026-10-14","period":"1D","points":[],"ticker":"SPY","point_count":0,"sweeps_only":false,"bucket_seconds":0,"include_multileg":false,"sweeps_filtered_count":0,"multilegs_filtered_count":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_j5Fsho_festaNcf9QPxmg","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 time-series of cumulative net call and put premium for a given ticker over a specified period, enabling options flow sentiment analysis.","exampleAgentPrompt":"Pull the net premium time series for SPY for today from Bullflow, sweeps only, so I can see whether calls or puts are dominating the flow right now.","exampleUseCases":[{"title":"Intraday options sentiment dashboard","prompt":"Get me the net call and put premium series for SPY for today — I want to see how bullish versus bearish options flow has shifted minute by minute throughout the trading session."},{"title":"Weekly sweep flow analysis for NVDA","prompt":"Fetch the 7-day net premium time series for NVDA from Bullflow, sweeps only, so I can analyze whether institutional sweep activity has been predominantly bullish or bearish this week."},{"title":"Multi-month trend review for QQQ","prompt":"Grab the 3-month net premium series for QQQ including multileg trades so I can see how cumulative call and put premium have trended over the past quarter."}],"resultDescription":"Returns a JSON object with cumulative call net premium and put net premium data points as a time series array, each point containing a Unix timestamp, callsNetPremium (USD), and putsNetPremium (USD). Also includes metadata: ticker, period, from/to dates, bucket_seconds, point_count, and filter flags (sweeps_only, include_multileg, sweeps_filtered_count, multilegs_filtered_count).","failureModes":["Missing required 'ticker' query parameter returns an error","Invalid period enum value outside allowed set causes rejection","Providing 'from' without 'to' (or vice versa) may return an error or default behavior","Ticker not supported or not found returns empty points array","Date range outside available data returns zero point_count with empty points array","Non-trading day or after-hours request may return empty data for 1D period"],"whenToPreferThis":"Choose this endpoint when you need cumulative net premium time-series data (calls vs puts) for a specific ticker to gauge options market sentiment or flow direction over time. It is distinct from raw flow feeds — it aggregates premium into directional buckets over configurable periods (1D to MAX), making it ideal for charting or trend analysis. Prefer it over generic market data APIs when you specifically need options-flow-derived sentiment signals with sweep and multileg filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:18:12.149Z","isFirstParty":false,"canonicalSlug":"bullflow-net-premium-series-8e0e0226"}