{"uid":"cap_C0W6sA5-1CQhwNiBbT9t3","slug":"bullflow-dark-pool-trades-73ff1d08","name":"Bullflow Dark Pool Trades","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/darkPoolTrades?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":["from","to"],"properties":{"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Inclusive end date. Supply with from; maximum range is 30 calendar days."},"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Inclusive start date. Supply with to; do not combine with date."},"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."},"minNotional":{"type":"number","minimum":0,"description":"Minimum trade notional in USD."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["from","to","ticker","minNotional","count","limit","hasMore","nextCursor","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":["symbol","price","size","notional","trfTimestampMs","tradeDate"],"properties":{"size":{"type":["number","null"]},"price":{"anyOf":[{"type":"number","description":"Amount in US dollars."},{"type":"null"}]},"symbol":{"type":"string"},"notional":{"anyOf":[{"type":"number","description":"Amount in US dollars."},{"type":"null"}]},"tradeDate":{"anyOf":[{"type":"string","description":"Trading date in YYYY-MM-DD format."},{"type":"null"}]},"trfTimestampMs":{"type":["number","null"],"description":"Trade report timestamp in Unix milliseconds, when available."}},"additionalProperties":{}},"description":"One page of trades, not a full-day total."},"count":{"type":"integer","maximum":9007199254740991,"minimum":0},"limit":{"type":"integer","maximum":9007199254740991,"minimum":0},"ticker":{"type":["string","null"]},"hasMore":{"type":"boolean"},"nextCursor":{"type":["string","null"],"description":"Pass as cursor to read the next page; null when there is no next page."},"minNotional":{"anyOf":[{"type":"number","description":"Amount in US dollars."},{"type":"null"}]}}}}}}},"responseSchema":{"type":"json","example":{"to":"2026-10-14","from":"2026-10-14","rows":[],"count":0,"limit":10,"ticker":"SPY","hasMore":false,"nextCursor":null,"minNotional":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_jeRLTpzSSmcbRCdgsIfs5","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 paginated dark pool (off-exchange) trade records for a given ticker and date range, filtered by minimum notional value.","exampleAgentPrompt":"Pull all dark pool trades for SPY from October 1 to October 14, 2025 with a minimum notional of $500,000 and return up to 1,000 records.","exampleUseCases":[{"title":"Institutional block trade surveillance","prompt":"Show me all dark pool trades in NVDA from November 1 to November 14, 2025 where the notional is at least $1,000,000 — I want to see if institutions are quietly accumulating."},{"title":"Daily dark pool recap for a ticker","prompt":"Pull yesterday's dark pool trades for TSLA, up to 500 records, so I can see what off-exchange activity happened before today's open."},{"title":"Broad market dark pool scan","prompt":"Get all dark pool trades across any ticker from October 7 to October 10, 2025 with notional above $5,000,000, limited to 2,000 results — I'm looking for unusual large block prints."}],"resultDescription":"A paginated JSON object containing an array of dark pool trade rows, each with symbol, price, size, notional value in USD, trade timestamp in milliseconds, and trade date. The response also includes the query's from/to dates, ticker filter, minNotional filter, total count, limit, hasMore flag, and nextCursor for pagination.","failureModes":["Date range exceeds 30 calendar days — returns validation error","Missing required 'from' or 'to' parameters — returns 400 bad request","Invalid ticker format — returns empty rows or error","Invalid cursor token — returns error or unexpected results","Combining 'date' with 'from'/'to' params — returns validation error","Rate limiting or payment failure — returns 402 or 429 response"],"whenToPreferThis":"Use this endpoint when you need historical or recent dark pool (off-exchange, TRF-reported) trade data for a specific equity or ETF, especially for institutional flow analysis. Prefer this over options flow endpoints when the user's focus is on block equity trades executed off-exchange rather than options contracts. Best suited for date-range queries up to 30 days with optional ticker and notional filters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T07:05:09.281Z","isFirstParty":false,"canonicalSlug":"bullflow-dark-pool-trades-73ff1d08"}