Get recent trades

This endpoint allows users to get recent trades for a specific market.

GET /api/v1/trades

Query Parameters

Field
Type
Need
Description
Example

"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
    }
}
Field
Type
Description

'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