Get HIP-4 L4 orderbook history

curl --request GET \
  --url https://api.0xarchive.io/v1/hyperliquid/hip4/orderbook/{symbol}/l4/history \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.0xarchive.io/v1/hyperliquid/hip4/orderbook/{symbol}/l4/history"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.0xarchive.io/v1/hyperliquid/hip4/orderbook/{symbol}/l4/history', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.0xarchive.io/v1/hyperliquid/hip4/orderbook/{symbol}/l4/history"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "success": true,
  "data": [
    {
      "coin": "BTC",
      "timestamp": "2026-03-12T00:00:00.000Z",
      "checkpoint_timestamp": "2026-03-12T00:00:00.000Z",
      "diffs_applied": 0,
      "last_block_number": 1023882395,
      "bids": [
        {
          "oid": 18499128731,
          "user_address": "0x0000000000000000000000000000000000000000",
          "side": "B",
          "price": 105384.5,
          "size": 0.824,
          "timestamp": 1773273600123
        }
      ],
      "asks": [
        {
          "oid": 18499128731,
          "user_address": "0x0000000000000000000000000000000000000000",
          "side": "B",
          "price": 105384.5,
          "size": 0.824,
          "timestamp": 1773273600123
        }
      ],
      "bid_count": 12,
      "ask_count": 15,
      "total_bid_size": 102.34,
      "total_ask_size": 98.76,
      "is_crossed": true
    }
  ],
  "meta": {
    "count": 123,
    "next_cursor": "<string>",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "coverage_from": "2023-11-07T05:31:56Z",
    "notice": "<string>"
  }
}

{
  "code": 400,
  "error": "Failed to deserialize query string: limit: invalid digit found in string",
  "error_code": "invalid_query_params",
  "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05"
}

{
  "code": 401,
  "error": "Missing or invalid API key. Provide X-API-Key header."
}

{
  "code": 429,
  "error": "Rate limit exceeded"
}

GET

https://api.0xarchive.io

hyperliquid

hip4

orderbook

{symbol}

history

Get HIP-4 L4 orderbook history

curl --request GET \
  --url https://api.0xarchive.io/v1/hyperliquid/hip4/orderbook/{symbol}/l4/history \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.0xarchive.io/v1/hyperliquid/hip4/orderbook/{symbol}/l4/history"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.0xarchive.io/v1/hyperliquid/hip4/orderbook/{symbol}/l4/history', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.0xarchive.io/v1/hyperliquid/hip4/orderbook/{symbol}/l4/history"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "success": true,
  "data": [
    {
      "coin": "BTC",
      "timestamp": "2026-03-12T00:00:00.000Z",
      "checkpoint_timestamp": "2026-03-12T00:00:00.000Z",
      "diffs_applied": 0,
      "last_block_number": 1023882395,
      "bids": [
        {
          "oid": 18499128731,
          "user_address": "0x0000000000000000000000000000000000000000",
          "side": "B",
          "price": 105384.5,
          "size": 0.824,
          "timestamp": 1773273600123
        }
      ],
      "asks": [
        {
          "oid": 18499128731,
          "user_address": "0x0000000000000000000000000000000000000000",
          "side": "B",
          "price": 105384.5,
          "size": 0.824,
          "timestamp": 1773273600123
        }
      ],
      "bid_count": 12,
      "ask_count": 15,
      "total_bid_size": 102.34,
      "total_ask_size": 98.76,
      "is_crossed": true
    }
  ],
  "meta": {
    "count": 123,
    "next_cursor": "<string>",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "coverage_from": "2023-11-07T05:31:56Z",
    "notice": "<string>"
  }
}

{
  "code": 400,
  "error": "Failed to deserialize query string: limit: invalid digit found in string",
  "error_code": "invalid_query_params",
  "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05"
}

{
  "code": 401,
  "error": "Missing or invalid API key. Provide X-API-Key header."
}

{
  "code": 429,
  "error": "Rate limit exceeded"
}

API key required. Send X-API-Key with this request. See REST authentication.

Shared request rules

Machine schema

Open the generated operation schema for machine-readable request and response details.

Authorizations

X-API-Key

string

header

required

API key for authentication. Get yours at https://0xarchive.io/dashboard

Path Parameters

symbol

string

required

HIP-4 coin id (e.g., 0 for outcome 0 Yes side, 1 for No side). The #-prefixed form (#0, #1) is also accepted.

Example:

"0"

Query Parameters

start

integer<int64>

Start of the requested window as a Unix timestamp in milliseconds. ISO 8601 strings are rejected.

Example:

1777680000000

end

integer<int64>

End of the requested window as a Unix timestamp in milliseconds. ISO 8601 strings are rejected.

Example:

1777766400000

cursor

integer<int64>

Timestamp cursor in Unix milliseconds from the previous response metadata.

limit

integer<int64>

default:100

Maximum number of results (default: 100, max: 1000)

Required range: x <= 1000

Response

Typed L4 orderbook checkpoint array

success

boolean

required

Example:

true

data

object[]

required

Hide child attributes

data.coin

string

required

Trading pair or market symbol.

Example:

"BTC"

data.timestamp

string<date-time>

required

Snapshot timestamp in UTC.

Example:

"2026-03-12T00:00:00.000Z"

data.checkpoint_timestamp

string<date-time>

required

Timestamp of the checkpoint used for this snapshot.

Example:

"2026-03-12T00:00:00.000Z"

data.diffs_applied

integer

required

Number of L4 diffs applied after the checkpoint.

Example:

0

data.last_block_number

integer<int64>

required

Last Hyperliquid block represented by this snapshot.

Example:

1023882395

data.bids

object[]

required

Bid-side resting orders, best price first.

Hide child attributes

data.bids.oid

integer<int64>

required

Hyperliquid order identifier.

Example:

18499128731

data.bids.user_address

string

required

Address attributed to the resting order.

Example:

"0x0000000000000000000000000000000000000000"

data.bids.side

enum<string>

required

Book side: B for bid or A for ask.

Available options:

B,

A

Example:

"B"

data.bids.price

number

required

Venue-native resting order price.

Example:

105384.5

data.bids.size

number

required

Venue-native remaining order size.

Example:

0.824

data.bids.timestamp

integer<int64>

required

Queue-join timestamp in Unix epoch milliseconds; 0 when unknown.

Example:

1773273600123

data.asks

object[]

required

Ask-side resting orders, best price first.

Hide child attributes

data.asks.oid

integer<int64>

required

Hyperliquid order identifier.

Example:

18499128731

data.asks.user_address

string

required

Address attributed to the resting order.

Example:

"0x0000000000000000000000000000000000000000"

data.asks.side

enum<string>

required

Book side: B for bid or A for ask.

Available options:

B,

A

Example:

"B"

data.asks.price

number

required

Venue-native resting order price.

Example:

105384.5

data.asks.size

number

required

Venue-native remaining order size.

Example:

0.824

data.asks.timestamp

integer<int64>

required

Queue-join timestamp in Unix epoch milliseconds; 0 when unknown.

Example:

1773273600123

data.bid_count

integer

required

Number of bid orders in the full stored/reconstructed checkpoint before optional depth truncates returned bids/asks.

Example:

12

data.ask_count

integer

required

Number of ask orders in the full stored/reconstructed checkpoint before optional depth truncates returned bids/asks.

Example:

15

data.total_bid_size

number

required

Aggregate venue-native bid size in the full stored/reconstructed checkpoint before optional depth truncates returned bids/asks.

Example:

102.34

data.total_ask_size

number

required

Aggregate venue-native ask size in the full stored/reconstructed checkpoint before optional depth truncates returned bids/asks.

Example:

98.76

data.is_crossed

boolean

True only when a reconstructed historical book has best bid greater than or equal to best ask; omitted for clean snapshots.

Example:

true

API reference

SDKs & tooling

AI & agents

Get HIP-4 L4 orderbook history

Authorizations

Path Parameters

Query Parameters

Response