Get Hyperliquid trade intent

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

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

fetch('https://api.0xarchive.io/v1/hyperliquid/trade-intent/{symbol}', 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/trade-intent/{symbol}"

	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": [
    {
      "timestamp": "2026-10-23T00:00:00.000Z",
      "timestamp_ms": 1792713600000,
      "close": 81448,
      "price_source": "mark",
      "open_long": 50638693.18,
      "open_short": 41296459.21,
      "tp_long": 8084342.05,
      "tp_short": 29240753.02,
      "stop_long": 30236676.09,
      "stop_short": 12304052.04,
      "flip_ls": 683012.29,
      "flip_sl": 334456.02,
      "mm_usd": 84960401.5,
      "winners_flow": -2861558.86,
      "losers_flow": -607408.26,
      "winners_net": -77011655.75,
      "winners_gross": 121926882.58,
      "losers_net": 46895101.67,
      "losers_gross": 155965344.67,
      "winners_count": 17,
      "losers_count": 16,
      "quality": "ok",
      "is_final": true,
      "preliminary": false,
      "preliminary_from": null,
      "preliminary_from_ms": null,
      "method": "who/3"
    }
  ],
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "count": 123,
    "has_more": true,
    "next_cursor": "<string>",
    "symbol": "BTC",
    "venue": "hyperliquid",
    "coverage_from": "2023-11-07T05:31:56Z",
    "notice": "<string>",
    "finalized_through": "2023-11-07T05:31:56Z",
    "requested_end": "2023-11-07T05:31:56Z",
    "clamped_to": "2023-11-07T05:31:56Z",
    "preliminary_row_count": 123,
    "built_through": "2023-11-07T05:31:56Z",
    "as_of": "2023-11-07T05:31:56Z"
  }
}

GET

https://api.0xarchive.io

hyperliquid

trade-intent

{symbol}

Get Hyperliquid trade intent

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

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

fetch('https://api.0xarchive.io/v1/hyperliquid/trade-intent/{symbol}', 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/trade-intent/{symbol}"

	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": [
    {
      "timestamp": "2026-10-23T00:00:00.000Z",
      "timestamp_ms": 1792713600000,
      "close": 81448,
      "price_source": "mark",
      "open_long": 50638693.18,
      "open_short": 41296459.21,
      "tp_long": 8084342.05,
      "tp_short": 29240753.02,
      "stop_long": 30236676.09,
      "stop_short": 12304052.04,
      "flip_ls": 683012.29,
      "flip_sl": 334456.02,
      "mm_usd": 84960401.5,
      "winners_flow": -2861558.86,
      "losers_flow": -607408.26,
      "winners_net": -77011655.75,
      "winners_gross": 121926882.58,
      "losers_net": 46895101.67,
      "losers_gross": 155965344.67,
      "winners_count": 17,
      "losers_count": 16,
      "quality": "ok",
      "is_final": true,
      "preliminary": false,
      "preliminary_from": null,
      "preliminary_from_ms": null,
      "method": "who/3"
    }
  ],
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "count": 123,
    "has_more": true,
    "next_cursor": "<string>",
    "symbol": "BTC",
    "venue": "hyperliquid",
    "coverage_from": "2023-11-07T05:31:56Z",
    "notice": "<string>",
    "finalized_through": "2023-11-07T05:31:56Z",
    "requested_end": "2023-11-07T05:31:56Z",
    "clamped_to": "2023-11-07T05:31:56Z",
    "preliminary_row_count": 123,
    "built_through": "2023-11-07T05:31:56Z",
    "as_of": "2023-11-07T05:31:56Z"
  }
}

Operation schema · Trade intent buckets and coverage

Authorizations

X-API-Key

string

header

required

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

Headers

0xArchive-Version

enum<string>

Selects the 2026-10 response contract. Send 2026-10-01; any dated version on or after it selects the same shapes. Without the header every response keeps its existing shape. With it:

The data quality routes, /v1/status/coverage and /v1/symbols answer the standard {success, data, meta} envelope.
Record times that are integer milliseconds by default become RFC 3339 UTC strings with millisecond precision, and the integer moves to a *_ms field: L4 resting-order timestamp (timestamp_ms), CVD buckets, HIP-3 oracle reads, Lighter and Lighter on Robinhood Chain liquidations and liquidation volume. Levels and trigger-levels snapshot_ts become RFC 3339 with snapshot_ts_ms.
Error bodies carry the contract error_code names: invalid_parameter instead of invalid_query_params and invalid_path_params, historical_depth_exceeded instead of history_window_exceeded, and historical_range_exceeded instead of request_range_exceeded; a malformed cursor that fails to parse answers 400 invalid_cursor instead of invalid_query_params. With 0xArchive-Version: 2026-10-01, malformed cursors on trades, liquidations, L2 and L4 diffs, order history, TP/SL and order-flow routes answer 400 invalid_cursor. Without the header, the first six route families treat a malformed cursor as no cursor and return the first page; order flow answers 400 invalid_query_params. Malformed trade time inputs answer 400 invalid_time_range with the header and 400 invalid_query_params without it.

The response echoes the selected version in its own 0xArchive-Version header.

Available options:

2026-10-01

Example:

"2026-10-01"

Path Parameters

symbol

string

required

Hyperliquid core perp symbol (e.g., BTC, ETH).

Example:

"BTC"

Query Parameters

start

Start of the window, inclusive. Defaults to 24 hours before end, so set it explicitly when paging: the default moves with the clock. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z. An instant: Unix milliseconds, or an RFC 3339 string such as 2026-01-01T00:00:00Z (encode a + offset as %2B). An unparsable value answers 400 invalid_time_range.

Example:

1767225600000

end

End of the window, inclusive. Defaults to now. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z. An instant: Unix milliseconds, or an RFC 3339 string such as 2026-01-01T00:00:00Z (encode a + offset as %2B). An unparsable value answers 400 invalid_time_range.

Example:

1767225600000

interval

enum<string>

default:1h

Bucket width (default: 1h), on UTC epoch boundaries. Each family has its own coverage: see the description.

Available options:

1s,

5s,

15s,

1m,

5m,

15m,

1h,

4h,

1d

cursor

string

Opaque pagination cursor: pass meta.next_cursor from the previous page unchanged, with the same filters. Omit it for the first page. It is the next page's first bucket open.

limit

integer

default:500

Buckets per page (default: 500, max: 2,000). A larger value is read as 2,000.

Required range: x <= 2000

Response

Trade intent buckets

API response containing trade intent buckets. meta carries symbol, venue, built_through, and preliminary_row_count when preliminary buckets are present.

success

boolean

Example:

true

data

object[]

Hide child attributes

data.timestamp

string<date-time>

required

Bucket open time, RFC 3339 UTC.

Example:

"2026-10-23T00:00:00.000Z"

data.timestamp_ms

integer<int64>

required

timestamp as Unix milliseconds.

Example:

1792713600000

data.close

number<double> | null

required

The price the bucket's end is marked at. Null on second intervals.

Example:

81448

data.price_source

enum<string> | null

required

Where close comes from: mark, oracle (a HIP-3 market without a stored mark), carried (the last of those when none is recent) or trade. Null on second intervals.

Available options:

mark,

oracle,

carried,

trade

Example:

"mark"

data.open_long

number<double>

required

USD bought to open or increase a long. To the cent.

Example:

50638693.18

data.open_short

number<double>

required

USD sold to open or increase a short. To the cent.

Example:

41296459.21

data.tp_long

number<double>

required

USD sold to reduce or close a long at a profit (closed PnL above zero, not forced). To the cent.

Example:

8084342.05

data.tp_short

number<double>

required

USD bought to reduce or close a short at a profit (closed PnL above zero, not forced). To the cent.

Example:

29240753.02

data.stop_long

number<double>

required

USD sold to reduce or close a long at a loss or break-even, or by liquidation or auto-deleveraging. To the cent.

Example:

30236676.09

data.stop_short

number<double>

required

USD bought to reduce or close a short at a loss or break-even, or by liquidation or auto-deleveraging. To the cent.

Example:

12304052.04

data.flip_ls

number<double>

required

USD sold that took a position from long to short in one fill. To the cent.

Example:

683012.29

data.flip_sl

number<double>

required

USD bought that took a position from short to long in one fill. To the cent.

Example:

334456.02

data.mm_usd

number<double>

required

USD traded by wallets classified as market makers, counted here instead of in an intent bucket. To the cent.

Example:

84960401.5

data.winners_flow

number<double> | null

required

What the market's winners bought less what they sold in the bucket, in USD, weighted as the cohort stood at the previous hour's close. Null when quality is quarantined.

Example:

-2861558.86

data.losers_flow

number<double> | null

required

The same for the market's losers.

Example:

-607408.26

data.winners_net

number<double> | null

required

The winners' net position in USD (long positive) at the bucket's end. Null on second intervals and when quality is quarantined.

Example:

-77011655.75

data.winners_gross

number<double> | null

required

The winners' gross position in USD at the bucket's end. Null on second intervals and when quality is quarantined.

Example:

121926882.58

data.losers_net

number<double> | null

required

The losers' net position in USD at the bucket's end. Null on second intervals and when quality is quarantined.

Example:

46895101.67

data.losers_gross

number<double> | null

required

The losers' gross position in USD at the bucket's end. Null on second intervals and when quality is quarantined.

Example:

155965344.67

data.winners_count

integer | null

required

Winners counted at full weight. Null on second intervals and when quality is quarantined.

Example:

17

data.losers_count

integer | null

required

Losers counted at full weight. Null on second intervals and when quality is quarantined.

Example:

16

data.quality

enum<string>

required

ok; partial while the method's 7-day lookbacks were not yet full; quarantined when an input of the bucket failed a continuity check, so the winners' and losers' figures are null. Intent buckets and mm_usd are always served.

Available options:

ok,

partial,

quarantined

Example:

"ok"

data.is_final

boolean

required

The bucket is complete and will not change.

Example:

true

data.preliminary

boolean

required

The bucket holds figures computed live after the archive's end. They are replaced by the archived figures once those hours are built.

Example:

false

data.preliminary_from

string<date-time> | null

required

Where the bucket's preliminary figures begin: inside the bucket, or at its open when the whole bucket is preliminary. Null when preliminary is false.

Example:

null

data.preliminary_from_ms

integer<int64> | null

required

preliminary_from as Unix milliseconds.

Example:

null

data.method

string

required

Version of the method the bucket was computed with: who/3, or who/2 on older rows.

Example:

"who/3"

Endpoint reference

Requests and responses

Datasets

Venues

OpenAPI and schemas

Guides

Get Hyperliquid trade intent

Authorizations

Headers

Path Parameters

Query Parameters

Response