# Bullflow Dark Pool Trades

> Bullflow Dark Pool Trades is a paid API for AI agents from api.bullflow.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Retrieves paginated dark pool (off-exchange) trade records for a given ticker and date range, filtered by minimum notional value.

## Facts

- Endpoint: GET https://api.bullflow.io/v1/data/darkPoolTrades?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bullflow-dark-pool-trades-73ff1d08
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C0W6sA5-1CQhwNiBbT9t3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bullflow-dark-pool-trades-73ff1d08
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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": [
           "n
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-10-14",
  "from": "2026-10-14",
  "rows": [],
  "count": 0,
  "limit": 10,
  "ticker": "SPY",
  "hasMore": false,
  "nextCursor": null,
  "minNotional": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bullflow-dark-pool-trades-73ff1d08/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.bullflow.io](https://www.zero.xyz/host/api.bullflow.io/llms.txt)