Messages

{
  "topic": "trades:0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "trades": [
    {
      "asset_type": "perp",
      "account": "0x9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba",
      "market": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "action": "Open Long",
      "source": "OrderFill",
      "trade_id": "3647277",
      "size": 0.8,
      "price": 50100,
      "is_profit": false,
      "realized_pnl_amount": -45.2,
      "realized_funding_amount": 5.1,
      "is_rebate": false,
      "fee_amount": 20.04,
      "order_id": "45680",
      "client_order_id": "order_123",
      "transaction_unix_ms": 1699564900000,
      "transaction_version": 3647276286,
      "counter_party_account": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
    }
  ]
}

Websockets

Market trades

Real-time trade updates for one Decibel market address, perp or spot (not cached, updates only). Spot BTC and perp BTC are different markets with different addresses and require separate subscriptions. Each trade row carries asset_type. Spot rows use action values Buy or Sell, leave client_order_id empty, and zero realized_pnl_amount, realized_funding_amount, and fee_amount because spot has no positions/funding and per-side fee attribution is unavailable.

WSS

trades:

{marketAddr}

Messages

{
  "topic": "trades:0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "trades": [
    {
      "asset_type": "perp",
      "account": "0x9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba",
      "market": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "action": "Open Long",
      "source": "OrderFill",
      "trade_id": "3647277",
      "size": 0.8,
      "price": 50100,
      "is_profit": false,
      "realized_pnl_amount": -45.2,
      "realized_funding_amount": 5.1,
      "is_rebate": false,
      "fee_amount": 20.04,
      "order_id": "45680",
      "client_order_id": "order_123",
      "transaction_unix_ms": 1699564900000,
      "transaction_version": 3647276286,
      "counter_party_account": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
    }
  ]
}

marketAddr

type:string

required

Market address (Aptos address format, e.g. 0x456...)

MarketTradesMessage

type:object

Order update

⌘I