Skip to main content
GET
https://api.0xarchive.io
/
v1
/
hyperliquid
/
hip3
/
trades
/
{symbol}
/
recent
Get recent HIP-3 trades
curl --request GET \
  --url https://api.0xarchive.io/v1/hyperliquid/hip3/trades/{symbol}/recent \
  --header 'X-API-Key: <api-key>'
import requests

url = "https://api.0xarchive.io/v1/hyperliquid/hip3/trades/{symbol}/recent"

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/hip3/trades/{symbol}/recent', 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/hip3/trades/{symbol}/recent"

	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": [
    {
      "symbol": "BTC",
      "coin": "BTC",
      "side": "B",
      "price": "42150.50",
      "size": "0.5",
      "timestamp": "2025-01-21T10:30:45.123Z",
      "tx_hash": "<string>",
      "trade_id": 123,
      "order_id": 123,
      "crossed": true,
      "fee": "<string>",
      "fee_token": "<string>",
      "closed_pnl": "<string>",
      "direction": "<string>",
      "start_position": "<string>",
      "user_address": "<string>",
      "maker_address": "<string>",
      "taker_address": "<string>",
      "builder_address": "<string>",
      "builder_fee": "<string>",
      "deployer_fee": "<string>",
      "priority_gas": 123,
      "cloid": "<string>",
      "twap_id": 123
    }
  ],
  "meta": {
    "count": 123,
    "next_cursor": "<string>",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}
{
  "code": 400,
  "error": "Invalid request parameters"
}
{
  "code": 401,
  "error": "Missing or invalid API key. Provide X-API-Key header."
}
{
  "code": 429,
  "error": "Rate limit exceeded"
}

Authorizations

X-API-Key
string
header
required

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

Path Parameters

symbol
string
required

Trading pair symbol (e.g., km:US500, xyz:XYZ100). HIP-3 symbols are case-sensitive.

Example:

"xyz:XYZ100"

Query Parameters

limit
integer
default:100

Number of trades to return (default: 100, max: 1000)

Required range: x <= 1000

Response

List of recent trades

success
boolean
Example:

true

data
object[]
meta
object

Response metadata

Last modified on July 7, 2026