> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sqd.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Hyperliquid

> Index Hyperliquid data with SQD

<Info>HyperCore Fills: trade execution data from Hyperliquid's perpetual futures exchange. Includes position changes (closing-trade PnL), builder routing, and per-user activity.</Info>

| Property   | Value               |
| ---------- | ------------------- |
| Network ID | `hyperliquid-fills` |
| Real-time  | Yes                 |

## Endpoint

```
https://portal.sqd.dev/datasets/hyperliquid-fills
```

## Quick start

```bash theme={"system"}
curl --compressed -X POST \
  'https://portal.sqd.dev/datasets/hyperliquid-fills/stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "hyperliquidFills",
    "fromBlock": 0,
    "toBlock": 100,
    "fields": {
      "block": { "number": true, "timestamp": true },
      "fill": { "user": true, "coin": true, "px": true, "sz": true, "side": true }
    },
    "fills": [{}]
  }'
```

## Schema

<AccordionGroup>
  <Accordion title="Blocks">
    | Field       | Type    | Description     |
    | ----------- | ------- | --------------- |
    | `number`    | integer | Block number    |
    | `hash`      | string  | Block hash      |
    | `timestamp` | integer | Block timestamp |
  </Accordion>

  <Accordion title="Fills">
    | Field        | Type    | Description                        |
    | ------------ | ------- | ---------------------------------- |
    | `user`       | string  | Trader address                     |
    | `coin`       | string  | Asset name                         |
    | `px`         | number  | Fill price                         |
    | `sz`         | number  | Fill size                          |
    | `side`       | string  | `A` (ask) or `B` (bid)             |
    | `time`       | integer | Fill timestamp (ms)                |
    | `hash`       | string  | Fill hash                          |
    | `oid`        | bigint  | Order ID                           |
    | `closed_pnl` | number  | Closed PnL                         |
    | `crossed`    | boolean | Whether the order crossed the book |
    | `fee`        | number  | Fee paid                           |
    | `fee_token`  | string  | Fee token                          |
    | `tid`        | bigint  | Trade ID                           |
  </Accordion>
</AccordionGroup>

## Reference

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/en/portal/hyperliquid/overview">
    Field definitions and query syntax
  </Card>

  <Card title="Portal Migration" icon="arrow-right" href="/en/portal/migration">
    Migrate from v2 archives to Portal
  </Card>
</CardGroup>
