ETF Flow History

GET/gateway/v1/market/etf

Returns daily spot ETF flow history.

Included fields: net flow (USD), token price, per-ticker breakdown.

Sorted by date descending. `symbol`: `BTC`, `ETH`, `XRP`, `SOL`, or `HYPE`.

Query Parameters

symbolenum<string>required

Token symbol. Can be `BTC`, `ETH`, `XRP`, `SOL`, or `HYPE`.

Available options:BTCETHXRPSOLHYPE

Example: BTC

sort_byenum<string>

Field to sort results by

Available options:flow_usdtimestamp

Example: timestamp

orderenum<string>

Sort order

Available options:ascdesc

Example: desc

fromstring

Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD)

Example: 2026-01-01

tostring

End of time range. Accepts Unix seconds or date string (YYYY-MM-DD)

Example: 2026-03-01

ETF Flow History

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/market/etf?symbol=BTC&sort_by=timestamp&order=desc&from=2026-01-01&to=2026-03-01', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/SimpleListResponseMarketETFFlowItem.json",
  "data": [
    {
      "etfs": [
        {
          "flow_usd": 123,
          "ticker": "<string>"
        }
      ],
      "flow_usd": 123,
      "price_usd": 123,
      "project_id": "<string>",
      "settled": true,
      "symbol": "<string>",
      "timestamp": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>"
  }
}