คำถามที่พบบ่อยเกี่ยวกับ API (FAQ)

Binance
2021-07-09 04:52

เอกสารประกอบ APIตัวอย่าง API อย่างไม่เป็นทางการ 

มี Limits อะไรบ้าง

ภาพรวม
Limits มีสามประเภท ซึ่งอาจเปลี่ยนแปลงได้ตลอดเวลา ได้แก่
  1. Hard-Limits
  2. Machine Learning (ML) Limits
  3. Web Application Firewall (WAF) Limits
Hard-Limits:
  • 1,200 Request Weight ต่อนาที (ซึ่งไม่จำเป็นต้องเท่ากับ 1,200 คำขอ)
  • 50 Order ต่อ 10 วินาที
  • 160,000 Order ต่อ 24 ชั่วโมง
Hard-Limits ของเราจะแสดงใน Endpoint ของ [/api/v3/exchangeInfo]
Machine Learning Limits:
พฤติกรรมการซื้อขายจะได้รับการประเมินโดยเทียบจากผู้ใช้โดยเฉลี่ย และหากพฤติกรรมของคุณเบี่ยงเบนมากเกินไป คุณจะถูกแบนตามระยะเวลาที่กำหนดตั้งแต่ 5 นาทีถึง 3 วัน
สมมติว่าคุณมีคะแนนพฤติกรรมการเทรดที่ไม่เหมาะสม คะแนนดังกล่าวจะเพิ่มขึ้นในกรณีต่อไปนี้: 
  • คุณมักจะ One-Up หรือ Front-Run รายการ Bid/Ask ที่ดีที่สุดบน Order Book ซ้ำๆ
  • คุณสแปมการสร้าง Order และยกเลิก Order อย่างรวดเร็วโดยไม่ได้ดำเนินการซื้อขาย
  • "Conversation Rate" ของคุณอยู่ในระดับต่ำ "Conversation Rate" หมายถึงจำนวนการซื้อขายของคุณหารด้วยการสร้างและการยกเลิก Order ทั้งหมดในช่วง 24 ชั่วโมง (num Trades / (orders + cancels))
  • "Weight" ของคุณอยู่ในระดับต่ำ "Weight" หมายถึงปริมาณการซื้อขายทั้งหมดของคุณหารด้วยการสร้างและการยกเลิก Order ทั้งหมดในช่วง 24 ชั่วโมง (total Traded Qty / (orders + cancels))
  • สำหรับคู่เทรดที่มี BNB เป็น Base Asset หรือ Quote Asset คะแนนพฤติกรรมการเทรดที่ไม่เหมาะสมของคุณจะยิ่งทวีคูณขึ้น
จะไม่มีการเผยข้อมูลที่เฉพาะเจาะจงเกินกว่าที่ระบุไว้ข้างต้น โปรดลองผิดลองถูกเพื่อค้นหารูปแบบการเทรดที่เหมาะสมกับคุณที่สุด หรือพูดคุยเกี่ยวกับพฤติกรรมการเทรดที่เหมาะสมกับผู้ใช้ API รายอื่น
Web Application Firewall Limits:
แม้ว่าเราไม่ได้ให้รายละเอียดเกี่ยวกับกฎ WAF ของเราโดยตรง แต่หากเกิดข้อผิดพลาด HTTP 403 ขึ้นกับคุณ นั่นแสดงว่าคุณได้ละเมิดกฎไปแล้ว โดยมากแล้ว เป็นไปได้ที่จะเกิดจากการส่งคำขอมากเกินไปภายในระยะเวลา 5 นาที อย่างไรก็ตาม หากคุณส่งคำขอที่อาจถูกมองว่าเป็นอันตราย การกระทำดังกล่าวอาจส่งผลให้มีการแบนนานขึ้น

หากฉันใช้งานเกิน Limits จะมีการจำกัดบัญชี, API Key, หรือ IP Address ของฉันหรือไม่

สำหรับ Hard-Limits เมื่อคุณดำเนินการเกินขีด Total Request Weight/นาที (ปัจจุบันคือ 1,200) จะส่งผลให้มีการแบน IP ส่วน Order Limit (ปัจจุบันคือ 50 ต่อ 10 วินาที และ 160,000 ต่อ 24 ชั่วโมง) จะขึ้นอยู่กับบัญชี หากดำเนินการเกินขีด Order Limit แล้ว ผู้ใช้จะไม่สามารถสร้าง Order ใหม่บนเว็บไซต์ (หรือแอปพลิเคชันอื่นๆ ของเรา) ได้
สำหรับการใช้เกินขีด Machine Learning Limits ข้อจำกัดจะมีผลกับบัญชี หากผู้ใช้ถูกจำกัดการใช้งานโดยระบบ ML ผู้ใช้สามารถตรวจสอบเหตุผลและระยะเวลาโดยใช้ Endpoint ของ [/sapi /v1/account/status] (ระบุอยู่ในเอกสาร API ของเรา)
ข้อจำกัดของ Web Application Firewall จะมีผลต่อ IP เท่านั้น โดยปกติการแบน WAF จะมีระยะเวลา 5 นาที อย่างไรก็ตาม หากเซิร์ฟเวอร์ตรวจจับคำขอของผู้ใช้ว่าเป็นอันตราย ระยะเวลาการแบนอาจจะขยายออกไป

ฉันถูกจำกัดการใช้งานเพราะดำเนินการเกินขีด Limit แต่ฉันแก้ไข Code ของฉันแล้ว คุณจะยกเลิกการแบนของฉันก่อนไหม

ไม่ คุณต้องรอจนกว่าจะสิ้นสุดการแบน

ทำไมฉันถึงได้รับข้อผิดพลาด HTTP 403 เมื่อใช้ API

คุณได้ละเมิดกฎ WAF (Web Application Firewall) โดยส่วนใหญ่จะเป็นการละเมิด Rate Limit หรือส่งคำขอที่เป็นอันตราย (ตามที่ระบุไว้ในส่วน Limits ของเอกสารนี้) โดยปกติการแบนเหล่านี้จะมีระยะเวลา 5 นาที

เหตุใดการเชื่อมต่อ WebSocket ของฉันจึงหลุด/ถูกตัดการเชื่อมต่อ

ทุกๆ 3 นาที การเชื่อมต่อ WebSocket ที่ใช้งานอยู่จะได้รับ Ping หากคุณไม่ตอบสนองด้วย Framed Pong อย่างถูกต้อง การเชื่อมต่อของคุณจะถูกยกเลิก
สำหรับสตรีมข้อมูลผู้ใช้ หากไม่ได้รับ Keep-alive อย่างน้อยหนึ่งครั้งในทุกๆ 60 นาที Listen Key จะหมดอายุ รายละเอียดของเรื่องนี้จะอยู่ในเอกสาร API ของเรา

ฉันใช้บริการ/Wrapper ของบุคคลที่สาม แต่มีปัญหาในการใช้งาน คุณสามารถช่วยฉันได้หรือไม่

ขออภัยด้วยที่เราไม่สนับสนุนบริการหรืออุปกรณ์ของบุคคลที่สาม โปรดติดต่อฝ่ายบริการลูกค้าและ/หรือนักพัฒนา เพื่อขอความช่วยเหลือเพิ่มเติม
นอกจากนี้ การป้อนรหัส Binance API Key หรือ Secret Key ของคุณในแพลตฟอร์มของบุคคลที่สามถือว่ามีเสี่ยงด้านความปลอดภัย โปรดใช้บริการเหล่านี้ตามดุลยพินิจของคุณเอง
โปรดทราบว่าเราจะไม่ให้ความช่วยเหลือด้านการเขียนโปรแกรมทั่วไปอีกด้วย

ฉันไม่ได้เปลี่ยนแปลงอะไรเลย แต่จู่ๆ ก็ได้รับข้อผิดพลาด เกิดอะไรขึ้น?

ต้องขออภัยด้วยที่เราไม่สามารถช่วยแก้ปัญหาเกี่ยวกับการใช้งานส่วนบุคคลของคุณได้ หากคุณใช้ Wrapper/อุปกรณ์ของบุคคลที่สาม โปรดติดต่อทีมสนับสนุน/ทีมพัฒนาเพื่อขอความช่วยเหลือ

ฉันต้องการเข้าถึง Secret Key ของฉัน แต่ระบบแสดง "***" ฉันจะเรียกดูข้อมูลนี้ได้อย่างไร? 

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

ฉันสามารถเพิ่ม Limits หรือ Stream/Bandwidth เฉพาะได้หรือไม่

ขออภัย ขณะนี้เรายังไม่ได้รองรับบริการดังกล่าว เนื่องจากขีดจำกัดที่เราให้บริการสามารถใช้งานได้อย่างเหมาะสมอยู่เเล้ว 

API Key ของฉันหายไป ช่วยด้วย!

มีสองสาเหตุที่ API Key จะหายไป ได้เเก่
  1. หากคุณไม่ได้ใช้งานเมื่อเร็วๆ นี้และคุณใช้ API ก่อนวันที่ 7 มีนาคม 2018 อาจเป็นไปได้ว่าระบบได้ลบ API Key ของคุณออกไปแล้วเพื่อรักษาความปลอดภัยของบัญชีของคุณ
  2. หากคุณได้ปิดการใช้งานบัญชีของคุณ การดำเนินการนี้จะส่งผลให้ API Key ที่ใช้งานอยู่ทั้งหมดถูกลบออกไป
ทั้งนี้ คุณสามารถสร้าง API Key ใหม่ได้

ฉันได้รับ "Error-1021 (ข้อความ: ไทม์แสตมป์สำหรับคำขอนี้อยู่นอก recvWindow)" ฉันจะแก้ไขปัญหานี้ได้อย่างไร?

โดยทั่วไป ข้อผิดพลาดนี้จะเกิดขึ้นหากมีการยกเลิกการซิงค์ (Desync) ระหว่างเวลาเซิร์ฟเวอร์และเวลาระบบของคุณ คุณอาจต้องทำการซิงค์ (Sync) นาฬิการะบบของคุณ ทั้งนี้ วิธีการตั้งค่าดังกล่าวจะแตกต่างกันออกไปโดยขึ้นอยู่กับระบบปฏิบัติการ
สำหรับ Windows คุณสามารถใช้เครื่องมือเช่น "Atomic Clock" ได้ ตามดุลยพินิจของคุณเอง ผู้ใช้ Linux และ Mac สามารถลองซิงค์กับ "ntpdate" ผ่านทาง Command Line ได้
หากยังไม่สามารถแก้ไขปัญหาได้ ปัญหาอาจเกี่ยวข้องกับช่วงเวลา Latency (ปัญหา Network) และคุณอาจจำเป็นต้องปรับ recvWindow ของคุณ

สามารถขอฟังก์ชัน API ใหม่ได้หรือไม่

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

ฉันคิดว่า API ของฉันมีปัญหา ฉันจะรายงานได้อย่างไร

หากคุณรู้สึกว่าระบบมีปัญหาที่ไม่ได้เกิดจากการใช้งานของคุณ โปรดแสดงหลักฐานเกี่ยวกับปัญหาดังกล่าว โดยคุณสามารถติดต่อเราผ่านทาง Telegram API Chat และเราจะดำเนินการตรวจสอบกรณีดังกล่าว โปรดทราบว่า เราจะไม่รับพิจารณาข้อความหรือการร้องเรียนที่คลุมเครือ นอกจากนี้ ห้องสนทนาดังกล่าวไม่ใช่ฝ่ายสนับสนุนด้านการเขียนโปรแกรมอย่างเป็นทางการ แต่เป็นกลุ่มชุมชนสำหรับผู้ใช้ Binance API เท่านั้น
อัปเดตล่าสุดเมื่อ 1 มิถุนายน 2021