user_trades

When orders match, this topic notifies the users involved in the match process. Buyer and seller will get notified about what orders were executed.

This is an authenticated stream. You must provide a valid ticket from authentication to subscribe.

Subscription Request

string

required

Subscribe method. Must be subscribe

array

required

Array of topics to subscribe to. Must include user_tradesExample: ["user_trades"]

string

required

Ticket created using the endpoint POST https://api.ripio.com/trade/ticket

Stream Response

integer

Each WebSocket message includes a sequential numeric id. Each topic has its own unique sequence, and for private topics, the sequence is unique to each topic and user. It’s important to note that some topics will send a “welcome message”, which will have an id value of -1. Additionally, this sequence may be reset between connections, so be sure to update this value locally whenever you reconnect.

string

Topic name (always user_trades)

integer

Timestamp in milliseconds

object

Trade execution details

Show Trade Details

string

Your user ID

object

Trade information object

Show Trade Information

string

Trade identifier

number

Amount executed in the base currency

number

Price per unit at which the trade executed

number

Total value of the trade (amount × price)

string

Your side in the trade: buy or sell

string

Your role in the trade: taker or maker

string

Your order type (e.g., limit, market)

number

Trading fee charged for this trade

string

Currency in which fee was charged

string

Trading pair code (e.g., ETH_BRL)

string

Your order ID (use maker_order_id or taker_order_id)

string

Order ID of the maker (liquidity provider)

string

Order ID of the taker (liquidity taker)

string

Trade execution datetime (ISO 8601 format)

integer

Trade timestamp in milliseconds

Subscription Example

{
  "method": "subscribe",
  "topics": [
    "user_trades"
  ],
  "ticket": "97794B95-AFE7-454F-81B0-9109112548C2"
}

Stream Response Example - You as Taker

{
  "id": 9,
  "topic": "user_trades",
  "timestamp": 1673271591764,
  "body": {
    "user_id": "30B8CDBB-BDBD-4B60-A90F-860AB46B76F7",
    "trade": {
      "id": "08799ECC-F6B1-498E-B89C-2A05E6A181B9",
      "amount": 1,
      "price": 49,
      "total_value": 49,
      "side": "buy",
      "taker_or_maker": "taker",
      "type": "market",
      "fee": 0,
      "fee_currency": "BCH",
      "pair_code": "BCH_BRL",
      "maker_order_id": "AF1C3AD2-D5A2-41CC-9A4C-646B600F9E01",
      "taker_order_id": "52B46D87-86A1-4978-B141-4E18E3E47514",
      "date": "2023-01-09T13:39:24.057Z",
      "timestamp": 1675780847920
    }
  }
}

Stream Response Example - You as Maker

{
  "id": 10,
  "topic": "user_trades",
  "timestamp": 1673271591764,
  "body": {
    "user_id": "30B8CDBB-BDBD-4B60-A90F-860AB46B76F7",
    "trade": {
      "id": "08799ECC-F6B1-498E-B89C-2A05E6A181B9",
      "amount": 1,
      "price": 49,
      "total_value": 49,
      "side": "sell",
      "taker_or_maker": "maker",
      "type": "limit",
      "fee": 0.05,
      "fee_currency": "BCH",
      "pair_code": "BCH_BRL",
      "maker_order_id": "AF1C3AD2-D5A2-41CC-9A4C-646B600F9E01",
      "taker_order_id": "52B46D87-86A1-4978-B141-4E18E3E47514",
      "date": "2023-01-09T13:39:24.057Z",
      "timestamp": 1675780847920
    }
  }
}

Maker vs Taker Explained

Taker

Your incoming order matched with an existing order in the book
Usually pays higher fees
Typically executed immediately

Maker

Your order was already in the order book
Usually receives better fees
Waited for another order to match

Key Fields

Field	Description
amount	How much was traded
price	At what price it was executed
fee	Commission charged
side	Whether you were buying or selling
taker_or_maker	Your role in this trade
total_value	amount × price

Fee Implications

Maker: Often lower fees (liquidity provider)
Taker: Often higher fees (market taker)
Fee Currency: May be different from trade pair
Fee Rebates: Some exchanges offer maker rebates

Calculation Examples

// Net proceeds after fees (for sell)
const netProceeds = trade.total_value - trade.fee;

// Cost including fees (for buy)
const costWithFees = trade.total_value + trade.fee;

// Fee percentage
const feePercent = (trade.fee / trade.total_value) * 100;

// Average execution price including fees
const avgPriceWithFees = (trade.total_value + trade.fee) / trade.amount;

Usage Notes

Authentication Required: Requires valid ticket from WebSocket authentication
Real-time Updates: Receive immediate notification when your trades execute
Both Sides: You get notified whether you’re buyer or seller
Order Correlation: Link trades back to your orders
Fee Information: Complete fee details included
Timestamp: Use for accurate trade recording

You Receive Notifications For

Trades where your market order hit existing orders
Trades where your limit order was matched
Both partial and full fills of your orders
Trades from any of your active orders

Use Cases

Trade Recording: Record all trades in real-time
P&L Tracking: Calculate profit/loss as trades execute
Fee Accounting: Track fees paid per trade
Order Confirmation: Verify order fills
Automated Trading: React to trade fills
Reporting: Generate trade reports automatically
Reconciliation: Reconcile with exchange records

Introduction

Ripio Wallet

Ripio Trade

Subscription Request

Stream Response

Subscription Example

Stream Response Example - You as Taker

Stream Response Example - You as Maker

Maker vs Taker Explained

Taker

Maker

Key Fields

Fee Implications

Calculation Examples

Usage Notes

You Receive Notifications For

Use Cases

​Subscription Request

​Stream Response

​Subscription Example

​Stream Response Example - You as Taker

​Stream Response Example - You as Maker

​Maker vs Taker Explained

​Taker

​Maker

​Key Fields

​Fee Implications

​Calculation Examples

​Usage Notes

​You Receive Notifications For

​Use Cases

Subscription Request

Stream Response

Subscription Example

Stream Response Example - You as Taker

Stream Response Example - You as Maker

Maker vs Taker Explained

Taker

Maker

Key Fields

Fee Implications

Calculation Examples

Usage Notes

You Receive Notifications For

Use Cases