trade@BASE_QUOTE

This topic listens for trades of a given pair (BASE_QUOTE), so it will be notified every time a trade happens.

Subscription Request

string

required

Subscribe method. Must be subscribe

array

required

Array of topics to subscribe to. Format: trade@BASE_QUOTEExample: ["trade@ETH_BRL", "trade@BTC_BRL"]

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 (format: trade@BASE_QUOTE)

integer

Timestamp in milliseconds

object

Trade details object

Show Trade Details

string

Trade identifier

number

Amount traded in the base currency

string

Trade execution datetime (ISO 8601 format)

string

Trading pair code (e.g., ETH_BRL)

number

Price per unit at which trade was executed

number

Total value of the trade (amount × price)

integer

Trade timestamp in milliseconds

string

Order ID of the maker (liquidity provider)

string

Maker order side: buy or sell

string

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

string

Order ID of the taker (liquidity taker)

string

Taker order side: buy or sell

string

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

Subscription Example

{
  "method": "subscribe",
  "topics": [
    "trade@ETH_BRL"
  ]
}

Stream Response Example

{
  "id": 1,
  "topic": "trade@ETH_BRL",
  "timestamp": 1672856503549,
  "body": {
    "amount": 0.2404764,
    "date": "2019-01-03T02:27:33.947Z",
    "id": "2B222F22-5235-45FA-97FC-E9DBFA2575EE",
    "maker_order_id": "F49F5BD8-3F5B-4364-BCEE-F36F62DB966A",
    "maker_side": "buy",
    "maker_type": "limit",
    "pair": "ETH_BRL",
    "price": 15160,
    "taker_order_id": "FEAB5CEC-7F9E-4F95-B67D-9E8D5C739BE3",
    "taker_side": "sell",
    "taker_type": "market",
    "timestamp": 1675780847920,
    "total_value": 3638.4
  }
}

Multiple Subscriptions Example

{
  "method": "subscribe",
  "topics": [
    "trade@ETH_BRL",
    "trade@BTC_BRL",
    "trade@BTC_USD"
  ]
}

Usage Notes

Real-time Updates: You will receive a notification every time a trade executes on the specified pair
Multiple Pairs: You can subscribe to multiple trading pairs in a single request
Maker vs Taker: The response includes information about both sides of the trade:
- Maker: The order that was already in the order book
- Taker: The incoming order that matched with the maker
Volume Information: Use the amount and price fields to calculate trade volume and values

Use Cases

Trade Feed: Display a real-time feed of all trades for specific pairs
Market Activity: Monitor market activity and trading volume
Order Matching: Track when your orders have been executed and matched
Analytics: Collect trade data for analysis and reporting

Introduction

Ripio Wallet

Ripio Trade

Subscription Request

Stream Response

Subscription Example

Stream Response Example

Multiple Subscriptions Example

Usage Notes

Use Cases

​Subscription Request

​Stream Response

​Subscription Example

​Stream Response Example

​Multiple Subscriptions Example

​Usage Notes

​Use Cases

Subscription Request

Stream Response

Subscription Example

Stream Response Example

Multiple Subscriptions Example

Usage Notes

Use Cases