fillsByTime
Market-wide fills of the last 24 hours, by time, optionally filtered by coin.
This endpoint is for market-specific fills. For user-specific fills, use userFillsByTime.
POST Request
type
string
Required. "fillsByTime"
startTime
number
Required unless cursor is given. Inclusive, milliseconds. A value older than 24 hours is moved forward to 24 hours ago.
endTime
number
Optional. Inclusive, milliseconds. Default: now.
cursor
string
Optional. Continue from a previous page. Format "{time}_{txIndex}". A cursor older than 24 hours resumes at 24 hours ago.
coin
string
Optional. Only fills on this coin, e.g. "BTC", "xyz:GOLD", "@107", "#40080".
dex
string
Optional. "main_dex" or a HIP-3 dex such as "xyz".
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
number
Optional. Default and maximum 2000.
Results are returned oldest-first, ordered by (time, txIndex). A range that lies entirely before the last 24 hours returns an empty list.
curl -X POST https://api.hydromancer.xyz/info \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
"type": "fillsByTime",
"coin": "BTC",
"startTime": 1786000000000,
"limit": 100
}'import requests
resp = requests.post(
"https://api.hydromancer.xyz/info",
headers={"X-API-Key": "YOUR_API_KEY"},
json={
"type": "fillsByTime",
"coin": "BTC",
"startTime": 1786000000000,
"limit": 100,
},
)
fills = resp.json()Pagination
Take the last returned fill and build cursor as "{time}_{txIndex}", then repeat the request with that cursor instead of startTime. A page shorter than limit means you have reached the end of the range.
At the busiest hours the market produces about 300 fills a second, so a 2000-fill page covers only a few seconds. Filter by coin when you can.
Response Fields
An array of fill objects, each including the user that made the fill. The builder field is the builder the fill was routed through, null when there was none.
Last updated