GET
List trades

Authorizations

x-api-key
string
header
required

Your API key. Keys are issued on request: message @perp_ag on X.

Path Parameters

owner
string
required

The wallet: an account index on Lighter and RH Lighter, a Solana address on Jupiter, Phoenix and Bullet, an account object id (0x + 64 hex) on Aftermath.

Query Parameters

platform
enum<string>
required

Venue. See Venues and identifiers.

Available options:
LIGHTER,
RHLT,
JUPITER,
PHOENIX,
BULLET,
AFTERMATH
view
enum<string>
default:trades

Fills, or positions grouped from open to close.

Available options:
trades,
positions
market
string

Only this market symbol.

side
enum<string>

Only this side.

Available options:
long,
short
action
enum<string>

Only this fill type. buy and sell on order-book venues; increase, decrease and liquidation on Jupiter.

Available options:
buy,
sell,
increase,
decrease,
liquidation
fromDate
string<date-time>

From this time (ISO 8601).

toDate
string<date-time>

Up to this time (ISO 8601).

min_position_size_usd
number

Only fills on positions at least this large.

max_position_size_usd
number

Only fills on positions at most this large.

sort_by
enum<string>
default:block_time

Sort column.

Available options:
block_time,
position_size_usd,
size_usd_delta
sort_order
enum<string>
default:desc

Sort direction.

Available options:
asc,
desc
limit
integer
default:20

Rows per page.

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

Rows to skip.

Required range: x >= 0

Response

Success

status
enum<string>
required
Available options:
success
data
object[]
required

One fill (view=trades).

pagination
object