curl --request GET \
--url https://api.hypedexer.com/fills/ \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hypedexer.com/fills/"
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/', 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/",
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/"
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/")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hypedexer.com/fills/")
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": "Fetched 2 fills (compact)",
"data": [
{
"user": "0xbe21f22f20e18ecaf7556a8e29bbd5114b7949c8",
"coin": "@256",
"coinMeaning": "@256",
"px": 0.020206,
"sz": 711.79,
"side": "B",
"time": "2026-09-18T00:04:59.960999",
"startPosition": 477.9099172,
"dir": "Buy",
"closedPnl": 0,
"hash": "0xf88c6b38bd36883dfa060444a28a69020256001e5839a7109c55168b7c3a6228",
"oid": 548310214365,
"tid": 1011741022583722,
"fee": 0.47832277,
"feeToken": "SEDA",
"typeTrade": "spot",
"isLiquidation": 0,
"liquidationRole": "none",
"liqMarkPx": null,
"liqMethod": null,
"liquidatedUser": null,
"notional": 14.382428739999998,
"priorityGas": null
},
{
"user": "0xbf66cb8b987fee1f6526bb6ee04345d36405f913",
"coin": "@256",
"coinMeaning": "@256",
"px": 0.020206,
"sz": 711.79,
"side": "A",
"time": "2026-09-18T00:04:59.960999",
"startPosition": 11282867.7634304,
"dir": "Sell",
"closedPnl": -1.04983943,
"hash": "0xf88c6b38bd36883dfa060444a28a69020256001e5839a7109c55168b7c3a6228",
"oid": 548309126284,
"tid": 1011741022583722,
"fee": 0.00287648,
"feeToken": "USDC",
"typeTrade": "spot",
"isLiquidation": 0,
"liquidationRole": "none",
"liqMarkPx": null,
"liqMethod": null,
"liquidatedUser": null,
"notional": 14.382428739999998,
"priorityGas": null
}
],
"total_count": 64891,
"execution_time_ms": 2017.83,
"next_cursor": "1789689899961:1011741022583722",
"has_more": true
}List fills (All = Spot + Perp)
Returns fills across Spot and Perp. Each fill includes priorityGas (priority fee paid, null if none) and block_number (Hyperliquid block number, null for older fills).
Order type (opt-in)
Set include_order_type=true to add exactly one field to each fill row:
orderType(string or null): the originating order’s type, resolved server-side from the order status by (user, oid). Observed values includeLimit,Market,Stop Market,Take Profit Limit; treat this as an open set, not a fixed enum.- With the default
include_order_type=falsethe response is byte-identical to before: the key is absent (not null), so existing integrations are unaffected. orderTypeisnullwhen the originating order status is unknown: orders placed before 2026-06-27 (start of order-status coverage), plus a small share of gaps in that dataset.- Cost: adds roughly tens of milliseconds per page of 1000 fills.
Example:
curl -X 'GET' \
'https://api.hypedexer.com/fills/?user=0x079f56bfd27f71cbd278c27c7b121e7ef180a5be&limit=1000&include_order_type=true' \
-H 'accept: application/json' \
-H 'X-API-Key: YOUR_API_KEY'
Each returned fill row gains exactly one field:
[
{ "...": "existing fill fields unchanged", "oid": 50583850248, "orderType": "Limit" },
{ "...": "existing fill fields unchanged", "oid": 31207118820, "orderType": null }
]
curl --request GET \
--url https://api.hypedexer.com/fills/ \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hypedexer.com/fills/"
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/', 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/",
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/"
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/")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hypedexer.com/fills/")
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": "Fetched 2 fills (compact)",
"data": [
{
"user": "0xbe21f22f20e18ecaf7556a8e29bbd5114b7949c8",
"coin": "@256",
"coinMeaning": "@256",
"px": 0.020206,
"sz": 711.79,
"side": "B",
"time": "2026-09-18T00:04:59.960999",
"startPosition": 477.9099172,
"dir": "Buy",
"closedPnl": 0,
"hash": "0xf88c6b38bd36883dfa060444a28a69020256001e5839a7109c55168b7c3a6228",
"oid": 548310214365,
"tid": 1011741022583722,
"fee": 0.47832277,
"feeToken": "SEDA",
"typeTrade": "spot",
"isLiquidation": 0,
"liquidationRole": "none",
"liqMarkPx": null,
"liqMethod": null,
"liquidatedUser": null,
"notional": 14.382428739999998,
"priorityGas": null
},
{
"user": "0xbf66cb8b987fee1f6526bb6ee04345d36405f913",
"coin": "@256",
"coinMeaning": "@256",
"px": 0.020206,
"sz": 711.79,
"side": "A",
"time": "2026-09-18T00:04:59.960999",
"startPosition": 11282867.7634304,
"dir": "Sell",
"closedPnl": -1.04983943,
"hash": "0xf88c6b38bd36883dfa060444a28a69020256001e5839a7109c55168b7c3a6228",
"oid": 548309126284,
"tid": 1011741022583722,
"fee": 0.00287648,
"feeToken": "USDC",
"typeTrade": "spot",
"isLiquidation": 0,
"liquidationRole": "none",
"liqMarkPx": null,
"liqMethod": null,
"liquidatedUser": null,
"notional": 14.382428739999998,
"priorityGas": null
}
],
"total_count": 64891,
"execution_time_ms": 2017.83,
"next_cursor": "1789689899961:1011741022583722",
"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
Query Parameters
User address
Coin symbol
Side (B=Buy, A=Sell)
B, A Minimum notional amount in USD
ISO 8601 UTC start time
ISO 8601 UTC end time
Max items to return
Pagination cursor (format: <time_ms>:<tid>)
Sort order
ASC, 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.