Deals methods

Used to get information about the last trade for a specific pair.

List of Deals methods:

• Deals Query - used for one-time data get requests.

• Deals Subscribe - used to subscribe to receive real-time updates.

• Deals Unsubscribe - used to unsubscribe from the Deals Subscribe method.

Deals Query method

Used for one-time data get requests.

Method

deals.query

Request "params" parameters

Name	Type	Description	Example
market*	STRING	Any public pair	ETH_BTC
limit*	NUMERIC	How many trades to show	2
lastId*	NUMERIC	How many trades to skip	0

Request example

{
  "method":"deals.query",
  "params":
    [
      "ETH_BTC",
      2,
      0
    ],
  "id":1
}

Response "params" and "result" parameters

Name	Type	Description
market	STRING	Pair name
type	STRING	Trade type (buy or sell)
time	NUMERIC	Time in TimeStamp format
id	NUMERIC	ID
amount	STRING	Trade amount (in 1st ticker of pair)
price	STRING	Trade price (in 1st ticker of pair)

Response example

{
    "id": 1,
    "params": [
        "BTC_USDT",                        // market
        2,                                 // limit
        0                                  // lastId
    ],
    "result": [
        {
            "id": 19201768267,             // ID
            "type": "buy",                 // type
            "time": 1.727276247759E9,      // time
            "price": "63865.07",           // price
            "amount": "0.00448678"         // amount
        },
        {
            "id": 19201768100,
            "type": "sell",
            "time": 1.727276246117E9,
            "price": "63860.3281504",
            "amount": "0.00155184"
        }
    ],
    "error": null
}

Deals Subscribe method

Used to subscribe to receive real-time updates.

Method

deals.subscribe

Request "params" parameters

Name	Type	Type	Example
market*	STRING	Any public pair	BTC_USDT

Request example

{
  "method":"deals.subscribe",
  "params":
    [
      "BTC_USDT"
    ],
  "id":1
}

Response example (successfully subscribed)

{
    "id": 1,
    "params": [],
    "result": {
        "status": "success"
    },
    "error": null
}

Response "params" parameters ("deals.update")

Name	Type	Description
market	STRING	Pair name
id	NUMERIC	ID
type	STRING	Trade type (buy or sell)
time	NUMERIC	Time in TimeStamp format
price	STRING	Trade price (in 1st ticker of pair)
amount	STRING	Trade amount (in 1st ticker of pair)

Response example ("deals.update")

{
    "id": null,
    "method": "deals.update",
    "params": [
        "BTC_USDT",                           // market
        [
            {
                "id": 19201677141,            // ID
                "type": "sell",               // type
                "time": 1.727275412302E9,     // time
                "price": "63859.83136",       // price
                "amount": "0.0020744"         // amount
            },
            ...
            ]
    ]
}

Deals Unsubscribe method

Used to unsubscribe from the Deals Subscribe method.

Method

deals.unsubscribe

Request example

{
  "method":"deals.unsubscribe",
  "params":[],
  "id":2
}

Response example (successfully unsubscribed)

{
    "id": 2,
    "params": [],
    "result": {
        "status": "success"
    },
    "error": null
}