Skip to main content
GET
/
trades
cURL
curl --request GET \
  --url https://lite-api.jup.ag/perps/v1/trades
{
  "count": 123,
  "dataList": [
    {
      "action": "Increase",
      "collateralUsdDelta": "250.00",
      "createdTime": 1722851463,
      "baseFee": "0.45",
      "borrowFee": "0.45",
      "liquidationFee": "0.45",
      "priceImpactFee": "0.45",
      "fee": "0.45",
      "mint": "So11111111111111111111111111111111111111112",
      "orderType": "Market",
      "pnl": "24.13",
      "pnlPercentage": "24.13",
      "positionName": "SOL-PERP",
      "price": "123.45",
      "side": "long",
      "size": "12345.68",
      "txHash": "4sjjb5kKAWAtXg1MQausgyqDx1Q5mU79a6EigxjjLYmCqBrNUE123XuoKr7Qir6ahBbLoSLLzT8gznxC2cgss5gR",
      "updatedTime": 1722851463
    }
  ]
}

Query Parameters

​
action
enum<string>
Available options:
Increase,
Decrease
​
createdAtAfter
string

Fetches trades with a 'createdAt' date that is greater or equal to the given 'createdAtAfter' UNIX timestamp'

​
createdAtBefore
string

Fetches trades with a 'createdAt' date that is less than the given 'createdAtBefore' UNIX timestamp'

​
end
number
default:20

The index of the last row to retrieve. This parameter specifies the ending point for fetching rows from the dataset. It is exclusive, meaning that the row at this index will not be included in the results.

​
mint
enum<string>

Mint address for the underlying position of the trade

Available options:
So11111111111111111111111111111111111111112,
7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs,
3NZ9JMVBmGAqocybic2c7LQCJScmgsAZ6vQqTDzcqmJh
​
side
enum<string>
Available options:
long,
short
​
start
number
default:0

The index of the first row to retrieve. This parameter specifies the starting point for fetching rows from the dataset. It is inclusive, meaning that the row at this index will be included in the results

​
walletAddress
string
required

Public key for the wallet to fetch trades

Response

200 OK

​
count
number
required
​
dataList
object[]
required