Trades

POST /trades/search

Trade history search supporting the same filters used by the GMX UI: marketsDirections (per-tuple market+direction+collateral) and orderEventCombinations (orderType+eventName+isDepositOrWithdraw+isTwap).

Request

Base URL
https://arbitrum.gmxapi.io/v1
Auth
none required
TypeScript
https://skmtc.dev/gmx/apis/gmx-io-gmx-public-api/docs/trades/search/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

cursorstring

Opaque pagination cursor returned by previous response.

limitnumber double

Page size, 1..1000. Defaults to 100.

showDebugValuesboolean

When false (default), excludes MarketIncrease/Decrease/Swap OrderCreated debug events.

toTimestampnumber double

Inclusive upper-bound timestamp filter. Accepts seconds or milliseconds.

fromTimestampnumber double

Inclusive lower-bound timestamp filter. Accepts seconds or milliseconds.

forAllAccountsboolean

When true, returns trades for all accounts.

addressstring

Trader address. Required unless forAllAccounts is true.

Response

Success

hasMoreboolean required

nextCursorstring nullable required

Changes

No recorded changes to this operation across all 4 revisions of this API.

POST /trades/search

Request

Request body

Response 200OK

Changes

Response