My Assets methods

Used to get the balances of the user from which the request is made. After establishing the WebSocket connection, the user has to be authorized to use this methods.

List of My Balances methods:

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

• Asset Subscribe - used to subscribe to receive real-time updates (when the balance state is changed).

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

Asset Query method

Used for one-time data get requests.

Method name

asset.query

Request "params" parameters

Name	Type	Description	Example
asset*	STRING	Assets (empty = all balances, 1 asset = 1 balance for a specific asset, list of assets = list of balances for specific assets)	BTC

Request example 1

{
  "method":"asset.query",
  "params":
    [
      "BTC"
    ],
  "id":1
}

Response parameters

Name	Type	Description
market	STRING	Asset name
available	STRING	Available amount (without active orders)
freeze	STRING	Freezed amount (active orders amount)

Response example 1

{
    "id": 1,
    "params": [
        "BTC"
    ],
    "result": {
        "BTC": {
            "available": "0.000290480096",
            "freeze": "0"
        }
    },
    "error": null
}

Request example 2

{
  "method":"asset.query",
  "params":
    [
      "BTC",
      "ETH",
      "USDT"
    ],
  "id":2
}

Response example 2

{
    "id": 2,
    "params": [
        "BTC",
        "ETH",
        "USDT"
    ],
    "result": {
        "BTC": {
            "available": "0.000290480096",
            "freeze": "0"
        },
        "ETH": {
            "available": "0",
            "freeze": "0"
        },
        "USDT": {
            "available": "42.5282451022304501",
            "freeze": "4.9999999996298992"
        }
    },
    "error": null
}

Request example 3

{
  "method":"asset.query",
  "params":
    [],
  "id":3
}

Response example 3

{
    "id": 3,
    "params": [],
    "result": {
        "AGLD": {
            "available": "0",
            "freeze": "0"
        },
        "MATIC": {
            "available": "0",
            "freeze": "0"
        },
        ...
        },
    "error": null
}

Asset Subscribe method

Used to subscribe to receive real-time updates.

Method

asset.subscribe

Request "params" parameters

Name	Type	Description	Example
asset*	STRING	Assets (empty = all balances, 1 asset = 1 balance for a specific asset, list of assets = list of balances for specific assets)	USDT

Request example

{
  "method":"asset.subscribe",
  "params":
    [
      "USDT"
    ],
  "id":3
}

Response example (successfully subscribed)

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

Response parameters ("asset.update", when the balance state was changed)

Name	Type	Description
market	STRING	Asset name
available	STRING	Available amount (in active orders)
freeze	STRING	Freezed amount (active orders amount)

Response example ("asset.update", when the balance state was changed)

{
    "id": null,
    "method": "asset.update",
    "params": [
        {
            "USDT": {                                     // market
                "available": "42.4487262222304501",       // available
                "freeze": "4.9999999996298992"            // freeze
            }
        }
    ]
}

Asset Unsubscribe method

Used to unsubscribe from the Asset Subscribe method.

Method

asset.unsubscribe

Request example

{
  "method":"asset.unsubscribe",
  "params":[],
  "id":4
}

Response example (successfully unsubscribed)

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