跳转至

休市日历

GetHolidayCalendar / CLI holiday-calendar / REST POST /api/holiday-calendar / MCP futu_get_holiday_calendar。要求 qot:readextension_version: 1--enable-desktop-phase2-reads;默认关闭,真实后端UNVERIFIED。

begin_time 必须是包含明确offset的RFC3339时间;end_time 可选,不能早于开始时间。拒绝没有offset的日期与非零小数秒。客户端将instant转成东八区秒格式发送,并在响应的 normalized_begin_timenormalized_end_time 中返回实际查询边界,不猜用户系统时区。

可选 seq_mark 原样作为下一页标记;star 为1至3,nation 使用国家数字标识,market_list 使用市场标识。股票/持仓筛选属于其它日历页,不在本接口中开放。

国家标识:0其他、1中国、2德国、3英国、4法国、5美国、6加拿大、7日本、8新加坡、9澳大利亚、10马来西亚、11韩国。市场标识:0未知、1美国、2香港、3新加坡、4中国内地、5日本、6加拿大、7澳大利亚、8马来西亚、9韩国。两组编号不能混用。

韩国国家/市场筛选遵循当前已确认的行情权限:明确无权限时移除,延时权限仍保留。响应 applied_filters 显示实际筛选;若移除后某筛选列表为空,按后台没有该筛选条件处理。只有请求韩国筛选时才需要该权限事实;尚未取得、已失效或应用身份不受支持时明确失败,本接口不会自行抢占最高权限、触发重连或启动权限刷新。

每次只返回一页。codedata、列表、seq_markhas_moretotal 保留缺失状态;缺 has_more 不表示最后一页。每条原始事件保留类型及完整描述字段,包括未知类型、缺时间、原始涨跌数值与链接;不套UI的行过滤或标题补值,链接不自动打开。事件时间戳单位为秒,未声明单位的数值不自行缩放。

futucli holiday-calendar --c2s-json '{"begin_time":"2026-12-25T00:00:00-05:00","end_time":"2026-12-25T23:59:59-05:00","nation":[5],"extension_version":1}'