{"uid":"cap_5udsj_6qopL_qMuyO6qs2","slug":"bullflow-gex-alerts-87636f43","name":"Bullflow GEX Alerts","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/gexAlerts?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."},"type":{"enum":["gex_node_proximity","largest_node_moved_higher","largest_node_moved_lower"],"type":"string"},"limit":{"type":"integer","default":500,"maximum":5000,"minimum":1,"description":"Maximum number of records in this page."},"cursor":{"type":"string","description":"Use nextCursor from the previous page with the same filters."},"ticker":{"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":["version","from","to","timezone","ticker","type","count","limit","hasMore","nextCursor","alerts"],"properties":{"to":{"type":"string","description":"Trading date in YYYY-MM-DD format."},"from":{"type":"string","description":"Trading date in YYYY-MM-DD format."},"type":{"anyOf":[{"enum":["gex_node_proximity","largest_node_moved_higher","largest_node_moved_lower"],"type":"string"},{"type":"null"}]},"count":{"type":"integer","maximum":9007199254740991,"minimum":0},"limit":{"type":"integer","maximum":9007199254740991,"minimum":0},"alerts":{"type":"array","items":{"type":"object","required":["id","type","ticker","date","alertedAt","classification","severity","title","message","spotPrice","previousSpotPrice","thresholdPercent","expiration","nodeStrike","nodeGex","distancePercent","absoluteDistancePercent","oldNodeStrike","newNodeStrike","oldNodeExpiration","newNodeExpiration","oldNodeGex","newNodeGex","severityScore"],"properties":{"id":{"type":"integer","maximum":9007199254740991,"minimum":0},"date":{"type":"string","description":"Trading date in YYYY-MM-DD format."},"type":{"enum":["gex_node_proximity","largest_node_moved_higher","largest_node_moved_lower"],"type":"string"},"title":{"type":["string","null"]},"ticker":{"type":"string"},"message":{"type":["string","null"]},"nodeGex":{"type":["number","null"]},"severity":{"type":["string","null"]},"alertedAt":{"type":"string","description":"ISO 8601 timestamp."},"spotPrice":{"anyOf":[{"type":"number","description":"Amount in US dollars."},{"type":"null"}]},"expiration":{"type":["string","null"]},"newNodeGex":{"type":["number","null"]},"nodeStrike":{"anyOf":[{"type":"number","description":"Amount in US dollars."},{"type":"null"}]},"oldNodeGex":{"type":["number","null"]},"newNodeStrike":{"anyOf":[{"type":"number","description":"Amount in US dollars."},{"type":"null"}]},"oldNodeStrike":{"anyOf":[{"type":"number","description":"Amount in US dollars."},{"type":"null"}]},"severityScore":{"type":["number","null"]},"classification":{"type":["string","null"]},"distancePercent":{"type":["number","null"]},"thresholdPercent":{"type":["number","null"]},"newNodeExpiration":{"type":["string","null"]},"oldNodeExpiration":{"type":["string","null"]},"previousSpotPrice":{"anyOf":[{"type":"number","description":"Amount in US dollars."},{"type":"null"}]},"absoluteDistancePercent":{"type":["number","null"]}}}},"ticker":{"type":["string","null"]},"hasMore":{"type":"boolean"},"version":{"type":"number","const":1},"timezone":{"type":"string","const":"America/New_York"},"nextCursor":{"type":["string","null"]}}}}}}},"responseSchema":{"type":"json","example":{"to":"2026-10-14","from":"2026-10-14","type":null,"count":0,"limit":10,"alerts":[],"ticker":"SPY","hasMore":false,"version":1,"timezone":"America/New_York","nextCursor":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_gaGeXE5-OTAJqgz8CbLqj","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":"Retrieves gamma exposure (GEX) alerts for a given ticker, including node proximity, largest node moved higher, and largest node moved lower events over a specified date range.","exampleAgentPrompt":"Pull the GEX node proximity alerts for SPY from Bullflow for today, and show me up to 50 results.","exampleUseCases":[{"title":"Daily GEX node proximity scan","prompt":"Get me all GEX node proximity alerts for SPY from Bullflow for today — I want to see up to 100 records."},{"title":"Tracking largest gamma node shifts","prompt":"Show me which gamma nodes moved the highest for QQQ this week on Bullflow, from 2025-01-13 to 2025-01-17, limit to 200 results."},{"title":"Historical GEX movement analysis","prompt":"Pull the largest GEX nodes that moved lower for AAPL over the last two weeks on Bullflow — from 2025-01-01 to 2025-01-14 — and give me up to 500 records."}],"resultDescription":"Returns a paginated list of GEX alert objects for the specified ticker and date range, including alert type (gex_node_proximity, largest_node_moved_higher, or largest_node_moved_lower), count, limit, timezone, version, hasMore flag, and a nextCursor for pagination.","failureModes":["Invalid ticker symbol returns empty alerts array","Date range exceeding 30 calendar days may result in an error or truncated results","Missing required query parameters (type or method) returns a validation error","Invalid date format (not YYYY-MM-DD) causes a schema validation error","Expired or invalid cursor causes pagination failure","Payment failure (402) if USDC payment is not properly attached"],"whenToPreferThis":"Use this endpoint when you need structured gamma exposure alert data for a specific ticker over a date range, particularly for GEX node proximity events or tracking the largest gamma node shifts. Prefer this over generic options flow endpoints when your analysis is specifically centered on gamma exposure dynamics and dealer hedging behavior.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:06:29.445Z","isFirstParty":false,"canonicalSlug":"bullflow-gex-alerts-87636f43"}