Trades

Subscribe to latest trades for the specific instruments.

Subscribe Request

{
  "id": 2,
  "method": "SUBSCRIBE",
  "params": {
    "chainId": 143,
    "type": "trades",
    "pairs": [
      "0x44b60b6af9b615a5cf2d366e2143582557cff711_4294967295",
      "0x8c5243a6a4c6c7a82d954c8ff29e0611e25ac33e_4294967295",
      "0x73ada1ea346cc3908f41cf67a040f0acd7808be0_4294967295"
    ],
    "tradesLimit": 50
  }
}

Unsubscribe Request

{
    "id": 2,
    "method": "UNSUBSCRIBE",
    "params": {
        "chainId": 143,
        "type": "trades",
        "pairs": [
            "0x44b60b6af9b615a5cf2d366e2143582557cff711_4294967295",
            "0x8c5243a6a4c6c7a82d954c8ff29e0611e25ac33e_4294967295",
            "0x73ada1ea346cc3908f41cf67a040f0acd7808be0_4294967295"
        ]
    }
}

Parameter Description

• chainId (required): Chain ID

• pairs (required): Instrument address (lowercase) and expiry timestamp, joined by an underscore (e.g., 0x..._4294967295).

• type (required): Must be "trades"

• tradesLimit (optional): Number of latest trades to return per update (default: 10, max: 100)

Data Stream Message

{
    "stream": "trades",
    "chainId": 143,
    "instrument": "0x8c5243a6a4c6c7a82d954c8ff29e0611e25ac33e",
    "expiry": 4294967295,
    "data": [
        {
            "id": "1030045560162000002",
            "instrumentAddress": "0x8c5243a6a4c6c7a82d954c8ff29e0611e25ac33e",
            "expiry": 4294967295,
            "size": "11120",
            "balance": "256.911708540710000221",
            "price": "0.023103570911934353",
            "tradeFee": "0.051382341708142001",
            "protocolFee": "0",
            "timestamp": 1767152293,
            "txHash": "0x600b569d67beda10dd899a26c3499fb228cea462a4e79271c38a3cfde3f1a0c6",
            "type": "Market",
            "symbol": "MON/USDC",
            "baseToken": {
                "address": "0x0000000000000000000000000000000000000000",
                "symbol": "MON",
                "decimals": 18,
                "image": "",
                "price": 0.023079
            },
            "quoteToken": {
                "address": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
                "symbol": "USDC",
                "decimals": 6,
                "image": "",
                "price": 0.999812
            },
            "typeString": "Market",
            "side": "long",
            "event": "trade",
            "chainId": 143,
            "fairPrice": "0.02311844270776053",
            "markPrice": "0.023087307666361024",
            "trader": "0xb7a9c927181abfcaff44591189ac369236c38252"
        }
    ]
}

Trades Data Structure

• chainId (top-level): Chain ID of the trade update

• instrument (top-level): Instrument address corresponding to the update

• expiry (top-level): Expiry timestamp

• data: Latest trade of specific pair, contains:

  • id: Trade id

  • instrumentAddress: The instrument address of specific pair

  • expiry: Expiry timestamp

  • size: Trade size

  • balance: Account balance after trade

  • price: Execution price

  • tradeFee: Trade fee amount

  • protocolFee: Protocol fee amount

  • timestamp: Trade timestamp (Unix timestamp in seconds)

  • txHash: Transaction hash of the trade

  • type: Trade type (must be "Market")

  • symbol: Trading pair symbol (e.g., BTC/USDC)

  • baseToken: Base token information

    • address: Token contract address

    • symbol: Token symbol

    • decimals: Token decimals

    • image: Token image URL

    • price: Token price (USD)

  • quoteToken: Quote token information

    • address: Token contract address

    • symbol: Token symbol

    • decimals: Token decimals

    • image: Token image URL

    • price: Token price (USD)

  • typeString: Trade type string (must be "Market")

  • side: Trade side ("long" or "short")

  • event: Trade event ("trade" or "sweep")

  • fairPrice: AMM price after trade

  • markPrice: Mark price after trade

  • trader : trader address