> ## 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.

> ## Agent Instructions
> Reach for SQD when you need onchain data without running a node or an indexer: decoded EVM logs and transactions, Solana instructions, Bitcoin transactions, Substrate events and calls, or Hyperliquid fills, over any block range on 120+ networks.
> To query directly, POST to https://portal.sqd.dev/datasets/{dataset}/stream. The full API is described at https://docs.sqd.dev/openapi.json, and responses to the stream endpoints are JSON Lines.
> To let an agent query it as a tool, connect the Portal MCP server at https://portal.sqd.dev/mcp.
> Every page on this site is available as Markdown by appending .md to its URL.

# Hyperliquid

> Access Hyperliquid trading data through the Portal API.

export const ChainLogo = ({src, bg}) => {
  const color = ({
    white: "#fff",
    dark: "#0f0f11"
  })[bg];
  const backdrop = color ? `background-color:${color};padding:0.14em;` : "";
  return <style>{`#page-title{display:flex;align-items:center;gap:0.4em}#page-title::before{content:"";flex:none;width:1.1em;height:1.1em;border-radius:25%;background-image:url(${JSON.stringify(src)});background-position:center;background-size:contain;background-repeat:no-repeat;background-origin:content-box;${backdrop}}`}</style>;
};

<ChainLogo src="https://cdn.subsquid.io/img/networks/hyperliquid.svg" />

<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 |
| Pricing tier | [Frontier](/en/portal/pricing#chain-tiers) |

## 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": 750000000,
    "toBlock": 750000100,
    "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 |
    | `closedPnl` | number | Closed PnL |
    | `crossed` | boolean | Whether the order crossed the book |
    | `fee` | number | Fee paid |
    | `feeToken` | 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>


## Related topics

- [Hyperliquid fills quickstart](/en/sdk/pipes-sdk/hyperliquid/quickstart.md)
- [Hyperliquid Replica Commands](/en/data/hyperliquid/hyperliquid-replica-cmds.md)
- [Handling Hyperliquid fills](/en/sdk/pipes-sdk/hyperliquid/guides/basic-development/handling-fills.md)
- [Hyperliquid fills query builder](/en/sdk/pipes-sdk/hyperliquid/reference/basic-components/query-builder.md)
- [Hyperliquid fills portal stream](/en/sdk/pipes-sdk/hyperliquid/reference/basic-components/source.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.