Skip to main content
GET
/
v1
/
account
/
trades
Get trade history
curl --request GET \
  --url https://api.joyride.exchange/v1/account/trades
[
  {
    "id": 1,
    "instrument_id": "SOL_USDC-28FEB26-150-C",
    "price": 1550000,
    "size": 1000,
    "taker": "alice",
    "maker": "bob",
    "taker_side": "bid",
    "taker_order_id": 42,
    "maker_order_id": 37,
    "created_at": 1709164800000000
  }
]

Headers

​
x-device-id
string

User identifier (takes precedence over user_id query param)

Query Parameters

​
user_id
string

User identifier (fallback if x-device-id header is not set)

Response

200 - application/json

Array of user trades

​
id
integer
required

Unique trade identifier

Example:

1

​
instrument_id
string
required
Example:

"SOL_USDC-28FEB26-150-C"

​
price
integer
required

Execution price in USDC micros

Example:

1550000

​
size
integer
required

Contracts traded in millicontracts

Example:

1000

​
taker
string
required

Taker user ID

Example:

"alice"

​
maker
string
required

Maker user ID

Example:

"bob"

​
taker_side
enum<string>
required

Side of the taker: bid if buying, ask if selling

Available options:
bid,
ask
​
taker_order_id
integer
required

Taker's order ID

Example:

42

​
maker_order_id
integer
required

Maker's order ID

Example:

37

​
created_at
integer
required

Trade timestamp (Unix microseconds)

Example:

1709164800000000