แก้ปัญหาข้อผิดพลาดในการเชื่อมต่อ API Key ของ Exchange

เมื่อคุณเพิ่ม API key ของ exchange Freya จะ ตรวจสอบก่อนบันทึก — และหากมีอะไรไม่ถูกต้อง ระบบจะบอกคุณว่าต้องแก้อะไร คู่มือฉบับนี้จะช่วยให้คุณอ่านผลการตรวจสอบนั้นและแก้ไขได้ (หาก key ของคุณเชื่อมต่อสำเร็จแล้ว แต่ bot มาหยุดทำงานทีหลัง นั่นเป็นคนละปัญหากัน — ดู ทำไม Bot ของฉันถึงหยุดชั่วคราวหรือหยุดทำงาน?)

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

เมื่อ Key เชื่อมต่อไม่สำเร็จ

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

"API Key ไม่ถูกต้อง" หรือ "Secret Key ไม่ถูกต้อง"

ข้อผิดพลาดการเชื่อมต่อที่พบบ่อยที่สุด และมักจะแก้ง่ายที่สุดด้วย:

• ความผิดพลาดตอน copy/paste — มีช่องว่างแปลกปลอมหรือตัวอักษรหายไป ให้ copy ทั้ง key และ secret ใหม่อย่างระมัดระวัง
• Secret จะแสดงเพียงครั้งเดียว exchange จะเปิดเผย secret key ให้เห็นเพียงครั้งเดียวตอนที่คุณสร้างมัน หากคุณไม่ได้บันทึกไว้ ก็ไม่สามารถกู้คืนได้ — ให้สร้าง key ใหม่
• key ถูกลบหรือถูกสร้างใหม่ บน exchange จึงไม่ตรงกันอีกต่อไป

วิธีแก้: กรอก key และ secret ใหม่ให้ตรงเป๊ะ หรือสร้าง key ใหม่แล้วลองอีกครั้ง

ข้อผิดพลาดเกี่ยวกับการจำกัด IP

Freya เชื่อมต่อจากเซิร์ฟเวอร์ของตัวเอง การตั้งค่า IP ของ key จึงมีความสำคัญ โดยมีสองกรณีที่ต่างกัน:

• "IP ไม่อยู่ใน Whitelist" — key ของคุณถูกจำกัด IP ไว้ แต่ที่อยู่เซิร์ฟเวอร์ของ Freya ยังไม่อยู่ในรายการที่อนุญาต หน้าจอเพิ่ม API Key จะ แสดง IP Address ที่ต้องเพิ่มให้คุณ (พร้อมปุ่มคัดลอก) — ให้นำไปเพิ่มใน Whitelist ของ key บน exchange
• "Unrestricted" — key ของคุณ ไม่มีการจำกัด IP เลย เพื่อความปลอดภัยของคุณ Freya จะขอให้คุณ เปิดใช้งานการจำกัด IP และเพิ่มที่อยู่ที่แสดงไว้ จากนั้นลองอีกครั้ง

ทั้งสองกรณีวิธีแก้อยู่บนแนวคิดเดียวกัน คือจำกัด key ให้ใช้ได้เฉพาะ IP ที่ Freya แสดงในหน้าต่างนั้น

ข้อผิดพลาดเกี่ยวกับสิทธิ์

key เชื่อมต่อได้ แต่ทำสิ่งที่ bot ของคุณต้องการไม่ได้:

• สิทธิ์การอ่านถูกปิดใช้งาน — ให้เปิดใช้งานสิทธิ์อ่าน/ดูข้อมูลบน key
• ไม่มีสิทธิ์เทรด — ให้เปิดใช้งานการเทรด (spot และ/หรือ futures ให้ตรงกับ bot ของคุณ)
• Spot กับ Futures ไม่ตรงกัน — bot แบบ futures ต้องใช้ key ที่เปิดใช้งานการเทรด futures ส่วน bot แบบ spot ต้องใช้การเทรด spot หากคุณเพิ่ม key ที่เป็น spot อย่างเดียวให้กับ bot แบบ futures (หรือกลับกัน) Freya จะแจ้งเตือน ตรวจสอบให้แน่ใจว่าตลาดที่ key เปิดใช้งานไว้ตรงกับ bot ที่คุณกำลังสร้าง

จำไว้ว่า Freya ต้องการเพียงสิทธิ์ อ่านและเทรด เท่านั้น — ไม่ต้องมีสิทธิ์ถอนเงินเด็ดขาด key ที่ไม่มีสิทธิ์ถอนเงินคือสิ่งที่คุณต้องการพอดี

ข้อควรระวังเฉพาะของแต่ละ Exchange

• OKX ต้องใช้ Passphrase เมื่อคุณสร้าง key ของ OKX คุณจะตั้ง passphrase ไว้ — ให้กรอก passphrase ตัวเดียวกันนั้นใน Freya ให้ตรงกับที่ตั้งไว้ทุกตัวอักษร passphrase ที่ผิดเป็นสาเหตุการเชื่อมต่อ OKX ล้มเหลวที่พบบ่อย
• การตั้งค่า Futures ของ OKX การเทรด futures บน OKX ต้องใช้โหมดบัญชีเฉพาะ ซึ่ง Freya ตั้งค่าให้คุณโดยอัตโนมัติ — คุณไม่ต้องตั้งค่าเองด้วยมือ
• Hedge Mode (futures) Freya ใช้ hedge mode สำหรับบัญชี futures หากคุณมี position แบบ one-way ที่เปิดอยู่และขัดแย้งกัน คุณอาจเห็น คำเตือน แทนที่จะเป็นความล้มเหลว — key ยังคงถูกบันทึก และ bot ของคุณจะเทรดได้เมื่อปิด position ที่มีอยู่เหล่านั้นแล้ว
• Binance และ Bybit ไม่ใช้ passphrase — จึงไม่มีช่องกรอก passphrase สำหรับสองแห่งนี้

"การเชื่อมต่อล้มเหลว" โดยไม่มีเหตุผลที่ชัดเจน

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

ยังติดอยู่ใช่ไหม? เช็กลิสต์ฉบับย่อ

1. สร้าง key ใหม่ บน exchange โดยเปิดสิทธิ์ อ่าน + เทรด เท่านั้น (ห้ามมีสิทธิ์ถอนเงินเด็ดขาด)
2. จำกัดให้ใช้ได้เฉพาะ IP ที่ Freya แสดงในหน้าจอเพิ่ม API Key
3. จับคู่ตลาดให้ตรงกัน — key แบบ spot สำหรับ bot แบบ spot, key แบบ futures สำหรับ bot แบบ futures
4. OKX: กรอก passphrase ให้ตรงเป๊ะ
5. ยังล้มเหลวอยู่? ติดต่อ [email protected]

คำถามที่พบบ่อย

Freya แจ้งว่า "API Key ไม่ถูกต้อง" แต่ฉันมั่นใจว่า copy มาถูกต้องแล้ว — เกิดอะไรขึ้น?

โดยทั่วไปมักมีตัวอักษรที่มองไม่เห็นหรือช่องว่างแทรกเข้าไปใน key หรือ secret หรือไม่ก็ key ถูกสร้างใหม่/ถูกลบบน exchange จึงไม่ตรงกันอีกต่อไป ให้ copy ทั้งสองช่องใหม่อย่างระมัดระวัง และจำไว้ว่า secret จะแสดงเพียงครั้งเดียวตอนสร้างเท่านั้น — หากคุณไม่มีมันแล้ว ให้สร้าง key ใหม่

"IP ไม่อยู่ใน Whitelist" กับ "Unrestricted" ต่างกันอย่างไร?

"IP ไม่อยู่ใน Whitelist" หมายความว่า key ของคุณถูกจำกัด IP ไว้ แต่ที่อยู่เซิร์ฟเวอร์ของ Freya ยังไม่ได้รับอนุญาต — ให้เพิ่มที่อยู่ที่ Freya แสดงลงใน Whitelist ของ key ส่วน "Unrestricted" หมายความว่า key ไม่มีการจำกัด IP เลย เพื่อความปลอดภัย Freya จะขอให้คุณเปิดใช้งานการจำกัด IP และเพิ่มที่อยู่ของ Freya เข้าไปก่อนบันทึก

key OKX ของฉันเชื่อมต่อไม่ได้ — ฉันจำเป็นต้องใช้ passphrase หรือไม่?

ใช่ key ของ OKX มี passphrase ที่คุณตั้งไว้ตอนสร้าง key คุณต้องกรอก passphrase นั้นให้ตรงเป๊ะใน Freya — passphrase ที่ผิดหรือขาดหายไปเป็นสาเหตุการเชื่อมต่อ OKX ล้มเหลวที่พบบ่อย ส่วน Binance และ Bybit ไม่ได้ใช้ passphrase

Freya แจ้งว่า key ของฉันวางคำสั่งเทรดไม่ได้ — ต้องแก้อย่างไร?

key ของคุณยังไม่ได้เปิดใช้งานการเทรดสำหรับตลาดที่ bot ของคุณใช้ ให้เข้าไปที่ exchange แล้วเปิดสิทธิ์เทรด — การเทรด spot สำหรับ bot แบบ spot และการเทรด futures สำหรับ bot แบบ futures จากนั้นเชื่อมต่อใหม่ Freya ต้องการสิทธิ์อ่านและเทรด ไม่ต้องมีสิทธิ์ถอนเงินเด็ดขาด

key แบบ futures ของฉันต้องตั้งค่าเพิ่ม (โหมดบัญชี / hedge mode) — เป็นปัญหาหรือไม่?

ไม่ การเทรด futures ต้องใช้โหมดบัญชีเฉพาะและ hedge mode ซึ่ง Freya ตั้งค่าให้คุณโดยอัตโนมัติ หากคุณมี position แบบ one-way ที่เปิดอยู่ คุณอาจเห็นคำเตือนเรื่อง hedge mode แทนที่จะเป็นข้อผิดพลาด — key ยังคงถูกบันทึก และ bot ของคุณจะเทรดได้เมื่อปิด position เหล่านั้นแล้ว

ฉันเพิ่ม key แบบ spot แต่ bot แบบ futures ของฉันไม่ยอมใช้มัน (หรือกลับกัน) — เพราะอะไร?

key จะถูกเปิดใช้งานสำหรับตลาดใดตลาดหนึ่งโดยเฉพาะ bot แบบ futures ต้องใช้ key ที่เปิดใช้งานการเทรด futures และ bot แบบ spot ต้องใช้การเทรด spot หากไม่ตรงกัน Freya จะแจ้งเตือน ให้เชื่อมต่อ key ที่ตลาดซึ่งเปิดใช้งานไว้ตรงกับ bot ที่คุณกำลังสร้าง

การเชื่อมต่อ "ล้มเหลว" เฉย ๆ โดยไม่มีเหตุผลชัดเจน — เป็นที่ฉันหรือที่ exchange?

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