Skip to main content
GET
Get user funding rate history

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 market address

side
enum<string>

Filter by side Order side filter: buy or sell. Product-independent: a buy is a bid on both venues, whether or not it opens a perp long. For perp orders, maps to the is_buy column; for spot orders, is_bid. For perp trades/funding, maps to action IN ('OpenLong','CloseShort') (buy) or action IN ('CloseLong','OpenShort') (sell); for spot trades, to is_taker_bid resolved against whether the account is the taker or maker.

Available options:
buy,
sell
limit
integer<int32>
default:10

Page size

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

Page offset

Required range: 0 <= x <= 10000
start_timestamp
integer<int64>
end_timestamp
integer<int64>
sort_key
enum<string>

Sort key for history endpoints

Available options:
timestamp
sort_dir
enum<string>
Available options:
ASC,
DESC

Response

Funding rate history retrieved successfully

items
object[]
required

The items in the current page

total_count
integer<int32> | null

The total number of items across all pages. Optional: history endpoints omit this field to avoid expensive COUNT(*) queries.

Required range: x >= 0