Tạo lệnh

API này cho phép bạn tạo một đơn hàng mới 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. Nội dung yêu cầu phải bao gồm các tham số cần thiết, chi tiết dưới đây.

2. Bạn phải cung cấp một timestamp và signature hợp lệ trong nội dung yêu cầu.

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

Đặt Đơn Hàng

POST https://nami.exchange/api/v4/spot/order

Headers

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

Nội dung

Tên	Loại	Mô Tả	Giá trị Có Thể Có
symbol	chuỗi	Mã giao dịch	Đọc Cấu Hình Spot để biết các mã có sẵn
price	số	Giá đặt đơn hàng.	Bất kỳ số nguyên dương nào
stopPrice	số	Giá dừng cho lệnh dừng.	Bất kỳ số nguyên dương nào
side	chuỗi	Mặt của đơn hàng	BUY | SELL
type	chuỗi	Loại của đơn hàng	LIMIT | MARKET | STOP_LIMIT | OCO
quantity	số	Số lượng tài sản để mua hoặc bán.	Bất kỳ số nguyên dương nào
quoteOrderQty	số	Số lượng đơn hàng tham chiếu.	Bất kỳ số nguyên dương nào
useQuoteQty	boolean	Xác định có sử dụng số lượng đơn hàng tham chiếu hay không.	True sử dụng quoteOrderQty. False sử dụng quantity
signature	chuỗi	Chữ ký là khóa bí mật được mã hóa dưới dạng ASCII	Cách Tạo Chữ Ký
timestamp	số	Thời gian là thời điểm yêu cầu được gửi đi.	Chỉ tính bằng mili giây

Phản Hồi

200

{
  "status": "ok",
  "data": {
    "displayingId": 435372,
    "userId": 18,
    "side": "BUY",
    "type": "LIMIT",
    "price": 62877.99,
    "liquidityStatus": 1,
    "quantity": 0.07474,
    "executedQty": 0,
    "quoteQty": 4699.5009726,
    "executedQuoteQty": 0,
    "liquidityUsdtPrice": 1,
    "liquidityTransferPrice": 62877.99,
    "liquiditySymbol": "BTCUSDT",
    "liquidityOrderId": "11779887",
    "feeMetadata": {
      "assetId": 22,
      "asset": "USDT",
      "value": 4.6995009726,
      "feeRatio": 0.001,
      "executed": 0
    },
    "useQuoteQty": false,
    "symbol": "BTCUSDT",
    "baseAsset": "BTC",
    "baseAssetId": 9,
    "quoteAsset": "USDT",
    "quoteAssetId": 22,
    "status": "NEW",
    "stopPrice": 0
  }
}

400

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

Đặt Đơn Hàng LIMIT

Nội dung

{
    "symbol": "NAOVNST",
    "side": "SELL",
    "type": "LIMIT",
    "quantity": 500,
    "quoteOrderQty": 1450000,
    "price": 2900,
    "useQuoteQty": false,
    "timestamp": 1737361908354,
    "signature": "81524e9fbbba63102b98f120d88c907639a09e15534869a782f79dd6a5c1aa29"
}

200

{
  "status": "ok",
  "data": {
    "displayingId": 435372,
    "userId": 18,
    "side": "BUY",
    "type": "LIMIT",
    "price": 62877.99,
    "liquidityStatus": 1,
    "quantity": 0.07474,
    "executedQty": 0,
    "quoteQty": 4699.5009726,
    "executedQuoteQty": 0,
    "liquidityUsdtPrice": 1,
    "liquidityTransferPrice": 62877.99,
    "liquiditySymbol": "BTCUSDT",
    "liquidityOrderId": "11779887",
    "feeMetadata": {
      "assetId": 22,
      "asset": "USDT",
      "value": 4.6995009726,
      "feeRatio": 0.001,
      "executed": 0
    },
    "useQuoteQty": false,
    "symbol": "BTCUSDT",
    "baseAsset": "BTC",
    "baseAssetId": 9,
    "quoteAsset": "USDT",
    "quoteAssetId": 22,
    "status": "NEW",
    "stopPrice": 0
  }
}

400

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

Đặt Đơn Hàng MARKET

Nội dung

{
    "symbol": "NAOVNST",
    "side": "BUY",
    "type": "MARKET",
    "quantity": 1000,
    "quoteOrderQty": 2900000,
    "price": 2900,
    "useQuoteQty": false,
    "timestamp": 1737361908354,
    "signature": "81524e9fbbba63102b98f120d88c907639a09e15534869a782f79dd6a5c1aa29"
}

200

{
  "status": "ok",
  "data": {
    "displayingId": 435372,
    "userId": 18,
    "side": "BUY",
    "type": "LIMIT",
    "price": 62877.99,
    "liquidityStatus": 1,
    "quantity": 0.07474,
    "executedQty": 0,
    "quoteQty": 4699.5009726,
    "executedQuoteQty": 0,
    "liquidityUsdtPrice": 1,
    "liquidityTransferPrice": 62877.99,
    "liquiditySymbol": "BTCUSDT",
    "liquidityOrderId": "11779887",
    "feeMetadata": {
      "assetId": 22,
      "asset": "USDT",
      "value": 4.6995009726,
      "feeRatio": 0.001,
      "executed": 0
    },
    "useQuoteQty": false,
    "symbol": "BTCUSDT",
    "baseAsset": "BTC",
    "baseAssetId": 9,
    "quoteAsset": "USDT",
    "quoteAssetId": 22,
    "status": "NEW",
    "stopPrice": 0
  }
}

400

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

Đặt Đơn Hàng STOP_LIMIT

Nội dung

{
    "symbol": "NAMIVNDC",
    "side": "SELL",
    "type": "STOP_LIMIT",
    "quantity": 300,
    "quoteOrderQty": 270000,
    "price": 280,
    "useQuoteQty": false,
    "stopPrice": 250,
    "timestamp": 1737361908354,
    "signature": "81524e9fbbba63102b98f120d88c907639a09e15534869a782f79dd6a5c1aa29"
}

200

{
  "status": "ok",
  "data": {
    "displayingId": 435372,
    "userId": 18,
    "side": "BUY",
    "type": "LIMIT",
    "price": 62877.99,
    "liquidityStatus": 1,
    "quantity": 0.07474,
    "executedQty": 0,
    "quoteQty": 4699.5009726,
    "executedQuoteQty": 0,
    "liquidityUsdtPrice": 1,
    "liquidityTransferPrice": 62877.99,
    "liquiditySymbol": "BTCUSDT",
    "liquidityOrderId": "11779887",
    "feeMetadata": {
      "assetId": 22,
      "asset": "USDT",
      "value": 4.6995009726,
      "feeRatio": 0.001,
      "executed": 0
    },
    "useQuoteQty": false,
    "symbol": "BTCUSDT",
    "baseAsset": "BTC",
    "baseAssetId": 9,
    "quoteAsset": "USDT",
    "quoteAssetId": 22,
    "status": "NEW",
    "stopPrice": 0
  }
}

400

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

Đặt Đơn Hàng OCO

Nội dung

{
    "symbol": "BTCUSDT",
    "side": "BUY",
    "type": "OCO",
    "quantity": 0.0005,
    "quoteOrderQty": 70,
    "price": 50000,
    "useQuoteQty": false,
    "stopPrice": 63520,
    "limitPrice": 70000,
    "timestamp": 1737361908354,
    "signature": "81524e9fbbba63102b98f120d88c907639a09e15534869a782f79dd6a5c1aa29"
}

200

{
  "status": "ok",
  "data": {
    "displayingId": 435372,
    "userId": 18,
    "side": "BUY",
    "type": "LIMIT",
    "price": 62877.99,
    "liquidityStatus": 1,
    "quantity": 0.07474,
    "executedQty": 0,
    "quoteQty": 4699.5009726,
    "executedQuoteQty": 0,
    "liquidityUsdtPrice": 1,
    "liquidityTransferPrice": 62877.99,
    "liquiditySymbol": "BTCUSDT",
    "liquidityOrderId": "11779887",
    "feeMetadata": {
      "assetId": 22,
      "asset": "USDT",
      "value": 4.6995009726,
      "feeRatio": 0.001,
      "executed": 0
    },
    "useQuoteQty": false,
    "symbol": "BTCUSDT",
    "baseAsset": "BTC",
    "baseAssetId": 9,
    "quoteAsset": "USDT",
    "quoteAssetId": 22,
    "status": "NEW",
    "stopPrice": 0
  }
}

400

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