Update api.md

Author: qos-max

api.md

@@ -1,8 +1,8 @@
  **[简体中文](https://github.com/qos-max/quote-ocean-system/blob/main/api.md) | [English](https://github.com/qos-max/quote-ocean-system/blob/main/api_en.md)**
 # QOS行情API(Quote Ocean System)接口文档
-**quote-ocean-system系统简称"QOS行情API"，包括了港股实时API,美股实时API,A股实时API，加密货币实时报价API，数字币实时行情API,采用REST API与websocket接口形式，非常容易接入。**</br>
-**免费开源股票API、港股API、美股API、沪深股票API、A股API实时股票行情数据、加密货币实时报价数据，数字币实时行情。**</br>
-**QOS行情报价系统目前提供：全港，全美，沪深等股票和加密货币（数字币）的实时报价，实时K线，历史K线数据等，欢迎免费试用及联系作者,现提供免费试用对接。**
+**quote-ocean-system系统简称"QOS行情API"，包括了港股实时API,美股实时API,A股实时API，加密货币实时报价API，数字币实时行情API,外汇API，贵金属API,黄金API，白银API，大宗商品API，能源API,采用REST API与websocket接口形式，非常容易接入。**</br>
+**免费开源股票API、港股API、美股API、沪深股票API、A股API实时股票行情数据、加密货币实时报价数据，数字币实时行情,外汇行情数据，贵金属行情数据,黄金行情报价，白银行情报价，大宗商品行情数据，能源行情数据**</br>
+**QOS行情报价系统目前提供：全港，全美，沪深等股票和加密货币（数字币），外汇，贵金属，大宗商品，黄金，白银，能源等的实时报价，实时K线，历史K线数据等，欢迎免费试用及联系作者,现提供免费试用对接。**
 - **官网**：[https://qos.hk](https://qos.hk)
 - **更新时间**：2025-3-15
 ## 联系作者：
@@ -33,6 +33,7 @@
 1.4.5、[获取交易品种的实时最新逐笔成交明细](#45获取交易品种的实时最新逐笔成交明细)</br>
 1.4.6、[获取交易品种的K线](#46获取交易品种的K线)</br>
 1.4.7、[获取交易品种的K线-历史](#47获取交易品种的K线历史)</br>
+1.4.8、[获取市场交易日历](#48获取市场交易日历)</br>
 ### 1.5、通过[Webscoket订阅或者请求实时数据接口](#5websocket协议接口定义)
 把key加入到**URL参数中**或者**请求头中**使用key字段填充，然后建立websocket连接，发送相应的订阅命令，并保持心跳就可以得到实时报价了</br>
 1.5.0、[websocket协议接入说明](#50websocket协议接入说明)</br>
@@ -1671,6 +1672,65 @@
 ```
 > [返回目录](#目录)
 ---
+### 4.8、获取市场交易日历
+- **接口地址**：`/market-calendar`
+- **请求方式**：`POST`
+- **接口描述**：获取指定一个或者多个市场的近三个月可交易日列表。
+> [返回目录](#目录)
+
+#### 4.8.1、请求参数(Body)
+| 参数名     | 类型   | 必填  | 描述                        |
+|------------|--------|------|-----------------------------|
+| `market`  | array   |是 |市场字符串数组 "US":美股 "HK":港股 "SH":A股沪市 "SZ":A股深市    |
+> [返回目录](#目录)
+#### 4.8.2、请求示例(Body)
+```json
+{
+    "market":["HK","US","SH", "SZ"]
+}
+```
+> [返回目录](#目录)
+#### 4.8.3、响应结果
+| 字段名称     | 类型   | 描述                                       |
+|----------|--------|--------------------------------------------|
+| `市场编码`   | array  | 市场对应的可交易日列表                   |
+| > `可交易日` | string | 格式：逗号前表示可交易日期，逗号后表示全天交易日(F)或者半天交易日(H)|
+
+> [返回目录](#目录)
+#### 4.8.4、响应示例
+```json
+{
+    "msg": "OK",
+    "data": {
+        "HK": [
+            "20250606,F",
+            "20250609,F",
+            "20250610,F",
+            "20250611,F"
+        ],
+        "SH": [
+            "20250605,F",
+            "20250606,F",
+            "20250609,F",
+            "20250610,F"
+        ],
+        "SZ": [
+            "20250610,F",
+            "20250611,F",
+            "20250612,F",
+            "20250613,F"
+        ],
+        "US": [
+            "20250701,F",
+            "20250702,F",
+            "20250703,H",
+            "20250707,F"
+        ]
+    }
+}
+```
+> [返回目录](#目录)
+---
 ## 5、websocket协议接口定义
 ### 5.0、websocket协议接入说明
 - **websocket地址：** `wss://api.qos.hk/ws`