Lịch sử lệnh

API này cho phép bạn truy xuất lịch sử các đơn hàng đã đặt 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 Lịch Sử Đơn Hàng

GET https://nami.exchange/api/v4/spot/history

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	Mặt của đơn hàng (mua/bán)	Không	BUY
symbol	query	chuỗi	Mã cặp giao dịch	Không	ETHUSDT
hideCanceled	query	boolean	Ẩn các đơn hàng đã bị hủy	Không	true
pageSize	query	số nguyên	Số lượng đơn hàng mỗi trang	Không	10
page	query	số nguyên	Số trang	Không	1
timeFrom	query	date-time	Lọc đơn hàng từ thời gian này	Không	2024-01-01T00:00:00Z
timeTo	query	date-time	Lọc đơn hàng đến thời gian này	Không	2024-12-31T23:59:59Z
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": 200,
      "stopPrice": null,
      "executedPrice": 0,
      "quantity": 1000,
      "executedQty": 1000,
      "quoteQty": 200000,
      "executedQuoteQty": 200000,
      "useQuoteQty": null,
      "liquidityStatus": 0,
      "liquiditySymbol": null,
      "liquidityUsdtPrice": 0,
      "liquidityTransferPrice": 0,
      "liquidityOrderId": null,
      "liquidityTransferFee": 0,
      "limitPrice": null,
      "internalError": false,
      "_id": "678e12e7a679c0c007d3b315",
      "displayingId": 453079,
      "baseAsset": "NAMI",
      "baseAssetId": 1,
      "createdAt": "2025-01-20T09:09:59.066Z",
      "executedType": null,
      "feeMetadata": {
        "feeMode": 0,
        "originBaseQty": 1000,
        "assetId": 39,
        "value": 80,
        "feeRatio": 0.0004
      },
      "limitOrderId": null,
      "ocoOrderId": null,
      "priceToCalLockAndFee": null,
      "quoteAsset": "VNST",
      "quoteAssetId": 39,
      "side": "BUY",
      "status": "FILLED",
      "stopLimitOrderId": null,
      "symbol": "NAMIVNST",
      "type": "LIMIT",
      "updatedAt": "2025-01-20T09:09:59.066Z",
      "userId": 583344
    }
  ]
}

400