---
title: "Get Trade Flow Universe"
method: GET
path: "/api/v1/hyperliquid/trade-flow/universe"
tags: ["Hyperliquid"]
---

# Get Trade Flow Universe

`GET /api/v1/hyperliquid/trade-flow/universe`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/hyperliquid/trade-flow/universe`
- Auth: API key in header `X-API-Key`

Taker flow for EVERY Hyperliquid perp over one window, biggest first.

``taker_buy_ratio`` is buy notional over total (0..1; ``null`` for a coin
with no fills). ``large_fill_share`` is the share of the window's notional
from fills at or above ``large_fill_usd``. ``partial_minutes`` counts the
window's minutes our socket did not fully watch — the same for every row,
since coverage is per connection, not per coin. Coins with zero fills in
the window are omitted. ``as_of`` is the window's end (the last closed
minute). Pro Plus.

## Query parameters

- `window` string: 15m, 1h or 4h

## Response `200`

Successful Response

- HLTradeFlowUniverseResponse
  - `window` string, required
  - `window_minutes` integer, required
  - `large_fill_usd` number, required
  - `as_of` integer, required: Window end (last closed minute), unix ms
  - `data` HLTradeFlowUniverseRow[], required
    - `coin` string, required
    - `buy_notional` number, required
    - `sell_notional` number, required
    - `taker_buy_ratio` number, nullable, required: buy / (buy + sell), 0..1
    - `n_trades` integer, required
    - `large_fill_share` number, nullable, required
    - `partial_minutes` integer, required: Window minutes our socket did not fully watch (same for every row)
  - `count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cryptodataapi/apis/crypto-data-api.md) · [All operations](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/revisions/8628b754ca81?raw)