Spot ETF Flow History by Token (BTC, ETH, XRP, SOL, HYPE)

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "to": {
      "type": "string",
      "minLength": 1,
      "description": "End of time range. Accepts Unix seconds or date string (YYYY-MM-DD). Example: 2026-03-01."
    },
    "from": {
      "type": "string",
      "minLength": 1,
      "description": "Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD). Example: 2026-01-01."
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc",
      "description": "Sort order. Example: desc. Defaults to \"desc\"."
    },
    "symbol": {
      "enum": [
        "BTC",
        "ETH",
        "XRP",
        "SOL",
        "HYPE"
      ],
      "type": "string",
      "description": "Token symbol. Can be BTC, ETH, XRP, SOL, or HYPE. Example: BTC."
    },
    "sort_by": {
      "enum": [
        "flow_usd",
        "timestamp"
      ],
      "type": "string",
      "default": "timestamp",
      "description": "Field to sort results by. Example: timestamp. Defaults to \"timestamp\"."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "etfs": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "ticker": {
                  "type": "string",
                  "description": "ETF ticker, e.g. IBIT, FBTC, BITB, ARKB, BTCO, EZBC, BRRR, HODL, BTCW, GBTC."
                },
                "flow_usd": {
                  "type": "number",
                  "description": "That ETF's own USD flow for the day. Observed positive, negative, and zero."
                }
              },
              "additionalProperties": false
            },
            "description": "Per-ETF breakdown of that day's flow, one entry per tracked ticker."
          },
          "symbol": {
            "type": "string",
            "description": "Echoes the requested token symbol."
          },
          "settled": {
            "type": "boolean",
            "description": "Whether that day's flow figure is finalized. Observed true on every row of the one non-empty fixture; a false value was never observed."
          },
          "flow_usd": {
            "type": "number",
            "description": "Net USD flow across all tracked ETFs for that day. Observed positive, negative, and zero."
          },
          "price_usd": {
            "type": "number",
            "description": "Token price on that day."
          },
          "timestamp": {
            "type": "integer",
            "description": "Unix seconds marking the start of the day."
          }
        },
        "additionalProperties": false
      },
      "description": "One entry per day. Observed non-empty (32 days) for BTC over a Jan-Mar 2026 range, and genuinely empty for a HYPE query over Jan 2026 -- a token/range combination with no spot ETF flow recorded returns an empty array here, not an error."
    },
    "meta": {
      "type": "object",
      "properties": {
        "cached": {
          "type": "boolean",
          "description": "Whether this response was served from the provider's cache."
        }
      },
      "additionalProperties": false
    }
  },
  "description": "The ETF flow response, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": false
}