Get recent trades
This endpoint allows users to get recent trades for a specific market.
GET /api/v1/trades
Query Parameters
"symbol"
string
required
Trading pair symbol
BTC
/api/v1/trades?symbol=BTC
Response
Status 200: Successfully retrieved recent trades
{
"success": true,
"data": [
{
"event_type": "fulfill_taker",
"price": "104721",
"amount": "0.0001",
"side": "close_long",
"cause": "normal",
"created_at": 1749289837752
}
}
'event_type'
string
"fulfill_taker"
if maker
"fulfill_maker"
if taker
'price'
decimal string
Price in USD at which trade event has occurred
'amount'
decimal string
Amount in token denomination for which the trade has occurred for.
'side'
string
"open_long"
"open_short"
"close_long"
"close_short"
'cause'
string
"normal"
regular user-initiated trading
"market_liquidation"
position was liquidated due to insufficient margin
"backstop_liquidation"
position was liquidated by backstop mechanism
"settlement"
position was closed due to Auto-Deleveraging (ADL) or other settlement
'created_at'
integer
Timestamp in milliseconds of trade event
Status 400: Invalid request parameters
Status 401: Unauthorized access
Status 500: Internal server error
Code Example (Python)
import requests
response = requests.get(
"/api/v1/trades?symbol=BTC",
headers={"Accept": "*/*"},
)
data = response.json()
Last updated