การเรียกและผลลัพธ์ (REST API)

อัปเดตล่าสุด: 31 มีนาคม 2568

การเรียก


ในการเข้าถึงปลายทางของ API จะต้องส่งการเรียก HTTP ไปยัง URL ต่อไปนี้

https://futures.kraken.com/derivatives/api/v3

สำหรับการเรียกใช้ปลายทางส่วนตัว จะต้องระบุ HTTP headers ต่อไปนี้: apiKey และ
authent การรวม nonce ในคำขอเป็นทางเลือก

ตัวอย่าง

ต่อไปนี้เป็นตัวอย่างการรวม HTTP headers ใน Java สำหรับตัวอย่างการทำงานที่สมบูรณ์ในภาษาโปรแกรมต่างๆ โปรดดูส่วน Sample Implementations. String url = "https://futures.kraken.com/derivatives/api/v3/sendOrder";
URL obj = new URL(url);
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
...
con.setRequestProperty("APIKey", apiKey);
con.setRequestProperty("Authent", authent); โดยที่ apiKey และ authent ถูกกำหนดไว้ตามที่อธิบายไว้ก่อนหน้านี้


การเรียกใช้ปลายทางที่ไม่เปลี่ยนแปลงสถานะของเซิร์ฟเวอร์ควรร้องขอด้วย requestType
= GET และ postData ที่ส่งใน URL การเรียกใช้ปลายทางที่เปลี่ยนแปลงสถานะของเซิร์ฟเวอร์ควรร้องขอด้วย requestType = POST และ postData ที่ส่งใน URL ส่วนที่ 4 จะให้รายละเอียดสำหรับแต่ละปลายทางว่าควรใช้ requestType ใด

ผลลัพธ์


ผลลัพธ์ของ API อยู่ในรูปแบบ JSON หากการเรียกสำเร็จ ผลลัพธ์จะรวมข้อมูลที่ร้องขอหรือข้อเสนอแนะเกี่ยวกับการดำเนินการที่ร้องขอ โปรดดูส่วน Error! Reference source not found. สำหรับคำอธิบายผลลัพธ์สำหรับแต่ละปลายทาง

หากการเรียกสำเร็จ คีย์ result ในโครงสร้างหลักจะมีค่าเป็น success

สำหรับการเรียกใช้ปลายทางส่วนตัว จะต้องระบุ HTTP headers ต่อไปนี้: apiKey และ
authent

ตัวอย่าง

ต่อไปนี้แสดงผลลัพธ์ของการเรียกใช้ปลายทาง sendorder ที่สำเร็จ
{
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"placed",
"order_id":"c18f0c17-9971-40e6-8e5b10df05d422f0"
}
}


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

ตัวอย่าง

ต่อไปนี้แสดงผลลัพธ์ของการเรียกใช้ปลายทาง sendorder ที่สำเร็จ แต่การดำเนินการที่ต้องการไม่ถูกดำเนินการ
{
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

ต้องการความช่วยเหลือเพิ่มเติมหรือไม่