ส่วน instruments มีเมธอดสำหรับดึงรายการเครื่องมือที่ใช้งานอยู่ ดึงข้อมูลของเครื่องมือแต่ละรายการ และตรวจสอบว่าที่อยู่สำหรับเครื่องมือที่ระบุถูกต้องหรือไม่
Documentation
คำอธิบายทั่วไป
ส่งคืนรายการสาธารณะของเครื่องมือที่ใช้งานอยู่ทั้งหมด (สกุลเงินและเครือข่าย) ที่พร้อมสำหรับการแลกเปลี่ยน
พารามิเตอร์
Query Parameters
| ชื่อ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
providers |
array[string] | ใช่ | รายชื่อผู้ให้บริการสภาพคล่อง (เช่นBINANCE) ต้องส่งพารามิเตอร์นี้ซ้ำสำหรับแต่ละผู้ให้บริการ |
Headers
| ชื่อ | จำเป็น | คำอธิบาย |
|---|---|---|
X-Api-Public-Key |
ใช่ | คีย์ API สาธารณะของคุณ |
X-Api-Timestamp |
ใช่ | Timestamp ในรูปแบบ UNIX (มิลลิวินาที) |
X-Api-Signature |
ใช่ | ลายเซ็น HMAC ของคำขอที่สร้างด้วยคีย์ลับของคุณ |
กรณีการใช้งาน
เมื่อเริ่มต้นฟอร์มแลกเปลี่ยนบนหน้าเว็บ ระบบจำเป็นต้องแสดงสกุลเงินและเครือข่ายทั้งหมดที่รองรับจากผู้ให้บริการที่กำหนด ฟรอนต์เอนด์จะเรียกเมธอดนี้เพื่อนำข้อมูลไปสร้างรายการตัวเลือกต่าง ๆ
Code Sample
curl -X 'GET' \
'https://quickex.io/api/v2/instruments/public' \
-H 'accept: application/json'Response Example
[
{
"currencyTitle": "STX",
"networkTitle": "STX",
"slug": "stxstx",
"currencyFriendlyTitle": "STX",
"precisionDecimals": 8,
"currencyLogoLink": "https://quickex.io/assets/coins/stx.svg",
"requiresMemo": true,
"instrumentType": "crypto",
"bestChangeName": "",
"contractAddress": ""
},
{
"currencyTitle": "AVAX",
"networkTitle": "AVAX",
"slug": "avax",
"currencyFriendlyTitle": "AVAX",
"precisionDecimals": 3,
"currencyLogoLink": "https://quickex.io/assets/coins/avax.svg",
"requiresMemo": false,
"instrumentType": "crypto",
"bestChangeName": "AVAX",
"contractAddress": ""
},
{
"currencyTitle": "SAND",
"networkTitle": "ERC20",
"slug": "sanderc20",
"currencyFriendlyTitle": "SAND",
"precisionDecimals": 2,
"currencyLogoLink": "https://quickex.io/assets/coins/sand.svg",
"requiresMemo": false,
"instrumentType": "crypto",
"bestChangeName": "",
"contractAddress": "0x3845badade8e6dff049820680d1f14bd3903a5d0"
}
]Try it out
Leave empty to use default
Headers
Documentation
คำอธิบายทั่วไป
ส่งคืนข้อมูลของเครื่องมือที่ใช้งานอยู่หนึ่งรายการ (สกุลเงิน + เครือข่าย) จากรายการสาธารณะ
พารามิเตอร์
Headers
| ชื่อ | จำเป็น | คำอธิบาย |
|---|---|---|
X-Api-Public-Key |
ใช่ | คีย์ API สาธารณะของคุณ |
X-Api-Timestamp |
ใช่ | Timestamp ในรูปแบบ UNIX (มิลลิวินาที) |
X-Api-Signature |
ใช่ | ลายเซ็น HMAC ของเนื้อหาคำขอ ใช้คีย์ลับของคุณในการสร้าง |
เนื้อหาคำขอ (JSON)
| ฟิลด์ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
currencyTitle |
string | ใช่ | รหัสสกุลเงิน (เช่น USDT) |
networkTitle |
string | ใช่ | เครือข่ายของสกุลเงิน (เช่น TRC20) |
ตัวอย่างคำขอ
curl -X POST 'https://quickex.io/api/v2/instruments/public/one' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'X-Api-Public-Key: yourPublicKey' \
-H 'X-Api-Timestamp: 1691400000000' \
-H 'X-Api-Signature: yourHmacSignature' \
-d '{
"currencyTitle": "USDT",
"networkTitle": "TRC20"
}'
ตัวอย่างการตอบสนอง
200 OK — พบเครื่องมือ:
{
"currencyTitle": "ADA",
"networkTitle": "ADA",
"currencyFriendlyTitle": "Cardano",
"precisionDecimals": 11,
"requiresMemo": false,
"currencyLogoLink": "https://static.coinall.ltd/cdn/assets/imgs/221/5FFE6AFD21B40243.png",
"instrumentType": "crypto",
"bestChangeName": "USDTTRC20"
}
500 ERR_UNKNOWN — ไม่พบเครื่องมือหรือเกิดข้อผิดพลาดภายใน:
{
"status": "ERR_UNKNOWN",
"message": "code=404, message=Not Found",
"data": null
}
กรณีการใช้งาน
เมื่อสร้างคำสั่งซื้อ ฟรอนต์เอนด์ต้องแสดงข้อมูลรายละเอียดของเครื่องมือที่เลือก: ชื่อแสดงผล ความแม่นยำ และความจำเป็นต้องใช้ Memo/Tag เมื่อผู้ใช้เลือกสกุลเงินและเครือข่าย ระบบจะเรียกเมธอดนี้เพื่อใช้ข้อมูลในการตรวจสอบและแสดงฟิลด์ที่เกี่ยวข้อง
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v2/instruments/public/one' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"currencyTitle": "USDT",
"networkTitle": "TRC20"
}'Response Example
{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"currencyFriendlyTitle": "USDT",
"precisionDecimals": 2,
"currencyLogoLink": "https://quickex.io/assets/coins/usdt.svg",
"requiresMemo": false,
"instrumentType": "crypto",
"contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
}Try it out
Leave empty to use default
Request Body
Headers
Documentation
คำอธิบายทั่วไป
ตรวจสอบความถูกต้องของที่อยู่สำหรับสกุลเงินและเครือข่ายที่ระบุ หากที่อยู่ถูกต้องตามรูปแบบและข้อกำหนดของเครือข่าย จะส่งคืน true; มิฉะนั้นจะส่งคืน false หรือข้อผิดพลาด
พารามิเตอร์
Headers
| ชื่อ | จำเป็น | คำอธิบาย |
|---|---|---|
X-Api-Public-Key |
ใช่ | คีย์ API สาธารณะของคุณ |
X-Api-Timestamp |
ใช่ | Timestamp ในรูปแบบ UNIX (มิลลิวินาที) |
X-Api-Signature |
ใช่ | ลายเซ็น HMAC ของเนื้อหาคำขอ ใช้คีย์ลับของคุณในการสร้าง |
เนื้อหาคำขอ (JSON)
| ฟิลด์ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
currencyTitle |
string | ใช่ | รหัสสกุลเงิน (เช่น USDT) |
networkTitle |
string | ใช่ | เครือข่ายของสกุลเงิน (เช่น TRC20) |
address |
string | ใช่ | ที่อยู่ที่ต้องการตรวจสอบ |
ตัวอย่างคำขอ
curl -X POST 'https://quickex.io/api/v2/instruments/public/validate-address' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H 'X-Api-Public-Key: yourPublicKey' \
-H 'X-Api-Timestamp: 1691400050000' \
-H 'X-Api-Signature: yourHmacSignature' \
-d '{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"address": "THUmkPhry61edcTf79yTioV6292ccsuCjV"
}'
ตัวอย่างการตอบสนอง
200 OK — ที่อยู่ถูกต้อง:
true
400 ERR_INVALID_ADDRESS — ที่อยู่ไม่ตรงตามรูปแบบของเครือข่าย:
false
500 ERR_UNKNOWN — ไม่พบเครื่องมือหรือเกิดข้อผิดพลาดภายใน:
{
"status": "ERR_UNKNOWN",
"message": "code=404, message=Not Found",
"data": null
}
กรณีการใช้งาน
ก่อนสร้างคำสั่งซื้อ ฟรอนต์เอนด์จะตรวจสอบที่อยู่ที่ผู้ใช้ป้อน: หากเมธอดส่งคืน true ฟอร์มจะดำเนินการต่อ; หากไม่ — จะแสดงข้อความผิดพลาดเพื่อให้ผู้ใช้ตรวจสอบที่อยู่
Code Sample
curl -X 'POST' \
'https://quickex.io/api/v2/instruments/validate-address' \
-H 'accept: */*' \
-H 'Content-Type: application/json' \
-d '{
"currencyTitle": "USDT",
"networkTitle": "TRC20",
"address": "THUmkPhry61edcTf79yTioV6292ccsuCjV",
"memo": "2345678",
"getRejectReason": true
}'Response Example
{
"status": "ERR_HTTP",
"message": "Http Exception",
"data": {
"address": "adddress is incorrect"
}
}Try it out
Leave empty to use default