Skip to main content
GET
List fills

Authorizations

Authorization
string
header
required

Ironflow API key, format if_xxxx. Free keys at https://ironflow.sh/key. Optional on read endpoints.

Query Parameters

source
enum<string>
default:hyperliquid

Venue identifier. Defaults to hyperliquid.

Available options:
hyperliquid
address
string
required

Wallet address to query fills for.

Example:

"0xabc123def456"

market
string

Market symbol (e.g. BTC-PERP, ETH-PERP). Omit to query all markets.

Example:

"BTC-PERP"

base_market
string

Base market symbol, stripped of any issuer namespace (e.g. GAS-PERP). Matches both native HL markets (market == base_market) and every HIP-3 builder-deployed market with that base (e.g. flx:GAS-PERP). Use together with issuer to scope to a single builder, or alone to query across all issuers of the same base symbol.

Example:

"GAS-PERP"

issuer
string

HIP-3 builder/issuer namespace (e.g. flx). For native HL perps the issuer is the empty string; do not combine issuer="" with this filter — omit the parameter instead. Commonly paired with base_market to disambiguate a builder-deployed market from its native counterpart.

Example:

"flx"

from
integer<int64>

Start time as Unix milliseconds. Defaults to 24 hours ago. Clamped to tier history window. On /v1/trades and /v1/fills, the time range (to - from) is limited per tier (no key 1h, free key 6h, Explorer 24h, Builder 7d, Enterprise unlimited; without market filter 4h for all tiers). Returns QUERY_WINDOW_EXCEEDED (400) if exceeded — paginate with narrower from/to windows.

Example:

1718313600000

to
integer<int64>

End time as Unix milliseconds. Defaults to now.

Example:

1718400000000

limit
integer
default:100

Maximum number of results per page. Default 100, max 1000.

Required range: x <= 1000
Example:

100

cursor
string

Opaque pagination cursor from pagination.next_cursor in a previous response.

Example:

"MTcxODQwMDAwMDAwMC00Mg=="

Response

Paginated list of fills.

data
object[]
required
pagination
object
required