Skip to main content
GET
Get trades in a time window

Authorizations

Authorization
string
header
required

Bearer token from Geomi. See Authentication for setup instructions.

Query Parameters

market
string
required

Perp market address

from_ms
integer<int64>
required

Window start, unix ms (inclusive)

to_ms
integer<int64>
required

Window end, unix ms (inclusive)

min_notional_usd
number<double>

Only fills worth at least this many USD

limit
integer<int32>
default:500

Max fills, newest first

Required range: 1 <= x <= 1000

Response

Fills in the window

account
string
required

User's account address

Example:

"0x1234567890abcdef1234567890abcdef12345678"

action
string
required

Trade action type. Perp: position-centric ("OpenLong", "CloseShort", "Net", ...). Spot: side from this row's perspective ("Buy" / "Sell").

Example:

"buy"

asset_type
enum<string>
required

Which product this trade belongs to ("perp" or "spot"). Responses can mix products; this per-row tag lets clients demux.

Available options:
perp,
spot
client_order_id
string
required

Client-specified order ID

Example:

"client_order_abc"

counter_party_account
string
required

Counter party account on the other leg of the fill. For liquidation / ADL / delisting fills this is the backstop liquidator. Empty string for pre-V2 historical trades that did not carry counter party on-chain.

Example:

"0xfedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210"

fee_amount
number<double>
required

Fee paid by this row's account, normalized. Perp: always in the collateral asset (USDC). Spot: charged in the asset this side RECEIVED (protocol + builder fee combined); see fee_asset.

is_profit
boolean
required

Whether trade was profitable

is_rebate
boolean
required

Whether trade received rebate

market
string
required

Market identifier address

Example:

"0xmarket123456789abcdef"

order_id
string
required

Order ID associated with trade

Example:

"12345"

price
number<double>
required

Trade price

Example:

50000.25

realized_funding_amount
number<double>
required

Realized funding amount in USDC

  • Negative value: trader PAID funding (e.g., long position with positive funding rate)
  • Positive value: trader RECEIVED funding (e.g., short position with positive funding rate)
  • Zero: no funding accrued
Example:

-15.5

realized_pnl_amount
number<double>
required

Realized PnL amount

size
number<double>
required

Trade size

Example:

100.5

source
string
required

Trade source (e.g., "OrderFill", "MarginCall", "BackStopLiquidation", "ADL", "MarketDelisted")

Example:

"OrderFill"

trade_id
string
required

Trade ID

Example:

"3647276"

transaction_unix_ms
integer<int64>
required

Transaction timestamp in milliseconds

Example:

1634567890000

transaction_version
integer<int64>
required

Transaction version

Required range: x >= 0
Example:

3647276285

fee_asset
string | null

FA metadata address of the asset fee_amount is denominated in. Spot only (base asset for the buyer, quote for the seller); absent for perp rows, where the fee is implicitly the collateral asset.