Skip to main content
POST
/
stream
cURL
curl --compressed -X POST 'https://portal.sqd.dev/datasets/hyperliquid-fills/stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "hyperliquidFills",
    "fromBlock": 900000000,
    "toBlock": 900000100,
    "fields": {
      "block": {
        "number": true,
        "timestamp": true
      },
      "fill": {
        "user": true,
        "coin": true,
        "px": true,
        "sz": true,
        "side": true,
        "dir": true,
        "fee": true
      }
    },
    "fills": [{
      "coin": ["BTC"]
    }]
  }'
[
  {
    "header": {
      "number": 900000050,
      "timestamp": 1710000000000
    },
    "fills": [
      {
        "user": "0xabc123def456abc123def456abc123def456abc1",
        "coin": "BTC",
        "px": "67234.5",
        "sz": "0.1",
        "side": "B",
        "dir": "Open Long",
        "fee": "6.7234"
      }
    ]
  }
]

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.

Body

application/json

Data query to filter and retrieve blocks. Request body may be gzipped (Content-Encoding: gzip).

​
type
enum<string>
default:hyperliquidFills
required

The type of data (fixed to hyperliquidFills for this API).

Available options:
hyperliquidFills
​
fromBlock
integer<int64>
required

The block number to start fetching from (inclusive).

​
toBlock
integer<int64>

The block number to fetch up to (inclusive). Optional; if omitted, streams until dataset height or timeout.

​
parentBlockHash
string

Expected hash of the parent of the first requested block.

​
includeAllBlocks
boolean
default:false

If true, includes blocks with no matching data in the response.

​
fields
object

Field selector for data items to retrieve.

​
fills
object[]

Fill data requests. An empty object matches all fills; an empty array matches no fills.

Response

A stream of blocks in JSON lines format, optionally gzipped. Can be empty if the data query has a bounded range and all blocks in the range have been skipped. May include X-Sqd-Finalized-Head-Number and X-Sqd-Finalized-Head-Hash headers, indicating the latest finalized block that's on the same chain as the returned blocks.

​
header
object
required

Block header data. Fields are conditionally returned based on the fields.block parameter in the request. Only requested fields will be included in the response.

​
fills
object[]

Trade fill records contained in this block. Fields are conditionally returned based on the fields.fill parameter in the request.