builderFills

Get the 2000 latest fills submitted by a builder.

Data available from 28-07-2025

POST Request

Field	Type	Description
type	string	Must be "builderFills"
builder	string	Ethereum address (0x-prefixed, 42 characters)
venue	string	Only fills on outcome markets deployed by this permissionless venue, e.g. "skew". 2–4 ASCII letters, case-insensitive; an unknown venue returns an empty list (optional)
limit	integer	Max results to return, default and max 2000 (optional)

cURL

curl -X POST https://api.hydromancer.xyz/info \
  -H "Authorization: Bearer $HYDROMANCER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "builderFills",
    "builder": "0x0000000000000000000000000000000000000000"
  }'

Python

import requests
import os

response = requests.post(
    'https://api.hydromancer.xyz/info',
    json={
        'type': 'builderFills',
        'builder': '0x0000000000000000000000000000000000000000'
    },
    headers={
        'Authorization': f'Bearer {os.environ.get("HYDROMANCER_API_KEY")}',
        'Content-Type': 'application/json'
    }
)

print(response.json())

Javascript

import axios from 'axios';

try {
    const response = await axios.post('https://api.hydromancer.xyz/info', {
        type: 'builderFills',
        builder: '0x0000000000000000000000000000000000000000'
    }, {
        headers: {
            'Authorization': `Bearer ${process.env.HYDROMANCER_API_KEY}`,
            'Content-Type': 'application/json'
        }
    });

    console.log(response.data);
} catch (error) {
    console.error('Error:', error.message);
}

---

Response Fields

Field	Type	Description
coin	string	Asset symbol
px	string	Fill price
sz	string	Fill size
side	string	"A" (sell) or "B" (buy)
time	int	Fill timestamp (ms)
startPosition	string	Position size before the fill
dir	string	Direction (e.g. "Open Long", "Open Short", "Short > Long")
closedPnl	string	Closed PnL from this fill
hash	string	Transaction hash
oid	int	Order ID
crossed	boolean	Whether the order crossed the spread
fee	string	Fee amount
tid	int	Trade ID
builderFee	string	Builder fee
deployerFee	string?	Deployer fee (HIP-3 fills only)
priorityGas	string?	Priority gas fee in HYPE (optional)
feeToken	string	Fee token (e.g. "USDC")
user	string	User address who placed the order
twapId	int	TWAP order ID (null if not a TWAP fill)
cloid	string?	Client order ID (optional)
txIndex	int	Transaction index
venue	string?	HIP-4 venue of an outcome (#NNNN) market, e.g. "out". Omitted for validator-deployed outcomes and all other coins

Response

[
  {
    "coin": "BTC",
    "px": "71070.00",
    "sz": "0.00541",
    "side": "A",
    "time": 1773429781878,
    "startPosition": "0.00",
    "dir": "Open Short",
    "closedPnl": "0.00",
    "hash": "0xa33ab861b80567f1a4b40436ff72410204530047530886c3470363b4770941dc",
    "oid": 348153004784,
    "crossed": true,
    "fee": "0.211467",
    "tid": 491098859095794,
    "builderFee": "0.038448",
    "deployerFee": "0.019224",
    "priorityGas": null,
    "feeToken": "USDC",
    "user": "0x5e24ba0e5753fb533e8ac74c63f00fa73488c484",
    "twapId": null,
    "txIndex": 21
  }
]