Người dùng và Tài khoản

View as Markdown

Trừ khi có chỉ định khác, các điểm cuối sau đây có thể sử dụng ký JWT hoặc API Key .

Thông tin người dùng

1GET /v1/private/user/info

Trường phản hồi:

Lĩnh vựcLoạiMô tả
userInfo.userIdstringID người dùng bên ngoài
userInfo.usernamestringTên người dùng
userInfo.agentIdint64ID đại lý
userInfo.vipLevelint64cấp VIP
userInfo.lastLoginAtint64Thời gian đăng nhập cuối cùng
userInfo.lastLoginIpstringĐăng nhập lần IP

Tài sản người dùng

1GET /v1/private/user/asset

Trường phản hồi:

Lĩnh vựcLoạiMô tả
userAsset.userIdstringID người dùng bên ngoài
userAsset.assetTypestringLoại tài sản
userAsset.walletBalancestringSố dư ví
userAsset.frozenMarginstringKý quỹ bị đóng băng bởi các lệnh chờ xử lý
userAsset.usedMarginstringKý quỹ sử dụng bởi các vị thế

Tạo listenKey

1POST /v1/private/user/listen-key

Tạo khóa xác thực cho các luồng WebSocket riêng tư.

Gia hạn listenKey

1PUT /v1/private/user/listen-key

Kéo dài hiệu lực listenKey .

Đóng listenKey

1DELETE /v1/private/user/listen-key

Đóng listenKeyđược chỉ định.

Nhật ký thay đổi tài khoản

1GET /v1/private/user/account-change-log?assetType=USDT&page=1&pageSize=20

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
assetTypestringKhôngLoại tài sản, chẳng hạn như USDT
changeTypestringKhôngThay đổi loại
startTimeint64KhôngThời gian bắt đầu
endTimeint64KhôngThời gian kết thúc
pageint32KhôngSố trang, 1 mặc định
pageSizeint32KhôngSố lượng mục trên mỗi trang, 20 mặc định

Trường phản hồi:

Lĩnh vựcLoạiMô tả
list[].assetTypestringLoại tài sản
list[].amountstringSố tiền đã thay đổi
list[].walletBalanceBeforestringSố dư ví trước khi thay đổi
list[].walletBalanceAfterstringSố dư ví sau khi thay đổi
list[].frozenBalanceBeforestringSố dư bị đóng băng trước khi thay đổi
list[].frozenBalanceAfterstringSố dư bị đóng băng sau khi thay đổi
list[].changeTypestringThay đổi loại
list[].referenceIdstringMã doanh nghiệp liên quan
list[].createdAtint64Thời gian sáng tạo
totalint64Tổng số lượng

Thống kê khối lượng 30 ngày

1GET /v1/private/user/volume-stats

Trường phản hồi:

Lĩnh vựcLoạiMô tả
volume30dstringKhối lượng giao dịch tích lũy trong 30 ngày qua
feeTotal30dstringPhí tích lũy trong 30 ngày qua

Lịch sử cân bằng

1GET /v1/private/user/balance-history?period=1D&limit=30

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
periodstringĐúng vậy1D / 1W / 1M
limitintKhôngSố lượng mục trả lại, 30 mặc định

Trường phản hồi:

Lĩnh vựcLoạiMô tả
items[].datestringNgày tổng hợp
items[].balancestringSố dư ví
items[].pnlstringPnL thực hiện trong kỳ

Tổng quan về giao dịch

1GET /v1/private/user/trade-overview?type=1M

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
typestringĐúng vậyPhạm vi xu hướng: 1D, 1W, 1M, 3M, 6M, 1Y

Trường phản hồi:

Lĩnh vựcLoạiMô tả
todayPnlstringPnL hiện thực hiện hôm nay
todayVolumestringKhối lượng giao dịch hợp đồng hôm nay
totalVolumestringKhối lượng giao dịch hợp đồng tích lũy
totalPnlstringPnL tích lũy
maxDrawdown30dstringSố tiền rút tối đa trong 30 ngày qua
maxDrawdown30dRatestringTỷ lệ rút nước tối đa trong 30 ngày qua, từ 0 đến 1
transferInstringSố tiền chuyển vào tích lũy
transferOutstringSố tiền chuyển ra cộng dồn
items[]arrayDữ liệu xu hướng tài sản

Tổng quan Tài sản Tóm tắt

1GET /v1/private/user/asset/overview/summary

Các trường phản hồi giống với các trường tóm tắt tổng quan giao dịch, ngoại trừ items[].

Xu hướng Tổng quan Tài sản

1GET /v1/private/user/asset/overview/trend?type=1M

Tham số yêu cầu:

Tham sốLoạiBắt buộcMô tả
typestringĐúng vậyPhạm vi xu hướng: 1D, 1W, 1M, 3M, 6M, 1Y

Trường phản hồi:

Lĩnh vựcLoạiMô tả
items[].snapshotTimeint64Thời gian chụp nhanh
items[].balancestringCán cân tài khoản vãng lai
items[].pnlstringPnL cho kỳ hiện tại
items[].pnlRatestringLãi suất PnL cho kỳ hiện tại
items[].totalPnlstringPnL tích lũy

Biểu tượng yêu thích

Lưu

1POST /v1/private/user/favorite-symbols
2Content-Type: application/json

Nội dung yêu cầu:

1{
2 "symbols": ["BTCUSDT", "ETHUSDT"]
3}

Truy vấn

1GET /v1/private/user/favorite-symbols

Trường phản hồi:

Lĩnh vựcLoạiMô tả
symbolsstring[]Danh sách biểu tượng yêu thích