Ví

API này lấy chi tiết số dư ví của người dùng cho một loại tiền tệ cụ thể.

Điều Kiện Tiên Quyết

Trước khi sử dụng API này, bạn cần đọc hướng dẫn Cách Tạo Chữ Ký. Hướng dẫn này giải thích các bước cần thiết để tạo tham số signature cần thiết để xác thực yêu cầu của bạn.

Lưu Ý Quan Trọng

1. Yêu cầu cần có timestamp và signature hợp lệ trong tham số truy vấn.

2. x-api-key phải được bao gồm trong tiêu đề yêu cầu để xác thực.

Lấy Số Dư Ví Người Dùng

GET https://nami.exchange/api/v4/user/balance

Tiêu Đề

Tên	Giá trị
Content-Type	application/json
x-api-key	<Khóa bí mật của bạn>

Tham Số Truy Vấn

Tên	Vị trí	Kiểu	Mô Tả	Bắt Buộc	Ví Dụ
type	integer	Id của ví (Spot = 0, Future = 2).	Yes	0
currency	query	integer	Mã loại tiền tệ (ID).	Không	1
signature	query	string	Chữ ký là khóa bí mật mã hóa dưới dạng ASCII. Cần thiết để xác thực yêu cầu.	Có	a1b2c3d4e5f6g7h8i9j0k
timestamp	query	date-time	Thời gian gửi yêu cầu.	Có	1670000000000

Phản Hồi

200

{
  "status": "ok",
  "data": {
    "1": {
      "value": 0,
      "locked_value": 0,
      "type": 0
    },
    "2": {
      "value": 0,
      "locked_value": 0,
      "type": 0
    }
  }
}

400

{
    "statusCode": 401,
    "message": "Thiếu API key, chữ ký, hoặc timestamp",
    "error": "Unauthorized"
}