For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Field
Type
Description

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.

Response

Last updated