Orders in Quickex API: Creation and Management

GET

public-info

Endpoint URL

https://quickex.io/api/v1/orders/public-info

Documentation

ส่งคืนข้อมูลสาธารณะเกี่ยวกับออเดอร์ (การทำรายการแลกเปลี่ยน) ตาม ที่อยู่ปลายทาง.
การตอบกลับประกอบด้วยรายละเอียดเงินฝาก/การถอน คู่เทรด พารามิเตอร์อัตราที่ประกาศ เหตุการณ์ของออเดอร์ เป็นต้น

URL

https://quickex.io/api/v1/orders/public-info

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

พารามิเตอร์	ชนิด	จำเป็น	คำอธิบาย
`destinationAddress`	string	ใช่	ที่อยู่ปลายทางที่เชื่อมโยงกับออเดอร์ ใช้สำหรับค้นหาออเดอร์

ตัวอย่างคำขอ (cURL)

curl -X GET \
  'https://quickex.io/api/v1/orders/public-info?destinationAddress=0xdeadbeef' \
  -H 'Accept: application/json'

ตัวอย่างการตอบกลับ (สำเร็จ)

{
  "orderId": 1234,
  "legacyOrderId": "QX-0001234",
  "pair": {
    "instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
    "instrumentTo":   { "currencyTitle": "BTC",  "networkTitle": "BTC"   }
  },
  "deposits": [
    {
      "createdAt": "2025-08-22T05:51:30.993Z",
      "instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
      "amount": "1000.1",
      "confirmations": 0,
      "txId": "0xdeadc0dedeadbeef",
      "depositAddress": "0xdeadc0de",
      "isPending": true
    }
  ],
  "withdrawals": [
    {
      "createdAt": "2025-08-22T05:51:30.993Z",
      "instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
      "amount": "1000.1",
      "networkFee": "1.1",
      "txId": "0xdeadc0dedeadbeef"
    }
  ],
  "rateMode": "FLOATING",
  "claimedDepositAmount": "10.01",
  "amountToGet": "10.01",
  "completed": false,
  "userEmail": "test@example.com",
  "destinationAddress": "0xdeadbeef"
}

การตอบกลับ

รหัส	เนื้อหา	คำอธิบาย
`200 OK`	JSON ที่มีข้อมูลของออเดอร์	พบออเดอร์และส่งคืนเรียบร้อย
`400 Bad Request`	`{"status":"ERR_VALIDATION","message":"Validation Exception", ...}`	ข้อผิดพลาดในการตรวจสอบความถูกต้อง (เช่น ขาดหรือระบุ `destinationAddress` ไม่ถูกต้อง)
`5xx`	—	ข้อผิดพลาดภายในเซิร์ฟเวอร์

หมายเหตุ

เมธอดนี้ส่งคืนข้อมูล สาธารณะ ของออเดอร์เท่านั้น; รายละเอียดส่วนตัวไม่พร้อมให้บริการ

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

โครงสร้างของส่วน deposits/withdrawals และฟิลด์เสริมอาจแตกต่างกันไปตามสถานะออเดอร์และผู้ให้บริการสภาพคล่อง

Code Sample

Response Example

{
  "deposits": [
    {
      "createdAt": "2025-08-22T05:51:30.993Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "confirmations": 0,
      "txId": "0xdeadc0dedeadbeef",
      "depositAddress": "0xdeadc0de",
      "isPending": true,
      "id": 0,
      "counterPartyAddress": "0xdeadc0dedeadbeef"
    }
  ],
  "withdrawals": [
    {
      "createdAt": "2025-08-22T05:51:30.993Z",
      "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,
  "legacyOrderId": "string",
  "pair": {
    "instrumentFrom": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    }
  },
  "createdAt": "2025-08-22T05:51:30.994Z",
  "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-08-22T05:51:30.994Z",
    "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-08-22T05:51:30.994Z"
    }
  ],
  "userEmail": "test@example.com",
  "rateMode": "FLOATING",
  "destinationAddress": "0xdeadbeef",
  "destinationAddressMemo": "0xdeadbeef",
  "completed": false,
  "possibleCashbackAmountUSDT": "500.00",
  "redirectUrl": "https://payments.mercuryo.io/"
}

Try it out

POST

set-email

Endpoint URL

/api/v1/orders/public/set-email

Documentation

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

URL

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

ต้องมีการอนุญาตหรือไม่?

ไม่ (เมธอดสาธารณะสำหรับออเดอร์ที่มีอยู่)

ส่วนหัว (Headers)

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

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

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

{
  "orderId": 123456,
  "userEmail": "user@example.com"
}

ตัวอย่างคำขอ (cURL)

curl -X POST \
  'https://quickex.io/api/v1/orders/public/set-email' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "orderId": 123456,
    "userEmail": "user@example.com"
  }'

การตอบกลับ

รหัส	เนื้อหา	คำอธิบาย
`200 OK`	JSON พร้อมข้อมูลสาธารณะของออเดอร์ (รวม `userEmail`)	เชื่อมโยงอีเมลกับออเดอร์สำเร็จ
`400 Bad Request`	`{"status":"ERR_VALIDATION","message":"Validation Exception", ...}`	ข้อผิดพลาดในการตรวจสอบความถูกต้อง (เช่น `userEmail` ไม่ใช่อีเมลที่ถูกต้อง)
`5xx`	—	ข้อผิดพลาดภายในเซิร์ฟเวอร์

หมายเหตุ

ก่อนเรียกใช้เมธอด ให้ตรวจสอบว่าระบุ orderId ที่ถูกต้องของออเดอร์ที่มีอยู่แล้ว

userEmail ต้องเป็นที่อยู่อีเมลที่ถูกต้อง (ตัวอย่างข้อผิดพลาด: userEmail must be an email)

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

Code Sample

Response Example

{
  "deposits": [
    {
      "createdAt": "2025-08-22T06:03:09.050Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "confirmations": 0,
      "txId": "0xdeadc0dedeadbeef",
      "depositAddress": "0xdeadc0de",
      "isPending": true,
      "id": 0,
      "counterPartyAddress": "0xdeadc0dedeadbeef"
    }
  ],
  "withdrawals": [
    {
      "createdAt": "2025-08-22T06:03:09.050Z",
      "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,
  "legacyOrderId": "string",
  "pair": {
    "instrumentFrom": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20"
    }
  },
  "createdAt": "2025-08-22T06:03:09.050Z",
  "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-08-22T06:03:09.050Z",
    "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-08-22T06:03:09.050Z"
    }
  ],
  "userEmail": "test@example.com",
  "rateMode": "FLOATING",
  "destinationAddress": "0xdeadbeef",
  "destinationAddressMemo": "0xdeadbeef",
  "completed": false,
  "possibleCashbackAmountUSDT": "500.00",
  "redirectUrl": "https://payments.mercuryo.io/"
}

Try it out

GET

latest

Endpoint URL

https://quickex.io/api/v1/orders/public/latest

Documentation

Code Sample

Response Example

[
  {
    "createdAt": "2025-08-22T05:43:01.000Z",
    "instrumentFrom": {
      "currencyTitle": "BNB",
      "networkTitle": "BEP20",
      "okexCurrency": {
        "okexCurrencyFriendlyTitle": "BNB",
        "currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png"
      }
    },
    "instrumentTo": {
      "currencyTitle": "SOL",
      "networkTitle": "SOL",
      "okexCurrency": {
        "okexCurrencyFriendlyTitle": "SOL",
        "currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/sol.png"
      }
    },
    "amountFrom": "0.1809",
    "amountTo": "0.82480169"
  },
  {
    "createdAt": "2025-08-22T05:37:01.000Z",
    "instrumentFrom": {
      "currencyTitle": "BNB",
      "networkTitle": "BEP20",
      "okexCurrency": {
        "okexCurrencyFriendlyTitle": "BNB",
        "currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png"
      }
    },
    "instrumentTo": {
      "currencyTitle": "SOL",
      "networkTitle": "SOL",
      "okexCurrency": {
        "okexCurrencyFriendlyTitle": "SOL",
        "currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/sol.png"
      }
    },
    "amountFrom": "0.2012",
    "amountTo": "0.91833564"
  },
  {
    "createdAt": "2025-08-22T05:33:04.000Z",
    "instrumentFrom": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC",
      "okexCurrency": {
        "okexCurrencyFriendlyTitle": "BTC",
        "currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/btc20230419112752.png"
      }
    },
    "instrumentTo": {
      "currencyTitle": "ATOM",
      "networkTitle": "ATOM",
      "okexCurrency": {
        "okexCurrencyFriendlyTitle": "ATOM",
        "currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/atom.png"
      }
    },
    "amountFrom": "0.12827865",
    "amountTo": "3149.690556"
  },
  {
    "createdAt": "2025-08-22T05:29:03.000Z",
    "instrumentFrom": {
      "currencyTitle": "BTC",
      "networkTitle": "BTC",
      "okexCurrency": {
        "okexCurrencyFriendlyTitle": "BTC",
        "currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/btc20230419112752.png"
      }
    },
    "instrumentTo": {
      "currencyTitle": "USDT",
      "networkTitle": "TRC20",
      "okexCurrency": {
        "okexCurrencyFriendlyTitle": "USDT",
        "currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/usdt20230419113051.png"
      }
    },
    "amountFrom": "0.00478498",
    "amountTo": "563.455834"
  },
  {
    "createdAt": "2025-08-22T05:22:03.000Z",
    "instrumentFrom": {
      "currencyTitle": "ETH",
      "networkTitle": "ETH",
      "okexCurrency": {
        "okexCurrencyFriendlyTitle": "Ethereum",
        "currencyLogoLink": "https://static.coinall.ltd/cdn/oksupport/asset/currency/icon/eth20230419112854.png"
      }
    },
    "instrumentTo": {
      "currencyTitle": "BNB",
      "networkTitle": "BEP20",
      "okexCurrency": {
        "okexCurrencyFriendlyTitle": "BNB",
        "currencyLogoLink": "https://s2.coinmarketcap.com/static/img/coins/64x64/1839.png"
      }
    },
    "amountFrom": "0.59",
    "amountTo": "2.77157716"
  }
]

Try it out

POST

accept-rate-mode-change

Endpoint URL

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

Documentation

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

URL

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

ส่วนหัว (Headers)

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

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

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

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

ตัวอย่างคำขอ (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"
  }'

การตอบกลับ

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

หมายเหตุ

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

หากไม่ยืนยัน การประมวลผลออเดอร์จะถูกหยุดไว้ชั่วคราว

เมื่อสำเร็จ เซิร์ฟเวอร์จะส่งสถานะ 201 และออเดอร์เข้าสู่สถานะดำเนินการต่อ

Code Sample

Try it out

POST

request-refund

Endpoint URL

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

Documentation

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

URL

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

ส่วนหัว (Headers)

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

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

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

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

ตัวอย่างคำขอ (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"
  }'

การตอบกลับ

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

หมายเหตุ

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

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

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

Code Sample

Try it out

GET

order-refund-info

Endpoint URL

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

Documentation

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

URL

https://quickex.io/api/v1/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'

การตอบกลับ

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

หมายเหตุ

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

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

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

Code Sample

Try it out

GET

public/list

Endpoint URL

https://quickex.io/api/v1/orders/public/list

Documentation

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

URL

https://quickex.io/api/v1/orders/public/list

ต้องมีการอนุญาตหรือไม่?

ใช่ — ต้องระบุ access_token ที่ถูกต้องไว้ในส่วนหัว

ส่วนหัว (Headers)

Accept: application/json
access_token = YOUR_TOKEN

พารามิเตอร์

ไม่มี

ตัวอย่างคำขอ (cURL)

curl -X GET \
  'https://quickex.io/api/v1/orders/public/list' \
  -H 'Accept: application/json' \
  --cookie "access_token=YOUR_TOKEN"

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

[
  {
    "orderId": 123,
    "pair": {
      "instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
      "instrumentTo":   { "currencyTitle": "BTC",  "networkTitle": "BTC"   }
    },
    "deposits": [
      {
        "createdAt": "2025-08-26T09:55:46.101Z",
        "instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
        "amount": "1000.1",
        "confirmations": 0,
        "txId": "0xdeadc0dedeadbeef",
        "depositAddress": "0xdeadc0de",
        "isPending": true
      }
    ],
    "withdrawals": [
      {
        "createdAt": "2025-08-26T09:55:46.101Z",
        "instrument": { "currencyTitle": "BTC", "networkTitle": "BTC" },
        "amount": "0.025",
        "txId": "0xbtcdeadbeef"
      }
    ],
    "status": "PENDING",
    "createdAt": "2025-08-26T09:55:46.101Z"
  }
]

การตอบกลับ

รหัส	คำอธิบาย
`200 OK`	ส่งคืนอาเรย์ของออเดอร์ของผู้ใช้
`401 Unauthorized`	ไม่มี `access_token` หรือโทเค็นไม่ถูกต้อง
`5xx`	ข้อผิดพลาดของเซิร์ฟเวอร์ระหว่างประมวลผลคำขอ

หมายเหตุ

เมธอดนี้ส่งคืนเฉพาะออเดอร์ที่ผู้ใช้ที่ยืนยันตัวตนในปัจจุบันเป็นผู้สร้างเท่านั้น

หากต้องการรับข้อมูลสาธารณะเกี่ยวกับออเดอร์เฉพาะ ให้ใช้เมธอด /api/v1/orders/public-info

แนะนำให้แคชข้อมูลออเดอร์ฝั่งไคลเอนต์เพื่อลดจำนวนคำขอ

Code Sample

Try it out

POST

/api/v1/orders/public/create

Endpoint URL

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

Documentation

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

URL

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

การตรวจสอบสิทธิ์

ต้องมีเฮดเดอร์ B2B-Bearer-Token สำหรับการผสานรวมแบบ B2B (ตัวอย่าง: -H "B2B-Bearer-Token: TOKEN")
สำหรับกรณีการใช้งานของผู้ใช้ สามารถใช้ access_token เป็นคุกกี้ได้

ส่วนหัว (Headers)

Accept: application/json
Content-Type: application/json
B2B-Bearer-Token: <TOKEN>

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

{
  "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",
  "browserFingerprint": "string",
  "markup": "0.01",
  "locale": "en"
}

ตัวอย่างคำขอ (cURL)

curl -X POST \
  'https://quickex.io/api/v1/orders/public/create' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'B2B-Bearer-Token: YOUR TOKEN' \
  -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",
    "rateMode": "FLOATING",
    "browserFingerprint": "string",
    "markup": "0.01",
    "locale": "en"
  }'

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

{
  "orderId": 9876,
  "deposits": [
    {
      "createdAt": "2025-08-26T10:08:06.203Z",
      "instrument": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
      "amount": "3300",
      "depositAddress": "0xdeadc0de",
      "txId": null,
      "isPending": true
    }
  ],
  "withdrawals": [],
  "pair": {
    "instrumentFrom": { "currencyTitle": "USDT", "networkTitle": "TRC20" },
    "instrumentTo":   { "currencyTitle": "LTC",  "networkTitle": "LTC"   }
  },
  "rateMode": "FLOATING",
  "userEmail": "test@example.com",
  "status": "CREATED",
  "createdAt": "2025-08-26T10:08:06.203Z"
}

การตอบกลับ

รหัส	คำอธิบาย
`200 OK`	สร้างออเดอร์สำเร็จ; ส่งคืนอ็อบเจ็กต์ออเดอร์
`401 Unauthorized`	ไม่มี `B2B-Bearer-Token` หรือคุกกี้ `access_token` หรือโทเค็นไม่ถูกต้อง
`422 Unprocessable Entity`	ข้อผิดพลาดการตรวจสอบความถูกต้องของข้อมูลนำเข้า (เช่น จำนวนเงินน้อยเกินไป)
`501`	ข้อผิดพลาดของเซิร์ฟเวอร์ (“data is not iterable”)

หมายเหตุ

แนะนำให้ดึงอัตราก่อนด้วย /api/v1/rates/public/one ก่อนสร้างออเดอร์

หากระบุ rateMode=FIXED อัตราจะถูกล็อกไว้ช่วงเวลาจำกัด

พารามิเตอร์ referrerId และ markupAffiliateId ใช้สำหรับการผสานรวมแบบพันธมิตร

การตอบกลับอาจมีอาเรย์ว่างใน withdrawals หากยังไม่ได้ส่งเงิน

Code Sample

Response Example

{
  "deposits": [
    {
      "createdAt": "2025-11-21T09:26:08.476Z",
      "instrument": {
        "currencyTitle": "USDT",
        "networkTitle": "TRC20"
      },
      "amount": "1000.1",
      "confirmations": 0,
      "txId": "0xdeadc0dedeadbeef",
      "depositAddress": "0xdeadc0de",
      "isPending": true,
      "id": 0,
      "counterPartyAddress": "0xdeadc0dedeadbeef"
    }
  ],
  "withdrawals": [
    {
      "createdAt": "2025-11-21T09:26:08.476Z",
      "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-11-21T09:26:08.476Z",
  "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-11-21T09:26:08.476Z",
    "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-11-21T09:26:08.476Z"
    }
  ],
  "userEmail": "test@example.com",
  "rateMode": "FLOATING",
  "destinationAddress": "0xdeadbeef",
  "destinationAddressMemo": "0xdeadbeef",
  "completed": false,
  "possibleCashbackAmountUSDT": "500.00",
  "redirectUrl": "https://payments.mercuryo.io/",
  "minConfirmationsToTrade": 3,
  "minConfirmationsToWithdraw": 3
}

API V1 Orders

Documentation

URL

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

ตัวอย่างคำขอ (cURL)

ตัวอย่างการตอบกลับ (สำเร็จ)

การตอบกลับ

หมายเหตุ

Code Sample

Response Example

Try it out

Headers

Documentation

URL

ต้องมีการอนุญาตหรือไม่?

ส่วนหัว (Headers)

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

ตัวอย่างคำขอ (cURL)

การตอบกลับ

หมายเหตุ

Code Sample

Response Example

Try it out

Request Body

Headers

Documentation

พารามิเตอร์

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

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

หมายเหตุ

Code Sample

Response Example

Try it out

Headers

Documentation

URL

ส่วนหัว (Headers)

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

ตัวอย่างคำขอ (cURL)

การตอบกลับ

หมายเหตุ

Code Sample

Try it out

Request Body

Headers

Documentation

URL

ส่วนหัว (Headers)

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

ตัวอย่างคำขอ (cURL)

การตอบกลับ

หมายเหตุ

Code Sample

Try it out

Request Body

Headers

Documentation

URL

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

การตอบกลับ

หมายเหตุ

Code Sample

Try it out

Headers

Documentation

URL

ต้องมีการอนุญาตหรือไม่?

ส่วนหัว (Headers)

พารามิเตอร์

ตัวอย่างคำขอ (cURL)

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

การตอบกลับ

หมายเหตุ

Code Sample

Try it out

Headers

Documentation

URL

การตรวจสอบสิทธิ์

ส่วนหัว (Headers)