Trades

{
    "method": "subscribe",
    "params": {
        "channel": "trade",
        "symbol": [
            "MATIC/USD"
        ],
        "snapshot": true
    }
}

{
    "method": "subscribe",
    "result": {
        "channel": "trade",
        "snapshot": true,
        "symbol": "MATIC/USD"
    },
    "success": true,
    "time_in": "2023-09-25T09:21:10.428340Z",
    "time_out": "2023-09-25T09:21:10.428375Z"
}

{
    "channel": "trade",
    "type": "snapshot",
    "data": [
        {
            "symbol": "MATIC/USD",
            "side": "buy",
            "price": 0.5147,
            "qty": 6423.46326,
            "ord_type": "limit",
            "trade_id": 4665846,
            "timestamp": "2023-09-25T07:48:36.925533Z"
        },
        {
            "symbol": "MATIC/USD",
            "side": "buy",
            "price": 0.5147,
            "qty": 1136.19677815,
            "ord_type": "limit",
            "trade_id": 4665847,
            "timestamp": "2023-09-25T07:49:36.925603Z"
        }
    ]
}

{
    "channel": "trade",
    "type": "update",
    "data": [
        {
            "symbol": "MATIC/USD",
            "side": "sell",
            "price": 0.5117,
            "qty": 40.0,
            "ord_type": "market",
            "trade_id": 4665906,
            "timestamp": "2023-09-25T07:49:37.708706Z"
        }
    ]
}

{
    "method": "unsubscribe",
    "params": {
        "channel": "trade",
        "symbol": [
            "MATIC/USD"
        ],
        "snapshot": true
    }
}

{
    "method": "unsubscribe",
    "result": {
        "channel": "trade",
        "symbol": "MATIC/USD"
    },
    "success": true,
    "time_in": "2023-09-25T09:21:10.428340Z",
    "time_out": "2023-09-25T09:21:10.428375Z"
}

{
    "method": "subscribe",
    "params": {
        "channel": "trade",
        "symbol": [
            "MATIC/USD"
        ],
        "snapshot": true
    }
}

{
    "method": "subscribe",
    "result": {
        "channel": "trade",
        "snapshot": true,
        "symbol": "MATIC/USD"
    },
    "success": true,
    "time_in": "2023-09-25T09:21:10.428340Z",
    "time_out": "2023-09-25T09:21:10.428375Z"
}

{
    "channel": "trade",
    "type": "snapshot",
    "data": [
        {
            "symbol": "MATIC/USD",
            "side": "buy",
            "price": 0.5147,
            "qty": 6423.46326,
            "ord_type": "limit",
            "trade_id": 4665846,
            "timestamp": "2023-09-25T07:48:36.925533Z"
        },
        {
            "symbol": "MATIC/USD",
            "side": "buy",
            "price": 0.5147,
            "qty": 1136.19677815,
            "ord_type": "limit",
            "trade_id": 4665847,
            "timestamp": "2023-09-25T07:49:36.925603Z"
        }
    ]
}

{
    "channel": "trade",
    "type": "update",
    "data": [
        {
            "symbol": "MATIC/USD",
            "side": "sell",
            "price": 0.5117,
            "qty": 40.0,
            "ord_type": "market",
            "trade_id": 4665906,
            "timestamp": "2023-09-25T07:49:37.708706Z"
        }
    ]
}

{
    "method": "unsubscribe",
    "params": {
        "channel": "trade",
        "symbol": [
            "MATIC/USD"
        ],
        "snapshot": true
    }
}

{
    "method": "unsubscribe",
    "result": {
        "channel": "trade",
        "symbol": "MATIC/USD"
    },
    "success": true,
    "time_in": "2023-09-25T09:21:10.428340Z",
    "time_out": "2023-09-25T09:21:10.428375Z"
}

The trade channel generates a trade event when orders are matched in the book. Multiple trades may be batched in a single message but that does not mean that these trades resulted from a single taker order. The feed accepts a list of symbols for subscription.

Request
Response

string

required

Value: subscribe

object

required

Hide properties

string

required

Value: trade

string[]

required

Example: ["BTC/USD", "MATIC/GBP"]A list of currency pairs.

boolean

One of: true, false
Default: falseRequest a snapshot after subscribing.

integer

Optional client originated request identifier sent as acknowledgment in the response.

string

required

Value: subscribe

object

Hide properties

string

required

Value: trade

string

required

Example: "BTC/USD"The currency pair associated with this subscription.

boolean

Indicates if a snapshot is requested.

string[]

An advisory message, highlighting deprecated fields or upcoming changes to the channel.

boolean

Indicates if the request was successfully processed by the engine. One of: true, false

string

Error message. Condition: if success is false.

string

The timestamp when the subscription was received on the wire, just prior to parsing data. Format: RFC3339. Example: 2022-12-25T09:30:59.123456Z

string

The timestamp when the acknowledgement was sent on the wire, just prior to transmitting data. Format: RFC3339. Example: 2022-12-25T09:30:59.123456Z

integer

Optional client originated request identifier sent as acknowledgment in the response.

Snapshot / Update

The snapshot and update responses share the same schema. An update message is streamed on a trade event. The snapshot reflects the most recent 50 trades.

string

Value: trade

string

One of: snapshot, update

object[]

A list of trade events.

Hide properties

string

Example: "BTC/USD"The symbol of the currency pair.

string

The side of the taker order.

float

Size of the trade.

float

Average price of the trade.

string

One of: limit, marketThe order type of the taker order.

integer

Trade identifier is a sequence number, unique per book.

string

Format: RFC3339
Example: 2022-12-25T09:30:59.123456ZThe book order update timestamp.

Unsubscribe

Request
Response

string

required

Value: unsubscribe

object

required

Hide properties

string

required

Value: trade

string[]

required

Example: ["BTC/USD", "MATIC/GBP"]A list of currency pairs.

integer

Optional client originated request identifier sent as acknowledgment in the response.

string

required

Value: unsubscribe

object

Hide properties

string

required

Value: trade

string

required

Example: "BTC/USD"The currency pair associated with this subscription.

boolean

Indicates if the request was successfully processed by the engine. One of: true, false

string

Error message. Condition: if success is false.

string

The timestamp when the subscription was received on the wire, just prior to parsing data. Format: RFC3339. Example: 2022-12-25T09:30:59.123456Z

string

The timestamp when the acknowledgement was sent on the wire, just prior to transmitting data. Format: RFC3339. Example: 2022-12-25T09:30:59.123456Z

integer

Optional client originated request identifier sent as acknowledgment in the response.

⌘I

Public Channels

Trading

Account

System

Snapshot / Update

Unsubscribe

​Subscribe

​Snapshot / Update

​Unsubscribe

Subscribe

Snapshot / Update

Unsubscribe