curl --request GET \
--url https://api.hypedexer.com/fills/user/{user_address} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hypedexer.com/fills/user/{user_address}"
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.hypedexer.com/fills/user/{user_address}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hypedexer.com/fills/user/{user_address}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.hypedexer.com/fills/user/{user_address}"
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))
}HttpResponse<String> response = Unirest.get("https://api.hypedexer.com/fills/user/{user_address}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hypedexer.com/fills/user/{user_address}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Fills for user 0x010461c1... (compact)",
"data": [
{
"user": "0x010461c14e146ac35fe42271bdc1134ee31c703a",
"coin": "OP",
"coinMeaning": "OP",
"px": 0.10127,
"sz": 3944.5,
"side": "B",
"startPosition": -597650.1,
"time": "2026-09-18 00:04:59.759000",
"tid": 152988313348231,
"oid": 548310212171,
"hash": "0x1357b13d54c29f9f14d10444a28a660202860022efc5be71b7205c9013c67989",
"fee": 0,
"feeToken": "USDC",
"typeTrade": "perp",
"isLiquidation": 0,
"liquidationRole": "none",
"liqMarkPx": null,
"liqMethod": null,
"liquidatedUser": null,
"notional": 399.459515,
"priorityGas": null
},
{
"user": "0x010461c14e146ac35fe42271bdc1134ee31c703a",
"coin": "USELESS",
"coinMeaning": "USELESS",
"px": 0.2646,
"sz": 125,
"side": "B",
"startPosition": -175430,
"time": "2026-09-18 00:04:59.356000",
"tid": 339668818780777,
"oid": 548310191721,
"hash": "0x4cab9b37844e358c4e250444a28a600202dc001d1f41545ef074468a43420f76",
"fee": 0,
"feeToken": "USDC",
"typeTrade": "perp",
"isLiquidation": 0,
"liquidationRole": "none",
"liqMarkPx": null,
"liqMethod": null,
"liquidatedUser": null,
"notional": 33.075,
"priorityGas": null
}
],
"total_count": 924,
"execution_time_ms": 0.76,
"next_cursor": "1789689899356:339668818780777",
"has_more": true
}User fills (All = Spot + Perp)
Returns user fills. Each fill includes priorityGas (priority fee paid, null if none) and block_number (Hyperliquid block number, null for older fills). By default, only recent data (from March 2025 onward) is available. Historical data prior to March 2025 is exclusively available on Scale & Enterprise plans via the start_time / end_time parameters. This is currently the only endpoint supporting pre-March historical access.
Order type (opt-in): set include_order_type=true to add orderType (string or null) to each fill: the originating order’s type (Limit, Market, Stop Market, Take Profit Limit, …: open set), resolved server-side from the order status by (user, oid). See GET /fills/ for full semantics. Default false leaves the response byte-identical (key absent). orderType is null for orders placed before 2026-06-27 (start of order-status coverage) or when the order status is unknown. Adds roughly tens of milliseconds per page of 1000 fills.
curl --request GET \
--url https://api.hypedexer.com/fills/user/{user_address} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hypedexer.com/fills/user/{user_address}"
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.hypedexer.com/fills/user/{user_address}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hypedexer.com/fills/user/{user_address}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.hypedexer.com/fills/user/{user_address}"
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))
}HttpResponse<String> response = Unirest.get("https://api.hypedexer.com/fills/user/{user_address}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hypedexer.com/fills/user/{user_address}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Fills for user 0x010461c1... (compact)",
"data": [
{
"user": "0x010461c14e146ac35fe42271bdc1134ee31c703a",
"coin": "OP",
"coinMeaning": "OP",
"px": 0.10127,
"sz": 3944.5,
"side": "B",
"startPosition": -597650.1,
"time": "2026-09-18 00:04:59.759000",
"tid": 152988313348231,
"oid": 548310212171,
"hash": "0x1357b13d54c29f9f14d10444a28a660202860022efc5be71b7205c9013c67989",
"fee": 0,
"feeToken": "USDC",
"typeTrade": "perp",
"isLiquidation": 0,
"liquidationRole": "none",
"liqMarkPx": null,
"liqMethod": null,
"liquidatedUser": null,
"notional": 399.459515,
"priorityGas": null
},
{
"user": "0x010461c14e146ac35fe42271bdc1134ee31c703a",
"coin": "USELESS",
"coinMeaning": "USELESS",
"px": 0.2646,
"sz": 125,
"side": "B",
"startPosition": -175430,
"time": "2026-09-18 00:04:59.356000",
"tid": 339668818780777,
"oid": 548310191721,
"hash": "0x4cab9b37844e358c4e250444a28a600202dc001d1f41545ef074468a43420f76",
"fee": 0,
"feeToken": "USDC",
"typeTrade": "perp",
"isLiquidation": 0,
"liquidationRole": "none",
"liqMarkPx": null,
"liqMethod": null,
"liquidatedUser": null,
"notional": 33.075,
"priorityGas": null
}
],
"total_count": 924,
"execution_time_ms": 0.76,
"next_cursor": "1789689899356:339668818780777",
"has_more": true
}Authorizations
Your Hypedexer API key. Create one in the console at https://app.hypedexer.com. Authorization: Bearer <key> and the api_key query parameter are accepted as well.
Headers
Path Parameters
^0x[0-9a-fA-F]{40}$Query Parameters
Preset time range
1h, 24h, 7d, 30d Start time (ISO UTC). Required for Scale/Enterprise historical access. Overrides time_range.
End time (ISO UTC). Defaults to now if start_time is set.
Max results (cap 10000)
1 <= x <= 10000ASC, DESC Filter by priority gas: true = only fills with priorityGas > 0, false = only fills without, omit = no filter.
Set to true to add orderType to each fill: the originating order's type (e.g. Limit, Market, Stop Market, Take Profit Limit), resolved server-side from the order status by (user, oid); null when unknown. Default false: response unchanged, key absent.