builderFillsByTime | Hyperliquid Info API
curl --request POST \
--url https://hypercore.goldrushdata.com/info \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "<string>",
"builder": "<string>",
"startTime": 123,
"endTime": 123,
"aggregateByTime": true,
"cursor": "<string>"
}
'import requests
url = "https://hypercore.goldrushdata.com/info"
payload = {
"type": "<string>",
"builder": "<string>",
"startTime": 123,
"endTime": 123,
"aggregateByTime": True,
"cursor": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
type: '<string>',
builder: '<string>',
startTime: 123,
endTime: 123,
aggregateByTime: true,
cursor: '<string>'
})
};
fetch('https://hypercore.goldrushdata.com/info', 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://hypercore.goldrushdata.com/info",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'type' => '<string>',
'builder' => '<string>',
'startTime' => 123,
'endTime' => 123,
'aggregateByTime' => true,
'cursor' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://hypercore.goldrushdata.com/info"
payload := strings.NewReader("{\n \"type\": \"<string>\",\n \"builder\": \"<string>\",\n \"startTime\": 123,\n \"endTime\": 123,\n \"aggregateByTime\": true,\n \"cursor\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://hypercore.goldrushdata.com/info")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"type\": \"<string>\",\n \"builder\": \"<string>\",\n \"startTime\": 123,\n \"endTime\": 123,\n \"aggregateByTime\": true,\n \"cursor\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://hypercore.goldrushdata.com/info")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"type\": \"<string>\",\n \"builder\": \"<string>\",\n \"startTime\": 123,\n \"endTime\": 123,\n \"aggregateByTime\": true,\n \"cursor\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"user": "<string>",
"coin": "<string>",
"px": "<string>",
"sz": "<string>",
"side": "<string>",
"time": 123,
"startPosition": "<string>",
"dir": "<string>",
"closedPnl": "<string>",
"hash": "<string>",
"oid": 123,
"tid": 123,
"crossed": true,
"fee": "<string>",
"feeToken": "<string>",
"builderFee": "<string>",
"cloid": "<string>",
"liquidation": {
"liquidatedUser": "<string>",
"markPx": "<string>",
"method": "<string>"
}
}Info API
builderFillsByTime | Hyperliquid Info API
Hyperliquid builderFillsByTime: fetch a builder’s attributed trade fills within a time window for revenue attribution and fee accounting.
POST
/
info
builderFillsByTime | Hyperliquid Info API
curl --request POST \
--url https://hypercore.goldrushdata.com/info \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "<string>",
"builder": "<string>",
"startTime": 123,
"endTime": 123,
"aggregateByTime": true,
"cursor": "<string>"
}
'import requests
url = "https://hypercore.goldrushdata.com/info"
payload = {
"type": "<string>",
"builder": "<string>",
"startTime": 123,
"endTime": 123,
"aggregateByTime": True,
"cursor": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
type: '<string>',
builder: '<string>',
startTime: 123,
endTime: 123,
aggregateByTime: true,
cursor: '<string>'
})
};
fetch('https://hypercore.goldrushdata.com/info', 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://hypercore.goldrushdata.com/info",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'type' => '<string>',
'builder' => '<string>',
'startTime' => 123,
'endTime' => 123,
'aggregateByTime' => true,
'cursor' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://hypercore.goldrushdata.com/info"
payload := strings.NewReader("{\n \"type\": \"<string>\",\n \"builder\": \"<string>\",\n \"startTime\": 123,\n \"endTime\": 123,\n \"aggregateByTime\": true,\n \"cursor\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://hypercore.goldrushdata.com/info")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"type\": \"<string>\",\n \"builder\": \"<string>\",\n \"startTime\": 123,\n \"endTime\": 123,\n \"aggregateByTime\": true,\n \"cursor\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://hypercore.goldrushdata.com/info")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"type\": \"<string>\",\n \"builder\": \"<string>\",\n \"startTime\": 123,\n \"endTime\": 123,\n \"aggregateByTime\": true,\n \"cursor\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"user": "<string>",
"coin": "<string>",
"px": "<string>",
"sz": "<string>",
"side": "<string>",
"time": 123,
"startPosition": "<string>",
"dir": "<string>",
"closedPnl": "<string>",
"hash": "<string>",
"oid": 123,
"tid": 123,
"crossed": true,
"fee": "<string>",
"feeToken": "<string>",
"builderFee": "<string>",
"cloid": "<string>",
"liquidation": {
"liquidatedUser": "<string>",
"markPx": "<string>",
"method": "<string>"
}
}Credit Cost
1 per call
Processing
Realtime
type: "builderFillsByTime" is used to fetch a builder’s attributed trade fills within a time window for revenue attribution and fee accounting.
Estimate your monthly cost for this API using the Pricing Calculator.
- GoldRush-native: No
POST api.hyperliquid.xyz/infoequivalent. Available only viaPOST hypercore.goldrushdata.com/info. - Each response contains at most 2,000 fills; widen the window in chunks or page by advancing
startTimeif you need more. - GoldRush serves this
typefrom a dedicated HyperCore historical store, so windows can extend back to GoldRush’s full HyperCore coverage. - Use
builderFills(noTimesuffix) when you only need the most recent N fills without specifying a window.
[startTime, endTime] window in milliseconds. Use this for builder revenue reports, monthly fee reconciliation, or rebuilding historical builder order-flow.
Builder-keyed. GoldRush-native as there is no upstream Hyperliquid /info equivalent. Served from a dedicated HyperCore historical store, so windows can extend back to GoldRush’s full HyperCore coverage.
Endpoint
POST https://hypercore.goldrushdata.com/info
Authorization: Bearer <GOLDRUSH_API_KEY>
Content-Type: application/json
Request
The builder address that orders were routed through. Must be a
0x-prefixed 42-character hex address.Unix timestamp in milliseconds. Inclusive lower bound. Required unless
cursor is supplied.Unix timestamp in milliseconds. Inclusive upper bound. Defaults to current server time when omitted.
When
true, partial fills sharing the same timestamp are consolidated into one row. Default false.Pagination cursor - a Unix timestamp in milliseconds encoded as a string. When set, returns fills strictly before this time and overrides
startTime. Use the time value of the oldest fill in the previous page to fetch the next page.Example
curl -X POST https://hypercore.goldrushdata.com/info \
-H "Authorization: Bearer $GOLDRUSH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "builderFillsByTime",
"builder": "0x0000000000000000000000000000000000000000",
"startTime": 1781000000000
}'
const response = await fetch("https://hypercore.goldrushdata.com/info", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.GOLDRUSH_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
type: "builderFillsByTime",
builder: "0x0000000000000000000000000000000000000000",
startTime: 1781000000000,
}),
});
const fills = await response.json();
import os, requests
response = requests.post(
"https://hypercore.goldrushdata.com/info",
headers={"Authorization": f"Bearer {os.environ['GOLDRUSH_API_KEY']}"},
json={
"type": "builderFillsByTime",
"builder": "0x0000000000000000000000000000000000000000",
"startTime": 1781000000000,
},
)
fills = response.json()
Response
An array of fill objects ordered bytime. Each entry is a fill from an order that was routed through the builder address within the window.
[
{
"user": "0x73f9c53a8b15e43056d5599f6488ac9a8730f85d",
"coin": "HYPE",
"px": "66.977",
"sz": "0.69",
"side": "B",
"time": 1781518798259,
"startPosition": "0",
"dir": "Open Long",
"closedPnl": "0",
"hash": "0x2b7bd2df9499dfef2cf5043dc500b402068500c52f9cfec1cf447e32539db9d9",
"oid": 469533808540,
"crossed": true,
"fee": "0.048524",
"tid": 332575399132451,
"feeToken": "USDC",
"builderFee": "0.027728",
"cloid": "0xff8ffaa775354e8faf1eaa18127d6b5e"
}
]
Field descriptions
All numeric fields (
px, sz, startPosition, closedPnl, fee, builderFee) are returned as decimal strings with full upstream precision (up to 18 decimal places). Do not parse them as floats - keep them as strings or use a fixed-precision decimal type.The trader’s wallet address - the account that placed the order routed through the builder code.
Asset symbol - e.g.
"BTC", "ETH" for perps; spot pairs use the @N form (e.g. "@107"); HIP-3 markets use the deployer-prefixed form.Human-readable direction label -
"Open Long", "Open Short", "Close Long", "Close Short", "Buy", "Sell", or position-flip labels "Long > Short" / "Short > Long".Realized PnL in USDC attributable to this fill for the trader (zero when the fill opens or extends a position).
Optional. Builder fee earned for this fill, denominated in
feeToken. Omitted when no builder fee was charged.Related endpoints
builderFills
fetch a builder’s most recent attributed trade fills for revenue attribution and order-flow analytics.
userFillsByTime
fetch a user’s trade fills within a time window for P&L recaps and tax ledger reconstruction.
userTwapSliceFillsByTime
fetch a user’s TWAP slice fills within a time window for execution-quality reconciliation on algorithmic orders.
userFills
fetch a user’s most recent trade fills without specifying a time window.
userTwapSliceFills
fetch a user’s most recent TWAP slice fills for execution-quality analytics on algorithmic orders.