Skip to main content
POST
Indexed fills (compact shape)

Authorizations

Authorization
string
header
required

Your Hypedexer API key, sent as Authorization: Bearer <key>. The X-API-Key: <key> header and the api_key query parameter are accepted as well.

Body

application/json
type
enum<string>
required
Available options:
fills
market
enum<string>
Available options:
perp,
spot,
hip3
user
string
coin
string
coins
string[]

Several coins (spot only)

dexId
string

HIP-3 dex id (hip3 only)

side
enum<string>
Available options:
A,
B
sizeUsd
number

Minimum notional in USD

Required range: x >= 0
startTime
integer

Epoch ms, inclusive

endTime
integer

Epoch ms, inclusive

timeRange
enum<string>
Available options:
1h,
24h,
7d,
30d
offset
integer
default:0
Required range: x >= 0
limit
integer
default:100
Required range: 1 <= x <= 5000
cursor
string

X-Next-Cursor of the previous page (perp only)

order
enum<string>
default:DESC
Available options:
ASC,
DESC
hasPriorityGas
boolean

Response

Fills

user
string
coin
string
coinMeaning
string

Human-readable market name (spot pairs, HIP-3)

px
number
sz
number
side
enum<string>
Available options:
A,
B
time
string

ISO 8601 UTC, exact millisecond (2026-09-25T12:39:48.007000)

startPosition
number
dir
string
closedPnl
number
hash
string
oid
integer
tid
integer
crossed
enum<integer>

1 = taker. Reliable on fills stored since 2026-09-24 15:53 UTC

Available options:
0,
1
cloid
string | null
fee
number

Trading fee, builder fee excluded

feeToken
string
typeTrade
enum<string>
Available options:
perp,
spot,
hip3
isLiquidation
integer
liquidationRole
string
liqMarkPx
number | null
liqMethod
string | null
liquidatedUser
string | null
notional
number
priorityGas
number | null
twapId
integer | null

Parent TWAP id; null = ordinary fill

builderFee
number | null

Separate from fee

builder
string | null