Lịch sử giao dịch

API này truy xuất chi tiết giao dịch của các đơn hàng trên nền tảng.

Yêu Cầu Trước

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 sẽ 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.

Những Lưu Ý Quan Trọng

1. Yêu cầu cần các tham số truy vấn để lọc kết quả. Xem chi tiết dưới đây.

2. Bạn phải cung cấp một timestamp và signature hợp lệ trong tham số truy vấn.

3. x-api-key phải được bao gồm trong phần header của yêu cầu để xác thực.

Lấy Chi Tiết Giao Dịch Đơn Hàng

GET https://nami.exchange/api/v3/spot/trade

Headers

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í	Loại	Mô Tả	Bắt buộc	Ví dụ
side	query	chuỗi	Phía của đơn hàng (mua/bán).	Không	buy
symbol	query	chuỗi	Cặp giao dịch.	Không	BTC/USD
hideCanceled	query	boolean	Liệu có ẩn các đơn hàng đã hủy hay không.	Không	true
pageSize	query	số nguyên	Số lượng đơn hàng mỗi trang.	Không	50
page	query	số nguyên	Số trang.	Không	1
timeFrom	query	date-time	Lọc các đơn hàng từ thời gian này.	Không	2025-01-01T00:00:00Z
timeTo	query	date-time	Lọc các đơn hàng đến thời gian này.	Không	2025-01-10T00:00:00Z
signature	query	chuỗi	Chữ ký là khóa bí mật được mã hóa dưới dạng ASCII. Nó là yêu cầu để xác thực yêu cầu.	Có	a1b2c3d4e5f6g7h8i9j0k
timestamp	query	date-time	Thời gian là thời điểm yêu cầu được gửi đi.	Có	1670000000000

Phản Hồi

200

{
  "status": "ok",
  "data": [
    {
      "price": 35000,
      "stopPrice": null,
      "quantity": 1.2,
      "executedQty": 0.6,
      "quoteQty": 42000,
      "executedQuoteQty": 21000,
      "useQuoteQty": false,
      "liquidityStatus": 1,
      "liquiditySymbol": "BTC/USD",
      "liquidityUsdtPrice": 1,
      "liquidityTransferPrice": 35000,
      "liquidityOrderId": "12537485",
      "displayingId": 453672,
      "userId": 25,
      "side": "BUY",
      "type": "LIMIT",
      "symbol": "BTC/USD",
      "baseAsset": "BTC",
      "baseAssetId": 1,
      "quoteAsset": "USD",
      "quoteAssetId": 22,
      "status": "NEW",
      "createdAt": "2025-01-10T14:25:33.524Z",
      "updatedAt": "2025-01-12T16:40:11.124Z"
    }
  ]
}

400

{
    "status": "BROKER_ERROR",
    "code": 6104,
    "data": {
        "requestId": "6ff66697-2742-4caf-acad-f97e9cc3596d"
    },
    "message": null
}