Cross Margin Position

Topic: /margin/position

Description

The system will push the change event when the position status changes, Or push the current debt message periodically when there is a liability.

Push frequency: once every 4s

{
  "id": 1545910660739,
  "type": "subscribe",
  "topic": "/margin/position",
  "response": true,
  "privateChannel": "true"
}

Response

Data Schema

crossMarginPosition

topic

string

required

subject

enum<string>

required

Allowed values:

debt.ratioposition.status

type

string

required

userId

string

required

channelType

enum<string>

required

Channel type

Allowed values:

privatepublic

data

object

required

debtRatio

number

required

Debt ratio

totalAsset

number

required

Total assets in BTC (interest included)

marginCoefficientTotalAsset

string

required

totalDebt

string

required

Total debt in BTC (interest included)

assetList

object

required

Asset list (interest included)

debtList

object

required

Debt list (interest included)

type

enum<string>

required

Event type, Only applicable to "debt.ratio" subject

Allowed values:

FROZEN_FLUNFROZEN_FLFROZEN_RENEWUNFROZEN_RENEWLIABILITYUNLIABILITY

timestamp

integer <int64>

required

Example

//"subject": "debt.ratio"
{
    "topic": "/margin/position",
    "subject": "debt.ratio",
    "type": "message",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private"
    "data": {
        "debtRatio": 0,
        "totalAsset": 0.00052431772284080000000,
        "marginCoefficientTotalAsset": "0.0005243177228408",
        "totalDebt": "0",
        "assetList": {
            "BTC": {
                "total": "0.00002",
                "available": "0",
                "hold": "0.00002"
            },
            "USDT": {
                "total": "33.68855864",
                "available": "15.01916691",
                "hold": "18.66939173"
            }
        },
        "debtList": {
            "BTC": "0",
            "USDT": "0"
        },
        "timestamp": 1729912435657
    }
}

//"subject": "position.status"
{
    "topic": "/margin/position",
    "subject": "debt.ratio",
    "type": "message",
    "userId": "633559791e1cbc0001f319bc",
    "channelType": "private"
    "data": {
        "type": "FROZEN_FL",
        "timestamp": 15538460812100
    }
}

Request

Query Params

token

string

required

The token required to establish a websocket connection

Example:

2neAiuYvAU737TOajb2U3uT8AEZqSWYe0fBD4LoHuXJDSC7gIzJiH4kNTWhCPISWo6nDpAe7aUaaHJ4fG8oRjFgMfUI2sM4IySWHrBceFocY8pKy2REU1HwZIngtMdMrjqPnP-biofFWbNaP1cl0X1pZc2SQ-33hDH1LgNP-yg86m_MPLMa627KxiBgEBDt6.aqNEDMGa8-2jHVTcbnYPqQ==

connectId

string

optional

Connection Id, a unique value taken from the client side. Both the id of the welcome message and the id of the error message are connectId.

Example:

121345

Cross Margin Position

Topic: /margin/position#

Subscribe Message#

Response#

Request

Topic: /margin/position

Subscribe Message

Response