แพลตฟอร์มเปิด Huitong

ปฏิทินข้อมูลเศรษฐกิจ

ปฏิทินข้อมูลเศรษฐกิจมหภาคมีข้อมูลมากกว่า 20 ปีจากประเทศหลักทั่วโลก ครอบคลุม 3 หมวดหมู่หลัก ได้แก่ ข้อมูลเศรษฐกิจ เหตุการณ์ และวันหยุด ผู้ใช้สามารถค้นหาข้อมูลที่ต้องการได้อย่างรวดเร็วด้วยตัวกรอง เช่น วันที่ ประเทศ และระดับความสำคัญ ปฏิทินการเงินไม่เพียงจัดระเบียบข้อมูลสำคัญ เช่น ระดับความสำคัญ ค่าเดิม ค่าคาดการณ์ และค่าจริง แต่ยังมีการตีความข้อมูลเพื่อช่วยให้ผู้ใช้เข้าใจผลกระทบที่อาจเกิดขึ้นต่อตลาด นอกจากนี้ยังรองรับการอัปเดตอัตโนมัติ เพื่อให้ผู้ใช้ได้รับข้อมูลล่าสุดและถูกต้องที่สุดทันทีหลังการเผยแพร่

ปฏิทิน API

1. รายการปฏิทิน

1.1 ที่อยู่ Interface

GET http://***.***.***/Calendar/lists/d/{d}

1.2 คำอธิบายพารามิเตอร์

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
d	string	ใช่	ช่วงข้อมูล (W/W1/M/M1) หรือวันที่เฉพาะ (yyyyMMdd) รายละเอียดเพิ่มเติมดูจากข้อความผิดพลาดของ API ค่าเหล่านี้ถูกควบคุมโดยข้อจำกัดของ IP

W:สัปดาห์ปัจจุบัน
W1:สัปดาห์หน้า
M:30 วันก่อนวันนี้ (ไม่รวมวันนี้)
M1:30 วันหลังจากวันนี้ (รวมวันนี้)
yyyyMMdd:วันที่เฉพาะ เช่น 20250708

1.3 พารามิเตอร์การตอบกลับ

ชื่อ	คำอธิบาย
ID	รหัสตัวชี้วัด
RECORD_ID	รหัสบันทึก
IDX_ID	รหัสตัวชี้วัดภายใน
PUBLISH_TIME	เวลาเผยแพร่
UPDATE_TIME	เวลาอัปเดต
PUBLISH_ORG	สถาบันที่เผยแพร่
UPDATE_PERIOD	ความถี่ในการเผยแพร่ 1:รายวัน 2:รายสัปดาห์ 3:รายเดือน 4:รายไตรมาส 5:รายปี
AFFECT	กฎผลกระทบต่อตลาด
TITLE	ชื่อดัชนี
IDX_PERIOD	ช่วงเวลา
IDX_DESC_CN	คำอธิบาย
UNIT	หน่วย
COUNTRY_CN	ประเทศ
IDX_RELEVANCE	ความสำคัญ (1,2,3) — 1 ต่ำสุด; 3 สูงสุด
PREVIOUS_PRICE	ค่าก่อนหน้า
SURVEY_PRICE	ค่าคาดการณ์
ACTUAL_PRICE	ค่าจริง
STATUS	สถานะการเผยแพร่: 1-เผยแพร่แล้ว, 0-รอ
Res	ข้อมูลแนวโน้มขาขึ้น/ขาลง

ตัวอย่างการตอบกลับ

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "ID": "43627",
      "RECORD_ID": "558993",
      "IDX_ID": "112022041910001492",
      "PUBLISH_TIME": "2025-07-08 02:00:00",
      "UPDATE_TIME": "2025-07-08 08:43:43",
      "PUBLISH_ORG": "กระทรวงการคลังสหรัฐฯ",
      "UPDATE_PERIOD": "2",
      "AFFECT": "",
      "TITLE": "การประมูลพันธบัตรสหรัฐฯ อายุ 3 เดือน วันที่ 7 ก.ค. – มูลค่ารวม",
      "IDX_PERIOD": "7月7日",
      "IDX_DESC_CN": "การประมูลพันธบัตรอายุ 3 เดือน – มูลค่ารวม",
      "UNIT": "100 ล้าน USD",
      "COUNTRY_CN": "สหรัฐอเมริกา",
      "IDX_RELEVANCE": "2",
      "PREVIOUS_PRICE": "843.3",
      "SURVEY_PRICE": "",
      "ACTUAL_PRICE": "867.2",
      "STATUS": "0",
      "Res": "||"
    }
  ]
}

2. รายละเอียดปฏิทินการเงิน

2.1 ที่อยู่ Interface

GET http://***.***.***/Calendar/detail/id/{id}

2.2 คำอธิบายพารามิเตอร์

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
id	string	ใช่	รหัสตัวชี้วัด

2.3 พารามิเตอร์การตอบกลับ

ชื่อ	คำอธิบาย
IDX_ID	รหัสตัวชี้วัด
PIC_INTERPRE	หมายเหตุกราฟ
COUNTRY_CN	ประเทศ
IDX_DESC_CN	คำอธิบายตัวชี้วัด
PUBLISH_ORG	สถาบันที่เผยแพร่
UPDATE_PERIOD	ความถี่ในการเผยแพร่ 1:รายวัน 2:รายสัปดาห์ 3:รายเดือน 4:รายไตรมาส 5:รายปี
PARAGHRASE	การตีความข้อมูล
UNIT	หน่วย
UNIT_RATE	อัตราส่วน
KEY_WORD	คำสำคัญของตัวชี้วัด

ตัวอย่างการตอบกลับ

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "IDX_ID": "112015032410000271",
      "PIC_INTERPRET": "จากมุมมองของการไหลของทุนข้ามประเทศ สิ่งนี้มีผลต่ออัตราแลกเปลี่ยน JPY การไหลเข้าของเงินสุทธิเป็นบวกต่อ JPY",
      "COUNTRY_CN": "ญี่ปุ่น",
      "IDX_DESC_CN": "การซื้อหุ้นญี่ปุ่นโดยชาวต่างชาติ",
      "PUBLISH_ORG": "กระทรวงการคลัง ประเทศญี่ปุ่น",
      "UPDATE_PERIOD": "2",
      "PARAGHRASE": "สถิติรายสัปดาห์เกี่ยวกับการซื้อหลักทรัพย์ต่างประเทศภายในประเทศและการซื้อหลักทรัพย์ญี่ปุ่นโดยชาวต่างชาติ รวมทั้งหุ้นและพันธบัตร การเปลี่ยนแปลงขนาดการซื้อแสดงแนวโน้มการไหลเข้า-ออก",
      "UNIT": "100 ล้านเยน",
      "UNIT_RATE": "*10",
      "KEY_WORD": "(JP) ข้อมูลการไหลของทุนรายสัปดาห์"
    }
  ]
}

3. ประกาศวันหยุด

3.1 ที่อยู่ Interface

API การสืบค้นแบบชุด

GET http://***.***.***/Calendar/forecast/type/{type}/interval/{interval}

API รายละเอียดวันเดียว

GET http://***.***.***/Calendar/eventholiday/date/{date}/type/{type}

3.2 คำอธิบายพารามิเตอร์

หมายเหตุ: เมื่อพารามิเตอร์เส้นทางเป็นตัวเลือกและไม่ได้ระบุค่า ควรละเว้นพารามิเตอร์เส้นทางก่อนหน้าด้วย ห้ามละเว้นพารามิเตอร์เพียงตัวเดียว

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
interval	string	ไม่ใช่	day: วันปัจจุบัน, week: สัปดาห์ปัจจุบัน (ค่าเริ่มต้น) ใช้เฉพาะการสืบค้นแบบชุด
type	int	ใช่	1: ประกาศวันหยุด; 2: การออกพันธบัตรรัฐบาล; 3: เหตุการณ์เศรษฐกิจ
date	string	ไม่ใช่	วันที่ในรูปแบบ yyyyMMdd ใช้เฉพาะการสืบค้นวันเดียว

3.3 พารามิเตอร์การตอบกลับ

ชื่อ	คำอธิบาย
ID	รหัสเหตุการณ์
COUNTRY	ประเทศ
AREA	สถานที่
EVENT_DESC	คำอธิบายเหตุการณ์
EVENT_TIME	เวลาของเหตุการณ์
IMPORTANCE	ความสำคัญ (1,2,3) — ตัวเลขสูงหมายถึงความสำคัญมากขึ้น
TIME_FLAG	ธงเวลา (ยังไม่ได้ใช้)
UPDATE_TIME	เวลาอัปเดต

ตัวอย่างการตอบกลับ

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "ID": "55302",
      "COUNTRY": "สหรัฐอเมริกา",
      "AREA": "",
      "EVENT_DESC": "CFTC เผยแพร่รายงานสถานะรายสัปดาห์",
      "EVENT_TIME": "2025-08-09 03:30:00",
      "IMPORTANCE": "2",
      "TIME_FLAG": "1",
      "UPDATE_TIME": null
    }
  ]
}

4. ข้อมูลสหรัฐฯ (30 วันที่ผ่านมา)

4.1 ที่อยู่ Interface

GET http://***.***.***/Calendar/usaData

4.2 พารามิเตอร์การตอบกลับ

ชื่อ	คำอธิบาย
ID	รหัสข้อมูล
STATUS	รหัสสถานะ 0-รอดำเนินการ, 1-เผยแพร่แล้ว
IDX_PID	รหัสตัวชี้วัดที่เกี่ยวข้อง
IDX_PERIOD	ช่วงเวลาตัวชี้วัด
IDX_ID	รหัสตัวชี้วัด
PUBLISH_TIME	เวลาเผยแพร่
UNKNOWN	ฟิลด์ไม่ทราบ
COUNTRY	ประเทศ (ภาษาอังกฤษ)
COUNTRY_CN	ประเทศ (ภาษาจีน)
IDX_DESC_CN	คำอธิบายตัวชี้วัด
PREVIOUS_PRICE	ค่าก่อนหน้า
ACTUAL_PRICE	ค่าจริง
SURPLUS_PRICE	ค่าคาดการณ์
GT_RES	ปัจจัยบวกต่อราคา
LT_RES	ปัจจัยลบต่อราคา
REVISED_PRICE	ค่าที่แก้ไข
UNIT	หน่วยตัวชี้วัด
UNIT_RATE	อัตราส่วนของหน่วย
IDX_RELEVANCE	ความสำคัญ (1,2,3) — 1 ต่ำสุด; 3 สูงสุด
next_publish_time	วันที่เผยแพร่ครั้งถัดไป

ตัวอย่างการตอบกลับ

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "ID": "14071",
      "STATUS": "0",
      "IDX_PID": "112015032410000192",
      "IDX_PERIOD": "สัปดาห์ของวันที่ 3 ต.ค.",
      "IDX_ID": "112015032410013900",
      "PUBLISH_TIME": "2015-10-08 20:30:00",
      "UNKNOWN": null,
      "COUNTRY": "UNITED STATES",
      "COUNTRY_CN": "สหรัฐอเมริกา",
      "IDX_DESC_CN": "ค่าเฉลี่ยการขอรับสวัสดิการว่างงานเริ่มต้น 4 สัปดาห์",
      "PREVIOUS_PRICE": null,
      "ACTUAL_PRICE": null,
      "SURVEY_PRICE": null,
      "GT_RES": "ดอลลาร์สหรัฐ",
      "LT_RES": "ทองคำ เงิน น้ำมัน",
      "REVISED_PRICE": null,
      "UNIT": "หมื่น",
      "UNIT_RATE": "/10",
      "IDX_RELEVANCE": "3",
      "next_publish_time": "2015-10-15 20:30:00"
    }
  ]
}

5. ปฏิทินเศรษฐกิจรายสัปดาห์ (สัปดาห์ปัจจุบัน)

5.1 ที่อยู่ Interface

GET http://***.***.***/Calendar/ecweek

5.2 พารามิเตอร์การตอบกลับ

ชื่อ	คำอธิบาย
ID	รหัสข้อมูล
STATUS	รหัสสถานะ 0-รอดำเนินการ, 1-เผยแพร่แล้ว
IDX_PID	รหัสตัวชี้วัดที่เกี่ยวข้อง
IDX_PERIOD	ช่วงเวลาตัวชี้วัด
IDX_ID	รหัสตัวชี้วัด
PUBLISH_TIME	เวลาเผยแพร่
UNKNOWN	ฟิลด์ไม่ทราบ
COUNTRY	ประเทศ (ภาษาอังกฤษ)
COUNTRY_CN	ประเทศ (ภาษาจีน)
IDX_DESC_CN	คำอธิบายตัวชี้วัด
PREVIOUS_PRICE	ค่าก่อนหน้า
ACTUAL_PRICE	ค่าจริง
SURPLUS_PRICE	ค่าคาดการณ์
GT_RES	ปัจจัยบวกต่อราคา
LT_RES	ปัจจัยลบต่อราคา
REVISED_PRICE	ค่าที่แก้ไข
UNIT	หน่วยตัวชี้วัด
UNIT_RATE	อัตราส่วนของหน่วย
IDX_RELEVANCE	ความสำคัญ (1,2,3) — 1 ต่ำสุด; 3 สูงสุด

ตัวอย่างการตอบกลับ

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "ID": "349",
      "STATUS": "0",
      "IDX_PID": "112015032410000269",
      "IDX_PERIOD": "สัปดาห์ของวันที่ 6 ต.ค.",
      "IDX_ID": "112015032410000271",
      "PUBLISH_TIME": "2015-10-15 07:50:00",
      "UNKNOWN": null,
      "COUNTRY": "JAPAN",
      "COUNTRY_CN": "ญี่ปุ่น",
      "IDX_DESC_CN": "การซื้อหุ้นญี่ปุ่นโดยชาวต่างชาติ",
      "PREVIOUS_PRICE": null,
      "ACTUAL_PRICE": null,
      "SURVEY_PRICE": null,
      "GT_RES": "",
      "LT_RES": "ดอลลาร์สหรัฐ",
      "REVISED_PRICE": null,
      "UNIT": "100 ล้านเยน",
      "UNIT_RATE": "*10",
      "IDX_RELEVANCE": "1"
      }
    ]
}