Orders API V2

ทีม Quickex

17 พฤศจิกายน 2568

~1 นาทีในการอ่าน

ส่วน orders มีเมธอดสำหรับสร้างออเดอร์และเพิ่มอีเมลของผู้ใช้ให้กับออเดอร์ที่มีอยู่แล้ว
โดยใช้เมธอดที่มีให้ คุณสามารถเริ่มต้นการแลกเปลี่ยนผ่านการสร้างออเดอร์ รวมถึงผูกอีเมลเพื่อรับการแจ้งเตือนเกี่ยวกับสถานะของออเดอร์ได้ด้วย

POST

orders/public/set-email

Endpoint URL

https://quickex.io/api/v2/orders/public/set-email

Documentation

คำอธิบายทั่วไป
Endpoint นี้ช่วยให้คุณสามารถผูกอีเมลของผู้ใช้เข้ากับออเดอร์ที่สร้างไว้แล้ว หลังจากเรียกเมธอดนี้ ฟิลด์ userEmail ในออเดอร์จะถูกตั้งค่าเป็นอีเมลที่ระบุ และการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงสถานะของธุรกรรมจะถูกส่งไปยังอีเมลนั้น

พารามิเตอร์

ส่วนหัวของคำขอ (Headers)

ชื่อ	จำเป็น	คำอธิบาย
`X-Api-Public-Key`	ใช่	กุญแจ API สาธารณะของคุณสำหรับการยืนยันคำขอ
`X-Api-Timestamp`	ใช่	Timestamp ในรูปแบบ UNIX (ms) ใช้เพื่อป้องกันการโจมตีแบบทำซ้ำ (replay attacks)
`X-Api-Signature`	ใช่	ลายเซ็น HMAC ของเนื้อหาคำขอทั้งหมด สร้างด้วยกุญแจลับของคุณ

เนื้อหาคำขอ (JSON)

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
`orderId`	number	ใช่	รหัสของออเดอร์ที่มีอยู่
`userEmail`	string	ใช่	อีเมลสำหรับรับการแจ้งเตือน

ตัวอย่างคำขอ

curl -X POST 'https://quickex.io/api/v2/orders/public/set-email' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Public-Key: yourPublicKey' \
  -H 'X-Api-Timestamp: 1691397292905' \
  -H 'X-Api-Signature: yourHmacSignature' \
  -d '{
    "orderId": 12345,
    "userEmail": "user@example.com"
  }'

การตอบสนองที่เป็นไปได้

200 OK — เพิ่มอีเมลสำเร็จ
403 ERR_FORBIDDEN — ขาดส่วนหัวที่จำเป็นหรือ Signature ไม่ถูกต้อง:

{
  "status": "ERR_FORBIDDEN",
  "message": "Header params is missed!"
}

กรณีการใช้งาน

พาร์ทเนอร์อินทิเกรเตอร์เชื่อมระบบ Quickex เข้ากับแอปพลิเคชันของตน และต้องการเปิดใช้งานการแจ้งเตือนทางอีเมลโดยอัตโนมัติหลังจากสร้างออเดอร์:

ลูกค้าสร้างออเดอร์ผ่าน /api/v2/orders/public/create
ทันทีที่ได้รับ orderId ระบบจะเรียก /api/v2/orders/public/set-email เพื่อเพิ่มอีเมล
เมื่อมีการฝากหรือถอนเงิน Quickex จะส่งการแจ้งเตือนไปยัง userEmail ที่ระบุ

Code Sample

Response Example

[
  {
    "orderId": 2096,
    "destinationAddress": "rMZiLhMHDKHSD9mMurzvixQGKFsDNLLP1",
    "createdAt": "2024-11-21T09:57:37.536Z",
    "updatedAt": "2024-11-21T09:57:37.536Z",
    "destinationAddressMemo": null,
    "refundAddress": null,
    "refundAddressMemo": null,
    "claimedDepositAmount": "11905.4",
    "claimedNetworkFee": "0.25",
    "amountToGet": "2000.535980286546",
    "amountToGetUSDT": "0",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "TRX",
    "instrumentFromNetworkTitle": "TRX",
    "instrumentToCurrencyTitle": "XRP",
    "instrumentToNetworkTitle": "XRP",
    "ip": "165.22.73.162",
    "geoCode": "DE",
    "markup": "0",
    "userEmail": "qa@support.quickex.io",
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 2097,
    "destinationAddress": "rMZiLhMHDKHSD9mMurzvixQGKFsDNLLP1",
    "createdAt": "2024-11-21T09:57:56.849Z",
    "updatedAt": "2024-11-21T09:57:56.849Z",
    "destinationAddressMemo": null,
    "refundAddress": null,
    "refundAddressMemo": null,
    "claimedDepositAmount": "500",
    "claimedNetworkFee": "0.25",
    "amountToGet": "88.201060256891",
    "amountToGetUSDT": "0",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "TRX",
    "instrumentFromNetworkTitle": "TRX",
    "instrumentToCurrencyTitle": "XRP",
    "instrumentToNetworkTitle": "XRP",
    "ip": "165.22.73.162",
    "geoCode": "DE",
    "markup": "0",
    "userEmail": "qa@support.quickex.io",
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 3038,
    "destinationAddress": "TFjfHBiDcL6B5S5W8g9b6gU2tbvnTR52ya",
    "createdAt": "2025-04-28T13:15:03.006Z",
    "updatedAt": "2025-07-22T10:36:58.557Z",
    "destinationAddressMemo": null,
    "refundAddress": null,
    "refundAddressMemo": null,
    "claimedDepositAmount": "0.034268",
    "claimedNetworkFee": "1.5",
    "amountToGet": "3263.05",
    "amountToGetUSDT": "3263.058154",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "BTC",
    "instrumentFromNetworkTitle": "BTC",
    "instrumentToCurrencyTitle": "USDT",
    "instrumentToNetworkTitle": "TRC20",
    "ip": "45.76.90.73",
    "geoCode": "DE",
    "markup": "0",
    "userEmail": "qa@support.quickex.io",
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 3172,
    "destinationAddress": "TPjT9p6UK5omA19h1QuYf4HbWvB9CukMzx",
    "createdAt": "2025-11-25T07:52:52.871Z",
    "updatedAt": "2025-11-27T11:34:19.690Z",
    "destinationAddressMemo": null,
    "refundAddress": null,
    "refundAddressMemo": null,
    "claimedDepositAmount": "52",
    "claimedNetworkFee": "2.054188275293",
    "amountToGet": "419.2",
    "amountToGetUSDT": "114.402051690569",
    "amountToWithdrawFact": "417.825363",
    "amountToWithdrawFactUSDT": "114.0245415627",
    "instrumentFromCurrencyTitle": "XRP",
    "instrumentFromNetworkTitle": "XRP",
    "instrumentToCurrencyTitle": "TRX",
    "instrumentToNetworkTitle": "TRX",
    "ip": "77.246.100.22",
    "geoCode": "NL",
    "markup": "0",
    "userEmail": "qa@support.quickex.io",
    "completed": true,
    "state": "withdraw"
  },
  {
    "orderId": 3192,
    "destinationAddress": "15vvDFQFksUS4r1cYxmjZuTVVUzWZSJauuUapg7Xjhgtkwqy",
    "createdAt": "2025-12-02T14:11:15.985Z",
    "updatedAt": "2025-12-02T14:11:16.107Z",
    "destinationAddressMemo": null,
    "refundAddress": "UQCGxjLy3msAFWG4r310Sk_rOz27QWRy252fdLMWJAMQJvSE",
    "refundAddressMemo": null,
    "claimedDepositAmount": "3300",
    "claimedNetworkFee": "0.14",
    "amountToGet": "2363.663",
    "amountToGetUSDT": "4999.384629917638",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "TON",
    "instrumentFromNetworkTitle": "TON",
    "instrumentToCurrencyTitle": "DOT",
    "instrumentToNetworkTitle": "DOT",
    "ip": "77.246.100.22",
    "geoCode": "NL",
    "markup": "0",
    "userEmail": null,
    "completed": false,
    "state": "created"
  },
  {
    "orderId": 3193,
    "destinationAddress": "15vvDFQFksUS4r1cYxmjZuTVVUzWZSJauuUapg7Xjhgtkwqy",
    "createdAt": "2025-12-02T14:14:34.356Z",
    "updatedAt": "2025-12-02T14:14:34.557Z",
    "destinationAddressMemo": null,
    "refundAddress": "UQCGxjLy3msAFWG4r310Sk_rOz27QWRy252fdLMWJAMQJvSE",
    "refundAddressMemo": null,
    "claimedDepositAmount": "73",
    "claimedNetworkFee": "0.14",
    "amountToGet": "52.235",
    "amountToGetUSDT": "110.556162356583",
    "amountToWithdrawFact": "0",
    "amountToWithdrawFactUSDT": "0",
    "instrumentFromCurrencyTitle": "TON",
    "instrumentFromNetworkTitle": "TON",
    "instrumentToCurrencyTitle": "DOT",
    "instrumentToNetworkTitle": "DOT",
    "ip": "77.246.100.22",
    "geoCode": "NL",
    "markup": "0",
    "userEmail": null,
    "completed": false,
    "state": "created"
  }
]

Try it out

POST

orders/public/create

Endpoint URL

https://quickex.io/api/v2/orders/public/create

Documentation

คำอธิบายทั่วไป
Endpoint นี้ใช้สำหรับสร้างออเดอร์ใหม่เพื่อแลกเปลี่ยนสกุลเงินดิจิทัล โดยจะส่งคืนข้อมูลออเดอร์แบบเต็ม: ที่อยู่ฝากและถอน พารามิเตอร์อัตรา เหตุการณ์ และ URL สำหรับการประมวลผลเพิ่มเติม

พารามิเตอร์

ส่วนหัว (Headers)

ชื่อ	จำเป็น	คำอธิบาย
`X-Api-Public-Key`	ใช่	กุญแจ API สาธารณะของคุณ
`X-Api-Timestamp`	ใช่	Timestamp ในรูปแบบ UNIX (ms)
`X-Api-Signature`	ใช่	ลายเซ็น HMAC ของเนื้อหาคำขอ สร้างโดยใช้กุญแจลับของคุณ

เนื้อหาคำขอ (JSON)

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
`instrumentFrom`	object	ใช่	สกุลเงินและเครือข่ายต้นทาง (`currencyTitle` / `networkTitle`)
`instrumentTo`	object	ใช่	สกุลเงินและเครือข่ายปลายทาง
`destinationAddress`	string	ใช่	ที่อยู่สำหรับรับสินทรัพย์หลังการแลกเปลี่ยน
`destinationAddressMemo`	string	ไม่จำเป็น	Memo/แท็กเพิ่มเติมสำหรับที่อยู่ปลายทาง
`refundAddress`	string	ใช่	ที่อยู่สำหรับการคืนเงินหากเกิดข้อผิดพลาดในการแลกเปลี่ยน
`refundAddressMemo`	string	ไม่จำเป็น	Memo/แท็กสำหรับที่อยู่คืนเงิน
`claimedDepositAmount`	string	ใช่	จำนวนเงินที่ผู้ใช้ตั้งใจจะฝาก
`claimedPublicRate`	object	ไม่จำเป็น	ข้อมูลอัตราที่ผู้ใช้ยืนยัน: ราคา เวลาอัพเดต และจำนวนที่คาดว่าจะได้รับ
`claimedNetworkFee`	string	ไม่จำเป็น	ค่าธรรมเนียมเครือข่ายที่ผู้ใช้ยืนยัน
`userEmail`	string	ไม่จำเป็น	อีเมลสำหรับรับการแจ้งเตือน
`legacyOrderId`	string	ไม่จำเป็น	หมายเลขออเดอร์จากระบบเดิม
`referrerId`	string	ไม่จำเป็น	ID ผู้แนะนำสำหรับโปรแกรมพันธมิตร
`markupAffiliateId`	string	ไม่จำเป็น	ID พันธมิตรสำหรับการแบ่งมาร์กอัป
`rateMode`	string	ไม่จำเป็น	ประเภทอัตรา: `FLOATING` หรือ `FIXED`
`utmData`	object	ไม่จำเป็น	ข้อมูล UTM สำหรับการวิเคราะห์
`browserFingerprint`	string	ไม่จำเป็น	ลายนิ้วมือของเบราว์เซอร์สำหรับป้องกันการทุจริต
`markup`	string	ไม่จำเป็น	เปอร์เซ็นต์ของมาร์กอัป
`mercuryoBearerToken`	string	ไม่จำเป็น	โทเคน Mercuryo สำหรับการเชื่อมต่อเพิ่มเติม
`locale`	string	ไม่จำเป็น	ภาษาของคำตอบ (เช่น `en`, `ru`)

ตัวอย่างคำขอ

curl -X POST 'https://quickex.io/api/v2/orders/public/create' \
  -H 'accept: application/json' \
  -H 'X-Api-Public-Key: yourPublicKey' \
  -H 'X-Api-Timestamp: 1691397873000' \
  -H 'X-Api-Signature: yourHmacSignature' \
  -H 'Content-Type: application/json' \
  -d '{
    "instrumentFrom": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    },
    "instrumentTo": {
      "currencyTitle": "LTC",
      "networkTitle": "LTC"
    },
    "destinationAddress": "MWYK4uQXFvWc1Bj1CPACyX5HTQxUUpRZ2e",
    "refundAddress": "TFe5tdqSy8CMGMDVHPJHLTK8hrAL6ddUpD",
    "claimedDepositAmount": "3300",
    "claimedPublicRate": {
      "price": "0.014271620139287839394",
      "updatedAt": "2024-02-13T14:43:12.983Z",
      "claimedAmountToReceive": "47.09634645964987"
    },
    "claimedNetworkFee": "0.001",
    "userEmail": "test@example.com",
    "referrerId": "aff_some-affiliate-id",
    "markupAffiliateId": "aff_some-affiliate-id",
    "rateMode": "FLOATING",
    "markup": "0.01",
    "mercuryoBearerToken": "string",
    "locale": "ru"
  }'

การตอบสนองที่เป็นไปได้

200 OK — สร้างออเดอร์สำเร็จและส่งคืนข้อมูลออเดอร์ทั้งหมด
401 ERR_UNAUTHORIZED — ไม่มีหรือใช้โทเคน/คีย์ไม่ถูกต้อง:

{
  "status": "ERR_UNAUTHORIZED",
  "message": "Unauthorized"
}

กรณีการใช้งาน

แพลตฟอร์มพันธมิตรต้องการสร้างออเดอร์โดยอัตโนมัติเมื่อผู้ใช้ชำระเงินผ่าน Mercuryo
หลังจากการยืนยันตัวตน Mercuryo ส่ง B2B-Bearer-Token ให้ จากนั้นแพลตฟอร์มจะจัดเตรียมข้อมูลการแลกเปลี่ยนและเรียก endpoint นี้เพื่อสร้างออเดอร์บน Quickex

Code Sample

Response Example

{
  "deposits": [
    {
      "createdAt": "2025-12-02T08:52:08.178Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "confirmations": 0,
      "txId": "0xdeadc0dedeadbeef",
      "depositAddress": "0xdeadc0de",
      "isPending": true,
      "id": 0,
      "counterPartyAddress": "0xdeadc0dedeadbeef"
    }
  ],
  "withdrawals": [
    {
      "createdAt": "2025-12-02T08:52:08.178Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "networkFee": "1.1",
      "txId": "0xdeadc0dedeadbeef"
    }
  ],
  "depositAddress": {
    "orderId": 0,
    "liquidityProviderTitle": "QUICKEX_BUSINESS_ACCOUNT",
    "instrument": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    },
    "depositAddress": "0xdeadc0de",
    "depositAddressMemo": "string",
    "redirectUrl": "string"
  },
  "orderId": 0,
  "userId": 0,
  "legacyOrderId": "string",
  "pair": {
    "instrumentFrom": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    }
  },
  "createdAt": "2025-12-02T08:52:08.179Z",
  "claimedDepositAmount": "10.01",
  "amountToGet": "10.01",
  "claimedPublicRate": {
    "price": "1000.1",
    "quotes": {
      "sellQuote": {
        "baseValue": "1000.1",
        "quoteValue": "1000.1"
      },
      "buyQuote": {
        "baseValue": "1000.1",
        "quoteValue": "1000.1"
      }
    },
    "updatedAt": "2025-12-02T08:52:08.179Z",
    "liquidityProviderPublicCode": "formulae",
    "claimedAmountToReceive": "0.01",
    "finalNetworkFeeAmount": "0.01",
    "platformFee_Absolute": "0.01",
    "fixedRate_maxAmount": "1000.000",
    "fixedRate_maxTimeMinutes": 1,
    "fixedRate_maxRateVolatilityPercent": "1000.000"
  },
  "claimedNetworkFee": "10.01",
  "KYCFormLink": "string",
  "orderEvents": [
    {
      "kind": "TRACKING_STARTED",
      "createdAt": "2025-12-02T08:52:08.179Z"
    }
  ],
  "userEmail": "test@example.com",
  "rateMode": "FLOATING",
  "destinationAddress": "0xdeadbeef",
  "destinationAddressMemo": "0xdeadbeef",
  "completed": false,
  "possibleCashbackAmountUSDT": "500.00",
  "redirectUrl": "https://payments.mercuryo.io/",
  "minConfirmationsToTrade": 3,
  "minConfirmationsToWithdraw": 3
}

Try it out

POST

orders/public/set-email

Endpoint URL

https://quickex.io/api/v2/orders/public/set-email

Documentation

ภาพรวม

เมธอดนี้ช่วยให้คุณสามารถกำหนดอีเมลสำหรับออร์เดอร์สาธารณะที่ถูกสร้างไว้แล้วได้

มักใช้ในกรณีที่ออร์เดอร์ถูกสร้างขึ้นมาโดยไม่มีค่า userEmail ในคำขอ /api/v2/orders/public/create แต่ภายหลังต้องการผูกอีเมลเข้ากับออร์เดอร์ (เช่น เพื่อให้ผู้ใช้ได้รับการแจ้งเตือนเกี่ยวกับสถานะออร์เดอร์)

> สำคัญ: อีเมลสามารถถูกกำหนดได้เพียงครั้งเดียวเท่านั้น หากออร์เดอร์มีค่า userEmail อยู่แล้ว จะไม่สามารถเปลี่ยนแปลงผ่านเมธอดนี้ได้

HTTP Request

Method: POST
URL: https://quickex.io/api/v2/orders/public/set-email

ตัวอย่างคำขอ

curl -X 'POST' \ 'https://quickex.io/api/v2/orders/public/set-email' \ -H 'accept: application/json' \ -H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \ -H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \ -H 'X-Api-Signature: {SIGNATURE}' \ -H 'Content-Type: application/json' \ -d '{ "orderId": 3038, "userEmail": "QA@quickex.com" }'

Headers

Header	Required	Description
`Accept`	yes	ค่าที่แนะนำ: `application/json`.
`Content-Type`	yes	ควรเป็น `application/json`.
`X-Api-Public-Key`	yes	Public API key ของคุณ
`X-Api-Timestamp`	yes	ค่า timestamp (ปกติเป็น UNIX ในหน่วยมิลลิวินาที) ที่ถูกนำไปใช้ในลายเซ็น
`X-Api-Signature`	yes	ลายเซ็นของคำขอ (HMAC SHA256 ตามสกีมาของ API v2)

Request Parameters

Body Parameters

{ "orderId": 3038, "userEmail": "QA@quickex.com" }

Field	Type	Required	Description
`orderId`	number	yes	ID ของออร์เดอร์ที่คุณต้องการกำหนดอีเมลให้
`userEmail`	string	yes	อีเมลของผู้ใช้ที่จะถูกผูกกับออร์เดอร์และใช้สำหรับการแจ้งเตือน

ข้อจำกัด: หาก userEmail ถูกกำหนดไว้แล้วสำหรับออร์เดอร์นี้ เมธอดจะส่งข้อผิดพลาด 403 ERR_FORBIDDEN กลับมา

Response Format

หากคำขอสำเร็จ เมธอดจะส่งกลับเป็นออบเจ็กต์ JSON ของออร์เดอร์ ลักษณะเดียวกับการตอบกลับของ POST /api/v2/orders/public/create / GET /api/v2/orders/info แต่มีการกำหนดฟิลด์ userEmail แล้ว

ตัวอย่าง Response

{ "deposits": [ { "createdAt": "2025-12-02T09:31:46.246Z", "instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" }, "amount": "1000.1", "confirmations": 0, "txId": "0xdeadc0dedeadbeef", "depositAddress": "0xdeadc0de", "isPending": true, "id": 0, "counterPartyAddress": "0xdeadc0dedeadbeef" } ], "withdrawals": [ { "createdAt": "2025-12-02T09:31:46.246Z", "instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" }, "amount": "1000.1", "networkFee": "1.1", "txId": "0xdeadc0dedeadbeef" } ], "depositAddress": { "orderId": 0, "liquidityProviderTitle": "QUICKEX_BUSINESS_ACCOUNT", "instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" }, "depositAddress": "0xdeadc0de", "depositAddressMemo": "string", "redirectUrl": "string" }, "orderId": 0, "userId": 0, "legacyOrderId": "string", "pair": { "instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" }, "instrumentTo": { "currencyTitle": "USDT", "networkTitle": "TRC20" } }, "createdAt": "2025-12-02T09:31:46.246Z", "claimedDepositAmount": "10.01", "amountToGet": "10.01", "claimedPublicRate": { "price": "1000.1", "quotes": { "sellQuote": { "baseValue": "1000.1", "quoteValue": "1000.1" }, "buyQuote": { "baseValue": "1000.1", "quoteValue": "1000.1" } }, "updatedAt": "2025-12-02T09:31:46.246Z", "liquidityProviderPublicCode": "formulae", "claimedAmountToReceive": "0.01", "finalNetworkFeeAmount": "0.01", "platformFee_Absolute": "0.01", "fixedRate_maxAmount": "1000.000", "fixedRate_maxTimeMinutes": 1, "fixedRate_maxRateVolatilityPercent": "1000.000" }, "claimedNetworkFee": "10.01", "KYCFormLink": "string", "orderEvents": [ { "kind": "TRACKING_STARTED", "createdAt": "2025-12-02T09:31:46.246Z" } ], "userEmail": "QA@example.com", "rateMode": "FLOATING", "destinationAddress": "0xdeadbeef", "destinationAddressMemo": "0xdeadbeef", "completed": false, "possibleCashbackAmountUSDT": "500.00", "redirectUrl": "https://payments.mercuryo.io/", "minConfirmationsToTrade": 3, "minConfirmationsToWithdraw": 3 }

จุดสำคัญ: ฟิลด์ userEmail ที่เชื่อมกับออร์เดอร์จะถูกเติมอยู่ใน response

Errors

403 ERR_FORBIDDEN — Email ถูกตั้งค่าแล้ว

{ "status": "ERR_FORBIDDEN", "message": "Order.userEmail already set and can not be modified" }

ข้อผิดพลาดนี้จะถูกส่งกลับ หากคุณพยายามเปลี่ยนอีเมลของออร์เดอร์ที่มีค่า userEmail ถูกตั้งค่าไว้แล้ว (ทั้งในตอนสร้างออร์เดอร์หรือจากการเรียก set-email มาก่อนหน้า)

ควรทำอย่างไร:

ไม่สามารถเปลี่ยนอีเมลได้สำหรับออร์เดอร์ที่มีอีเมลถูกตั้งค่าไว้แล้ว

กรณีการใช้งานที่เป็นไปได้

ใช้เพิ่มอีเมลให้กับออร์เดอร์ที่ถูกสร้างแบบไม่ระบุอีเมล (เช่น ผ่านวิดเจ็ตที่ไม่ได้บังคับกรอกอีเมล)

Code Sample

Response Example

{
  "deposits": [
    {
      "createdAt": "2025-12-02T09:31:46.246Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "confirmations": 0,
      "txId": "0xdeadc0dedeadbeef",
      "depositAddress": "0xdeadc0de",
      "isPending": true,
      "id": 0,
      "counterPartyAddress": "0xdeadc0dedeadbeef"
    }
  ],
  "withdrawals": [
    {
      "createdAt": "2025-12-02T09:31:46.246Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "networkFee": "1.1",
      "txId": "0xdeadc0dedeadbeef"
    }
  ],
  "depositAddress": {
    "orderId": 0,
    "liquidityProviderTitle": "QUICKEX_BUSINESS_ACCOUNT",
    "instrument": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    },
    "depositAddress": "0xdeadc0de",
    "depositAddressMemo": "string",
    "redirectUrl": "string"
  },
  "orderId": 0,
  "userId": 0,
  "legacyOrderId": "string",
  "pair": {
    "instrumentFrom": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    }
  },
  "createdAt": "2025-12-02T09:31:46.246Z",
  "claimedDepositAmount": "10.01",
  "amountToGet": "10.01",
  "claimedPublicRate": {
    "price": "1000.1",
    "quotes": {
      "sellQuote": {
        "baseValue": "1000.1",
        "quoteValue": "1000.1"
      },
      "buyQuote": {
        "baseValue": "1000.1",
        "quoteValue": "1000.1"
      }
    },
    "updatedAt": "2025-12-02T09:31:46.246Z",
    "liquidityProviderPublicCode": "formulae",
    "claimedAmountToReceive": "0.01",
    "finalNetworkFeeAmount": "0.01",
    "platformFee_Absolute": "0.01",
    "fixedRate_maxAmount": "1000.000",
    "fixedRate_maxTimeMinutes": 1,
    "fixedRate_maxRateVolatilityPercent": "1000.000"
  },
  "claimedNetworkFee": "10.01",
  "KYCFormLink": "string",
  "orderEvents": [
    {
      "kind": "TRACKING_STARTED",
      "createdAt": "2025-12-02T09:31:46.246Z"
    }
  ],
  "userEmail": "QA@example.com",
  "rateMode": "FLOATING",
  "destinationAddress": "0xdeadbeef",
  "destinationAddressMemo": "0xdeadbeef",
  "completed": false,
  "possibleCashbackAmountUSDT": "500.00",
  "redirectUrl": "https://payments.mercuryo.io/",
  "minConfirmationsToTrade": 3,
  "minConfirmationsToWithdraw": 3
}

Try it out

GET

orders/public-info

Endpoint URL

/api/v2/orders/public-info

Documentation

ภาพรวม

เมธอดนี้จะส่งคืนข้อมูลรายละเอียดของออเดอร์ที่ระบุด้วย orderId
แตกต่างจากรายการออเดอร์ (GET /api/v2/orders) ตรงที่มันจะส่งคืนข้อมูลทั้งหมดที่เกี่ยวข้องกับออเดอร์ที่เลือก:
คู่ของอินสตรูเมนต์แบบครบถ้วนพร้อมพารามิเตอร์ อัตราคงที่ (claimedPublicRate)
ขีดจำกัดการยืนยัน (confirmations) ประวัติเหตุการณ์ (orderEvents) ที่อยู่สำหรับฝาก
รวมถึงข้อมูลเกี่ยวกับแคชแบ็กที่เป็นไปได้หรือการสะสมจากการแนะนำ และสถานะการเสร็จสิ้น
การเข้าถึงออเดอร์ถูกจำกัดตามคีย์ API ปัจจุบัน: คุณสามารถดูได้เฉพาะออเดอร์ที่ถูกสร้างขึ้น
โดยใช้ X-Api-Public-Key ของคุณเท่านั้น

คำขอ HTTP

Method: GET
URL: https://quickex.io/api/v2/orders/public-info

ตัวอย่างคำขอ

curl -X 'GET' \
  'https://quickex.io/api/v2/orders/public-info?orderId=3038' \
  -H 'accept: application/json' \
  -H 'X-Api-Public-Key: {YOUR_PUBLIC_KEY}' \
  -H 'X-Api-Timestamp: {UNIX_MS_TIMESTAMP}' \
  -H 'X-Api-Signature: {SIGNATURE}'

Headers

Header	ต้องระบุ	คำอธิบาย
Accept	ใช่	ค่าที่แนะนำ: `application/json`.
X-Api-Public-Key	ใช่	คีย์สาธารณะของ API ของคุณ
X-Api-Timestamp	ใช่	ตราประทับเวลา (โดยปกติเป็น UNIX หน่วยมิลลิวินาที) ซึ่งถูกรวมไว้ในลายเซ็น
X-Api-Signature	ใช่	ลายเซ็นคำขอ (HMAC SHA256 ตามสคีม API v2)

พารามิเตอร์คำขอ

พารามิเตอร์ Query

พารามิเตอร์	ชนิด	ต้องระบุ	คำอธิบาย
orderId	int	ใช่	ตัวระบุของออเดอร์ที่ต้องการดึงข้อมูล

รูปแบบการตอบกลับ

เมธอดจะส่งคืน อ็อบเจ็กต์ JSON พร้อมข้อมูลครบถ้วนของออเดอร์

ตัวอย่างการตอบกลับ

{
  "orderId": 174059,
  "legacyOrderId": "602184da-5881-408e-bffa-3562702d7d3e",
  "pair": {
    "instrumentFrom": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP",
      "precisionDecimals": 2,
      "slug": "xrp",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 12,
          "minConfirmationsToWithdraw": 12
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "TRX",
      "networkTitle": "TRX",
      "precisionDecimals": 2,
      "slug": "trx",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },
  "createdAt": "2025-12-15T14:38:40.523Z",
  "instrumentFromCurrencyTitle": "XRP",
  "instrumentFromNetworkTitle": "XRP",
  "instrumentToCurrencyTitle": "TRX",
  "instrumentToNetworkTitle": "TRX",
  "feeMode": "FIXED",
  "userId": 2382,
  "userEmail": "sam.white@support.example.io",
  "isPlatformEmail": false,
  "refundAddress": "rNFSruW9B1NwVoGgUMmfwXbruWMp8Mgv3K",
  "refundAddressMemo": null,
  "destinationAddress": "TWRW8YiZtjW7JkYxxzuPrN9fQzoDK5FHgm",
  "destinationAddressMemo": null,
  "claimedNetworkFee": "1.987665024814",
  "rateMode": "FIXED",
  "claimedDepositAmount": "57",
  "amountToGet": "393.07",
  "platformFee": "3.86",
  "redirectUrl": null,
  "orderEvents": [
    {
      "createdAt": "2025-12-15T14:42:43.317Z",
      "kind": "WITHDRAWAL_COMPLETED"
    },
    {
      "createdAt": "2025-12-15T14:41:54.109Z",
      "kind": "FUNDS_WITHDRAWAL_START"
    },
    {
      "createdAt": "2025-12-15T14:41:00.379Z",
      "kind": "DEPOSIT_REGISTERED"
    },
    {
      "createdAt": "2025-12-15T14:39:58.760Z",
      "kind": "INCOMING_FUNDS_DETECTED"
    },
    {
      "createdAt": "2025-12-15T14:38:41.642Z",
      "kind": "CREATION_END"
    }
  ],
  "depositAddress": {
    "instrument": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP"
    },
    "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
    "depositAddressMemo": "2097040307"
  },
  "deposits": [
    {
      "id": 50958,
      "counterPartyAddress": null,
      "createdAt": "2025-12-15T14:39:45.000Z",
      "instrument": {
        "currencyTitle": "XRP",
        "networkTitle": "XRP"
      },
      "amount": "57",
      "amountUSDT": "112.40742",
      "txId": "DEA15CCF7AF04799A090298CB06D78DD177B3B518BED9C9DE8A0A5B717CCDBE7",
      "confirmations": 12,
      "depositAddress": {
        "instrument": {
          "currencyTitle": "XRP",
          "networkTitle": "XRP"
        },
        "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
        "depositAddressMemo": "2097040307"
      },
      "isPending": false
    }
  ],
  "withdrawals": [
    {
      "instrument": {
        "currencyTitle": "TRX",
        "networkTitle": "TRC20"
      },
      "amount": "393.07",
      "txId": "39dc5802a931da0613f687087397e812dd6c0aa0b9041124d76e864e37bd1e09",
      "createdAt": "2025-12-15T14:41:58.926Z",
      "networkFee": "1.98"
    }
  ],
  "KYCFormLink": null,
  "liquidityProviderPublicCode": "hat",
  "possibleRefferalAccrualAmount": "0.78",
  "possibleCashbackAmountUSDT": "0.22",
  "actualCashbackAmountUSDT": "0.22",
  "claimedPublicRate": {
    "claimedAmountToReceive": "393.07",
    "finalNetworkFeeAmount": "1.9876650248138958",
    "platformFee_Absolute": null,
    "price": "7.000992555831266",
    "quotes": {
      "sellQuote": {
        "baseValue": "0.2821",
        "quoteValue": "1.9453930016929823"
      },
      "buyQuote": {
        "baseValue": "1.97499",
        "quoteValue": "0.2777753832835882"
      }
    },
    "updatedAt": "2025-12-15T14:38:36.201Z",
    "instrumentFrom": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP",
      "precisionDecimals": 2,
      "slug": "xrp",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 12,
          "minConfirmationsToWithdraw": 12
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "TRX",
      "networkTitle": "TRX",
      "precisionDecimals": 2,
      "slug": "trx",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },
  "completed": true,
  "minConfirmationsToTrade": 12,
  "minConfirmationsToWithdraw": 12
}

การอธิบายฟิลด์ของการตอบกลับ

ด้านล่างคือฟิลด์สำคัญของการตอบกลับ โครงสร้างที่ซ้อนกันบางส่วน (เช่น instrumentFrom / instrumentTo) มีโครงสร้างคล้ายกับอ็อบเจ็กต์จากเมธอด /instruments และ /rates

ข้อมูลทั่วไปของออเดอร์

ฟิลด์	ชนิด	คำอธิบาย
orderId	number	ตัวระบุออเดอร์ที่ไม่ซ้ำกันในระบบ Quickex
legacyOrderId	string	ตัวระบุออเดอร์ในระบบเดิม (ถ้าใช้เพื่อการย้าย/ความเข้ากันได้)
createdAt	string	เวลาที่สร้างออเดอร์ (ISO8601)
instrumentFromCurrencyTitle	string	โค้ดสกุลเงินต้นทาง (เช่น `BTC`)
instrumentFromNetworkTitle	string	เครือข่ายต้นทาง (เช่น `BTC`)
instrumentToCurrencyTitle	string	โค้ดสกุลเงินปลายทาง (เช่น `USDT`)
instrumentToNetworkTitle	string	เครือข่ายปลายทาง (เช่น `TRC20`)
feeMode	string	โหมดค่าธรรมเนียมของออเดอร์: • `FLOATING` – ค่าธรรมเนียมอาจเปลี่ยนแปลงตามสภาพเครือข่ายหรือประเภทตลาด • `FIXED` – ค่าธรรมเนียมถูกล็อกไว้ตอนสร้างออเดอร์
rateMode	string	โหมดอัตราแลกเปลี่ยน: • `FIXED` – ล็อกอัตราเมื่อสร้างออเดอร์ จำนวนที่จะได้รับไม่เปลี่ยน • `FLOATING` – อัตราอาจผันผวนจนกว่าจะจบออเดอร์ จำนวนที่จะได้รับจะอัปเดตตามตลาดปัจจุบัน
claimedDepositAmount	string	จำนวนเงินฝากที่ใช้ตอนสร้างออเดอร์
amountToGet	string	จำนวนที่ผู้ใช้ควรได้รับจากออเดอร์นี้
claimedNetworkFee	string	ค่าธรรมเนียมเครือข่ายที่ถูกนำไปคำนวณในออเดอร์
platformFee	string	ค่าธรรมเนียมแพลตฟอร์ม
redirectUrl	string	URL สำหรับเปลี่ยนเส้นทางไปยังบริการภายนอก
completed	boolean	แฟลกการเสร็จสิ้นออเดอร์: `true` — แลกเปลี่ยนเสร็จสิ้น, `false` — กำลังดำเนินการ
minConfirmationsToTrade	number	จำนวนยืนยันขั้นต่ำเพื่อให้เงินฝากพร้อมสำหรับการแลกเปลี่ยน
minConfirmationsToWithdraw	number	จำนวนยืนยันขั้นต่ำที่ต้องมีสำหรับการถอน

คู่ของอินสตรูเมนต์ (pair)

  "pair": {
    "instrumentFrom": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP",
      "precisionDecimals": 2,
      "slug": "xrp",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 12,
          "minConfirmationsToWithdraw": 12
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "TRX",
      "networkTitle": "TRX",
      "precisionDecimals": 2,
      "slug": "trx",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },

ฟิลด์	ชนิด	คำอธิบาย
instrumentFrom	object	อินสตรูเมนต์ต้นทาง: สกุลเงินที่ผู้ใช้ส่ง
instrumentFrom.currencyTitle	string	โค้ดสกุลเงินของอินสตรูเมนต์ต้นทาง (เช่น XRP)
instrumentFrom.networkTitle	string	เครือข่ายบล็อกเชนของอินสตรูเมนต์ต้นทาง
instrumentFrom.precisionDecimals	number	จำนวนตำแหน่งทศนิยมที่รองรับสำหรับจำนวนเงิน
instrumentFrom.slug	string	ตัวระบุภายในของสกุลเงิน
instrumentFrom.liquidityProviderCurrencies	array	การตั้งค่าผู้ให้บริการสภาพคล่องสำหรับสกุลเงินและเครือข่ายนี้
instrumentFrom.liquidityProviderCurrencies.minConfirmationsToTrade	number	การยืนยันขั้นต่ำเพื่อใช้เงินฝากในการแลกเปลี่ยน
instrumentFrom.liquidityProviderCurrencies.minConfirmationsToWithdraw	number	การยืนยันขั้นต่ำก่อนอนุญาตให้ถอน
instrumentTo	object	อินสตรูเมนต์ปลายทาง: สกุลเงินที่ผู้ใช้ได้รับ
instrumentTo.currencyTitle	string	โค้ดสกุลเงินของอินสตรูเมนต์ปลายทาง (เช่น TRX)
instrumentTo.networkTitle	string	เครือข่ายบล็อกเชนของอินสตรูเมนต์ปลายทาง
instrumentTo.precisionDecimals	number	จำนวนตำแหน่งทศนิยมที่รองรับสำหรับจำนวนเงิน
instrumentTo.slug	string	ตัวระบุภายในของสกุลเงิน
instrumentTo.liquidityProviderCurrencies	array	การตั้งค่าผู้ให้บริการสภาพคล่องสำหรับสกุลเงินและเครือข่ายนี้
instrumentTo.liquidityProviderCurrencies.minConfirmationsToTrade	number	การยืนยันขั้นต่ำก่อนที่เงินจะสามารถถูกแลกเปลี่ยนได้
instrumentTo.liquidityProviderCurrencies.minConfirmationsToWithdraw	number	การยืนยันขั้นต่ำก่อนที่เงินจะสามารถถูกถอนได้

orderEvents

  "orderEvents": [
    {
      "createdAt": "2025-12-15T14:42:43.317Z",
      "kind": "WITHDRAWAL_COMPLETED"
    },
    {
      "createdAt": "2025-12-15T14:41:54.109Z",
      "kind": "FUNDS_WITHDRAWAL_START"
    },
    {
      "createdAt": "2025-12-15T14:41:00.379Z",
      "kind": "DEPOSIT_REGISTERED"
    },
    {
      "createdAt": "2025-12-15T14:39:58.760Z",
      "kind": "INCOMING_FUNDS_DETECTED"
    },
    {
      "createdAt": "2025-12-15T14:38:41.642Z",
      "kind": "CREATION_END"
    }
  ],

ฟิลด์	ชนิด	คำอธิบาย
orderEvents	array	รายการเหตุการณ์ที่อธิบายวงจรชีวิตของออเดอร์ตามลำดับเวลา
orderEvents[].createdAt	string (ISO 8601)	ตราประทับเวลาที่เกิดเหตุการณ์
orderEvents[].kind	string	ชนิดของเหตุการณ์ออเดอร์

ค่าที่เป็นไปได้ของ orderEvents[].kind

ค่า	คำอธิบาย
CREATION_END	สร้างออเดอร์สำเร็จ
INCOMING_FUNDS_DETECTED	ตรวจพบธุรกรรมฝากเข้าบนบล็อกเชน
DEPOSIT_REGISTERED	เงินฝากได้รับการยืนยันที่ต้องการและถูกเครดิตแล้ว
FUNDS_WITHDRAWAL_START	เริ่มต้นธุรกรรมถอนเงิน
WITHDRAWAL_COMPLETED	ส่งเงินไปยังที่อยู่ปลายทางสำเร็จ

อ็อบเจ็กต์ depositAddress

  "depositAddress": {
    "instrument": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP"
    },
    "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
    "depositAddressMemo": "2097040307"
  },

ฟิลด์	ชนิด	คำอธิบาย
depositAddress	object	รายละเอียดการฝากสำหรับอินสตรูเมนต์ต้นทาง
depositAddress.instrument	object	อินสตรูเมนต์และเครือข่ายที่ใช้สำหรับการฝาก
depositAddress.instrument.currencyTitle	string	โค้ดสกุลเงินของอินสตรูเมนต์ฝาก (เช่น XRP)
depositAddress.instrument.networkTitle	string	เครือข่ายบล็อกเชนที่ใช้สำหรับการฝาก
depositAddress.depositAddress	string	ที่อยู่บล็อกเชนที่ผู้ใช้ต้องส่งเงินไป
depositAddress.depositAddressMemo	string \| null	Memo / tag ที่จำเป็นสำหรับการฝาก (เช่น XRP Destination Tag) ต้องระบุหากมีให้มา

อาร์เรย์ deposits

"deposits": [
  {
    "id": 50958,
    "counterPartyAddress": null,
    "createdAt": "2025-12-15T14:39:45.000Z",
    "instrument": {
      "currencyTitle": "XRP",
      "networkTitle": "XRP"
    },
    "amount": "57",
    "amountUSDT": "112.40742",
    "txId": "DEA15CCF7AF04799A090298CB06D78DD177B3B518BED9C9DE8A0A5B717CCDBE7",
    "confirmations": 12,
    "depositAddress": {
      "instrument": {
        "currencyTitle": "XRP",
        "networkTitle": "XRP"
      },
      "depositAddress": "rwXnv8BfEHi7WmkLXZ6ChcWX9hMnSsTMNK",
      "depositAddressMemo": "2097040307"
    },
    "isPending": false
  }
]

ฟิลด์	ชนิด	คำอธิบาย
deposits[]	array	รายการธุรกรรมฝากที่เชื่อมโยงกับออเดอร์
deposits[].id	number	ตัวระบุภายในของธุรกรรมฝาก
deposits[].counterPartyAddress	string \| null	ที่อยู่ของคู่สัญญาที่ส่งเงินฝาก (ถ้าทราบ)
deposits[].createdAt	string (ISO 8601)	เวลาที่บันทึกธุรกรรมฝากในระบบ
deposits[].instrument	object	อินสตรูเมนต์และเครือข่ายของสกุลเงินที่ฝาก
deposits[].instrument.currencyTitle	string	โค้ดสกุลเงินที่ฝาก (เช่น XRP)
deposits[].instrument.networkTitle	string	เครือข่ายบล็อกเชนของเงินฝาก (เช่น XRP)
deposits[].amount	string	จำนวนเงินฝากในโทเคนต้นฉบับ
deposits[].amountUSDT	string	มูลค่าเทียบเท่าเป็น USDT ณ เวลาฝาก
deposits[].txId	string	ID ธุรกรรมฝากบนบล็อกเชน
deposits[].confirmations	number	จำนวนการยืนยันบล็อกเชนที่ได้รับสำหรับเงินฝากนี้
deposits[].depositAddress	object	อ็อบเจ็กต์ที่อยู่ฝากที่ส่งเงินไป (ดูบล็อก `depositAddress`)
deposits[].isPending	boolean	ระบุว่าเงินฝากยังคงรอดำเนินการอยู่ (true) หรือยืนยัน/เครดิตแล้ว (false)

อาร์เรย์ withdrawals

"withdrawals": [
  {
    "instrument": {
      "currencyTitle": "TRX",
      "networkTitle": "TRC20"
    },
    "amount": "393.07",
    "txId": "39dc5802a931da0613f687087397e812dd6c0aa0b9041124d76e864e37bd1e09",
    "createdAt": "2025-12-15T14:41:58.926Z",
    "networkFee": "1.98"
  }
]

ฟิลด์	ชนิด	คำอธิบาย
withdrawals[]	array	รายการธุรกรรมถอนของออเดอร์
withdrawals[].instrument	object	อินสตรูเมนต์และเครือข่ายของสกุลเงินที่ถอน
withdrawals[].instrument.currencyTitle	string	โค้ดสกุลเงินของโทเคนที่ถอน (เช่น TRX)
withdrawals[].instrument.networkTitle	string	เครือข่ายบล็อกเชนที่ใช้สำหรับการถอน (เช่น TRC20)
withdrawals[].amount	string	จำนวนที่ถอนในโทเคนต้นฉบับ
withdrawals[].txId	string	ID ธุรกรรมถอนบนบล็อกเชน
withdrawals[].createdAt	string (ISO 8601)	เวลาที่สร้างการถอน
withdrawals[].networkFee	string	ค่าธรรมเนียมเครือข่ายที่ถูกหักสำหรับธุรกรรมถอน

กรณีการใช้งานที่เป็นไปได้

ดึงรายละเอียดครบถ้วนของออเดอร์ที่ระบุ เพื่อแสดงประวัติธุรกรรม สถานะ และข้อมูลทางการเงินที่เกี่ยวข้องในบัญชีผู้ใช้/แดชบอร์ดพาร์ทเนอร์ หรือเพื่อการกระทบยอดและการตรวจสอบ

Code Sample

Response Example

{
  "orderId": 3038,
  "legacyOrderId": "4602ddf9-e516-4c3a-9146-7bc748edd89b",
  "pair": {
    "instrumentFrom": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC",
      "precisionDecimals": 7,
      "slug": "btc",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20",
      "precisionDecimals": 5,
      "slug": "usdttrc20",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },
  "createdAt": "2025-04-28T13:15:03.006Z",
  "instrumentFromCurrencyTitle": "BTC",
  "instrumentFromNetworkTitle": "BTC",
  "instrumentToCurrencyTitle": "USDT",
  "instrumentToNetworkTitle": "TRC20",
  "feeMode": "FLOATING",
  "userId": 229,
  "userEmail": "qa@support.quickex.io",
  "isPlatformEmail": false,
  "refundAddress": null,
  "refundAddressMemo": null,
  "destinationAddress": "TFjfHBiDcL6B5S5W8g9b6gU2tbvnTR52ya",
  "destinationAddressMemo": null,
  "claimedNetworkFee": "1.5",
  "rateMode": "FLOATING",
  "claimedDepositAmount": "0.034268",
  "amountToGet": "3263.05",
  "platformFee": null,
  "redirectUrl": null,
  "orderEvents": [
    {
      "createdAt": "2025-04-28T13:15:03.021Z",
      "kind": "CREATION_END"
    }
  ],
  "depositAddress": {
    "instrument": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC"
    },
    "depositAddress": "3LpR1ZKEVysoi6sxFqoGtB49638RsxzKSh",
    "depositAddressMemo": null
  },
  "deposits": [],
  "withdrawals": [],
  "KYCFormLink": null,
  "liquidityProviderPublicCode": "hat",
  "possibleRefferalAccrualAmount": "3.01",
  "possibleCashbackAmountUSDT": "0",
  "actualCashbackAmountUSDT": null,
  "claimedPublicRate": {
    "claimedAmountToReceive": "3259.38",
    "finalNetworkFeeAmount": "1.5",
    "price": "95158.1",
    "quotes": {
      "sellQuote": {
        "baseValue": "1",
        "quoteValue": "95114.32743505127"
      },
      "buyQuote": {
        "baseValue": "95158",
        "quoteValue": "0.9995400016924599"
      }
    },
    "updatedAt": "2025-04-28T13:11:30.251Z",
    "instrumentFrom": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC",
      "precisionDecimals": 7,
      "slug": "btc",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20",
      "precisionDecimals": 5,
      "slug": "usdttrc20",
      "liquidityProviderCurrencies": [
        {
          "minConfirmationsToTrade": 3,
          "minConfirmationsToWithdraw": 3
        }
      ]
    }
  },
  "completed": false,
  "minConfirmationsToTrade": 3,
  "minConfirmationsToWithdraw": 3
}

Try it out

POST

accept-rate-mode-change

Endpoint URL

https://quickex.io/api/v2/orders/public/accept-rate-mode-change

Documentation

ยืนยันการเปลี่ยนโหมดอัตราแลกเปลี่ยน (rate mode) สำหรับออเดอร์ ใช้ในกรณีที่ออเดอร์ถูกสร้างด้วยอัตราคงที่
แต่ระหว่างกระบวนการแลกเปลี่ยนถูกสลับเป็นอัตราลอยตัว (เช่น เนื่องจากเกินลิมิตหรือความผันผวนสูง)
เมธอดนี้ช่วยให้ผู้ใช้ยอมรับโหมดใหม่และดำเนินการประมวลผลออเดอร์ต่อได้

URL

https://quickex.io/api/v2/orders/public/accept-rate-mode-change

Headers

Accept: application/json
Content-Type: application/json

Request Body (JSON)

ฟิลด์	ชนิด	ต้องระบุ	คำอธิบาย
`orderId`	number	ใช่	ตัวระบุของออเดอร์ที่ต้องยืนยันการเปลี่ยนโหมดอัตราแลกเปลี่ยน
`destinationAddress`	string	ใช่	ที่อยู่ปลายทางที่เชื่อมโยงกับออเดอร์ (ใช้เป็นการตรวจสอบเพิ่มเติม)

{
  "orderId": 123456,
  "destinationAddress": "0xdeadbeef"
}

Request Example (cURL)

curl -X POST \
  'https://quickex.io/api/v1/orders/public/accept-rate-mode-change' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "orderId": 123456,
    "destinationAddress": "0xdeadbeef"
  }'

Responses

โค้ด	คำอธิบาย
`201 Created`	ยืนยันการเปลี่ยนโหมดอัตราแลกเปลี่ยนแล้ว และออเดอร์จะดำเนินการต่อไป
`404 Not Found`	ไม่พบออเดอร์ (`{"status":"ERR_NOT_FOUND","message":"Order not found"}`).
`400 Bad Request`	ข้อผิดพลาดการตรวจสอบข้อมูล (เช่น ข้อมูลนำเข้าไม่ถูกต้อง)
`5xx`	ข้อผิดพลาดภายในเซิร์ฟเวอร์

Notes

เมธอดนี้จะถูกเรียกใช้เฉพาะเมื่อออเดอร์มีการเปลี่ยนโหมดอัตราแลกเปลี่ยนเท่านั้น (เช่น จาก fixed เป็น floating)

หากไม่มีการยืนยัน การประมวลผลออเดอร์จะถูกระงับ

เมื่อสำเร็จ การตอบกลับจะคืนสถานะ 201 และออเดอร์จะเข้าสู่สถานะการประมวลผลต่อเนื่อง

Code Sample

Try it out

POST

request-refund

Endpoint URL

https://quickex.io/api/v2/orders/public/request-refund

Documentation

ส่งคำขอคืนเงินสำหรับออเดอร์ ใช้ในสถานการณ์ที่การแลกเปลี่ยนไม่เสร็จสมบูรณ์หรือต้องคืนเงินให้ผู้ใช้
เพื่อให้สำเร็จ ต้องระบุจำนวนเงินคืนและที่อยู่สำหรับคืนเงิน

URL

https://quickex.io/api/v2/orders/public/request-refund

Headers

Accept: application/json
Content-Type: application/json

Request Body (JSON)

ฟิลด์	ชนิด	ต้องระบุ	คำอธิบาย
`orderId`	number	ใช่	ตัวระบุของออเดอร์ที่ส่งคำขอคืนเงิน
`destinationAddress`	string	ใช่	ที่อยู่ปลายทางที่ระบุไว้ในออเดอร์เดิม (ใช้เป็นการตรวจสอบเพิ่มเติม)
`refundAmount`	string	ใช่	จำนวนเงินที่จะคืนให้ผู้ใช้
`refundAddress`	string	ใช่	ที่อยู่กระเป๋าเงินของผู้ใช้ที่จะได้รับเงินคืน
`claimedNetworkFee`	string	ไม่	จำนวนค่าธรรมเนียมเครือข่ายที่ผู้ใช้ยินยอมจ่ายสำหรับการคืนเงิน

{
  "orderId": 123456,
  "destinationAddress": "0xdeadbeef",
  "refundAmount": "10.00",
  "refundAddress": "0xuserrefundwallet",
  "claimedNetworkFee": "0.50"
}

Request Example (cURL)

curl -X POST \
  'https://quickex.io/api/v1/orders/public/request-refund' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "orderId": 123456,
    "destinationAddress": "0xdeadbeef",
    "refundAmount": "10.00",
    "refundAddress": "0xuserrefundwallet",
    "claimedNetworkFee": "0.50"
  }'

Responses

โค้ด	คำอธิบาย
`201 Created`	คำขอคืนเงินได้รับการยอมรับและจะถูกดำเนินการ
`404 Not Found`	ไม่พบออเดอร์ (`{"status":"ERR_NOT_FOUND","message":"Order not found"}`).
`400 Bad Request`	ข้อผิดพลาดการตรวจสอบข้อมูล (เช่น จำนวนเงินคืนต่ำกว่าขั้นต่ำที่อนุญาต หรือ `refundAddress` ไม่ถูกต้อง)
`5xx`	ข้อผิดพลาดภายในเซิร์ฟเวอร์

Notes

เมธอดนี้ใช้เฉพาะกับออเดอร์ที่ไม่สามารถดำเนินการให้เสร็จได้

การคืนเงินจะถูกส่งไปยังที่อยู่ที่ระบุใน refundAddress โดยหักค่าธรรมเนียมเครือข่ายที่เกี่ยวข้อง (ถ้ามี)

หลังส่งคำขอแล้ว การคืนเงินอาจต้องมีการตรวจสอบด้วยมือโดยทีมซัพพอร์ต

Code Sample

Try it out

GET

order-refund-info

Endpoint URL

https://quickex.io/api/v2/orders/order-refund-info

Documentation

ส่งคืนข้อมูลการคืนเงินสำหรับออเดอร์ที่ระบุ
ใช้หลังจากสร้างคำขอคืนเงินเพื่อตรวจสอบรายละเอียด (จำนวนเงิน ที่อยู่สำหรับคืนเงิน สถานะ)

URL

https://quickex.io/api/v2/orders/order-refund-info

พารามิเตอร์คำขอ (Query)

พารามิเตอร์	ชนิด	ต้องระบุ	คำอธิบาย
`orderId`	string	ใช่	ตัวระบุของออเดอร์ที่ต้องการดึงข้อมูลการคืนเงิน

curl -X GET \
  'https://quickex.io/api/v1/orders/order-refund-info?orderId=1234' \
  -H 'Accept: application/json'

Responses

โค้ด	คำอธิบาย
`200 OK`	ส่งคืน JSON พร้อมข้อมูลการคืนเงิน (จำนวนเงิน ที่อยู่ สถานะ ค่าธรรมเนียม)
`400 Bad Request`	ข้อผิดพลาดการตรวจสอบข้อมูลหรือข้อมูลออเดอร์ไม่ถูกต้อง (`{"status":"ERR_BAD_REQUEST","message":"Unknown liquidity provider title: ..."}`).
`404 Not Found`	ไม่พบออเดอร์
`5xx`	ข้อผิดพลาดภายในเซิร์ฟเวอร์

Notes

เมธอดนี้จะส่งคืนข้อมูลเฉพาะสำหรับออเดอร์ที่มีการเริ่มต้นการคืนเงินแล้วเท่านั้น

ในการตอบกลับแบบสำเร็จ 200 JSON อาจมีจำนวนเงินคืน ที่อยู่คืนเงิน และค่าธรรมเนียมเครือข่าย

สำหรับข้อผิดพลาดการตรวจสอบข้อมูล (400) เซิร์ฟเวอร์จะระบุเหตุผลไว้ในฟิลด์ message

Code Sample

Try it out

แชร์บทความนี้:

Orders API V2

Documentation

พารามิเตอร์

ตัวอย่างคำขอ

การตอบสนองที่เป็นไปได้

กรณีการใช้งาน

Code Sample

Response Example

Try it out

Query Parameters

Request Body

Headers

Documentation

พารามิเตอร์

ตัวอย่างคำขอ

การตอบสนองที่เป็นไปได้

กรณีการใช้งาน

Code Sample

Response Example

Try it out

Request Body

Headers

Documentation

ภาพรวม

HTTP Request

ตัวอย่างคำขอ

Headers

Request Parameters

Body Parameters

Response Format

ตัวอย่าง Response

Errors

403 ERR_FORBIDDEN — Email ถูกตั้งค่าแล้ว

กรณีการใช้งานที่เป็นไปได้

Code Sample

Response Example

Try it out

Request Body

Headers

Documentation

ภาพรวม

คำขอ HTTP

ตัวอย่างคำขอ

Headers

พารามิเตอร์คำขอ

พารามิเตอร์ Query

รูปแบบการตอบกลับ

ตัวอย่างการตอบกลับ

การอธิบายฟิลด์ของการตอบกลับ

ข้อมูลทั่วไปของออเดอร์

คู่ของอินสตรูเมนต์ (pair)

orderEvents

ค่าที่เป็นไปได้ของ orderEvents[].kind

อ็อบเจ็กต์ depositAddress

อาร์เรย์ deposits

อาร์เรย์ withdrawals

กรณีการใช้งานที่เป็นไปได้

Code Sample

Response Example

Try it out

Query Parameters

Headers

Documentation

URL

Headers

Request Body (JSON)

Request Example (cURL)

Responses

Notes

Code Sample

Try it out

Request Body

Headers

Documentation

URL

Headers

Request Body (JSON)

Request Example (cURL)

Responses

Notes