Skip to main content
GET
Get bulk order fills

Authorizations

Authorization
string
header
required

Bearer token from Geomi. See Authentication for setup instructions.

Query Parameters

account
string
required

User account address (user query alias is also accepted)

market
string

Filter by one concrete market address. Use all to disable market filtering.

sequence_number
integer<int64>

Single sequence number to query.

Required range: x >= 0
start_sequence_number
integer<int64>

Start of sequence number range.

Required range: x >= 0
end_sequence_number
integer<int64>

End of sequence number range.

Required range: x >= 0
asset_type
enum<string>

Optional asset_type filter: "perp" | "spot". Discriminator carried on DTOs that can mix perp and spot rows (markets, orders, trades, bulk orders, bulk order fills, and WebSocket payloads). Also accepted as a query parameter on REST endpoints that can filter to one product.

Wire format is lowercase ("perp" / "spot") and accepted case-insensitively on the request side via [impl_case_insensitive_deserialize].

Available options:
perp,
spot
limit
integer<int32>
default:10

Effective page size (clamped to 1..=1000 at runtime)

Required range: 1 <= x <= 1000
offset
integer<int32>
default:0

Page offset

Required range: 0 <= x <= 10000

Response

Bulk order fills retrieved successfully

asset_type
enum<string>
required

"perp" or "spot" — discriminator so callers can mix perp and spot rows in the same response without ambiguity.

Available options:
perp,
spot
event_uid
integer
required
Required range: x >= 0
filled_size
number<double>
required
is_bid
boolean
required
market
string
required
Example:

"0xmarket123..."

price
number<double>
required
sequence_number
integer<int64>
required
Required range: x >= 0
Example:

12345

trade_id
string
required
Example:

"3647276"

transaction_unix_ms
integer<int64>
required
Example:

1730841600000

transaction_version
integer<int64>
required
Required range: x >= 0
Example:

12345

user
string
required
Example:

"0x123..."