วิธีการจัดทำข้อมูลอัตราแลกเปลี่ยน

1. ประเภทแหล่งข้อมูล

ฟิลด์สาธารณะ source อธิบายประเภทข้อมูล ไม่ใช่ผู้จำหน่าย live คือข้อมูลตลาดสปอตเพื่อการอ้างอิงที่อาจอัปเดตเป็นช่วงสั้น ๆ ระหว่างสัปดาห์การซื้อขายระหว่างธนาคาร ecb_daily คืออัตราอ้างอิงของธนาคารกลางยุโรป ซึ่งโดยปกติจะเผยแพร่วันละครั้งในวันทำการ market_daily เก็บอัตราปิดรายวันจากฟีดข้อมูลตลาดสำหรับสกุลเงินที่ไม่มีอัตราอ้างอิงที่กำหนดโดย ECB

การตอบกลับที่มีหลายสกุลเงินจะมีแมป sources สำหรับแต่ละสกุลเงินที่แสดงอัตรา ฟิลด์ source ระดับบนสุดใช้แนวทางระมัดระวัง โดยรายงานประเภทข้อมูลที่มีความสดใหม่น้อยที่สุดในการตอบกลับนั้น

อ้างอิง: อัตราแลกเปลี่ยนอ้างอิงเงินยูโรของ ECB

2. เวลาและสถานะตลาด

data_updated_at คือเวลาที่ข้อมูลที่บันทึกไว้ซึ่งเป็นพื้นฐานของอัตราถูกเขียนครั้งล่าสุด timestamp คือเวลาที่สร้างการตอบกลับของ API ใช้ค่าแรกเพื่อคำนวณอายุข้อมูล และค่าหลังเพื่อตรวจสอบเวลาของคำขอ

market_session เป็น open ระหว่างสัปดาห์การซื้อขายระหว่างธนาคาร เป็น weekend หลังปิดตลาดวันศุกร์เวลา 17:00 ในนิวยอร์กจนถึงวันอาทิตย์เวลา 17:00 ในนิวยอร์ก หรือเป็น interbank_closed เมื่อมีการปิดตลาดที่ทราบล่วงหน้าซึ่งไม่ใช่ช่วงสุดสัปดาห์ การตอบกลับในช่วงสุดสัปดาห์อาจมีข้อมูลรายการสุดท้ายจากสัปดาห์การซื้อขาย ป้ายกำกับนี้ไม่ได้หมายความว่ามีการเสนอราคาใหม่ในช่วงสุดสัปดาห์

3. การเปลี่ยนสกุลเงินฐานและอัตราไขว้ที่คำนวณได้

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

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

4. ข้อมูลที่บันทึกไว้ย้อนหลัง

ข้อมูลย้อนหลังรายวันรวมอัตราอ้างอิงที่กำหนดไว้และอัตราปิดตลาด ข้อมูลสกุลเงินหลักย้อนหลังไปถึงปี 1999 โดยประมาณ 30 สกุลเงินใช้อัตราอ้างอิงที่กำหนดโดย ECB ส่วนอีก 113 สกุลเงินใช้อัตราปิดตลาด และวันที่เริ่มต้นข้อมูลแตกต่างกันตามคู่สกุลเงิน ในวันสุดสัปดาห์หรือวันหยุดที่ไม่มีการกำหนดอัตราอ้างอิงใหม่ อาจยกข้อมูลที่บันทึกไว้ก่อนหน้ามาใช้และระบุป้ายกำกับ is_forward_filled: true API ไม่สร้างอัตราอ้างอิงที่ยังไม่ได้เผยแพร่ขึ้นมาเอง

5. การตรวจสอบความถูกต้องและการเผยแพร่

รหัสระบุสกุลเงินจะถูกปรับให้อยู่ในรูปแบบรหัสตัวพิมพ์ใหญ่ตามแบบ ISO ก่อนกำหนดอัตรา
ฟิลด์แหล่งข้อมูลและเวลาอัปเดตจะมาพร้อมข้อมูลที่บันทึกไว้ แทนที่จะให้ไคลเอนต์อนุมานเอง
เมื่อข้อมูลสดที่บันทึกไว้ไม่มีอยู่หรือเก่าเกินไป ระบบจะเปลี่ยนไปใช้ประเภทข้อมูลอ้างอิงรายวันที่มีอยู่ แทนการระบุว่าเป็นข้อมูลสด
ทุกแพลนใช้แหล่งข้อมูลเดียวกัน ผู้เรียกใช้ Free และผู้เรียกใช้โดยไม่มีคีย์จะได้รับอัตราแบบสดล่าช้า 15 นาที
งานวิจัยที่เผยแพร่ต้องระบุช่วงเวลาการวัด จำนวนตัวอย่าง วิธีการ และข้อจำกัด

6. ข้อจำกัด

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

7. มาตรฐานการเปรียบเทียบความสดใหม่

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

ประวัติการแก้ไข

1.1 · 9 ตุลาคม 2026: อธิบายความล่าช้าของ Free และอัตราปิดตลาดรายวันให้ชัดเจนขึ้น

1.0 · 16 กรกฎาคม 2026: วิธีการฉบับสาธารณะครั้งแรก ความหมายของแหล่งข้อมูล กฎช่วงการซื้อขายของตลาด นโยบายการคำนวณอัตราจากอัตราอื่น ลักษณะการจัดการข้อมูลย้อนหลัง ข้อจำกัด และมาตรฐานการเผยแพร่ผลการทดสอบเปรียบเทียบ

การแก้ไขข้อมูล: hello@exchangerate.dev