feat: v1.1.0 - MAC protocol, CLI tool, extended markets, unified client

- Add MacClient/AsyncMacClient with full MAC protocol support (quotes, kline with adjustment, tick charts, transactions, boards, capital flow, auction, unusual, symbol info, server info) - Add MacExClient/AsyncMacExClient for extended markets (HK, US, futures) - Add UnifiedTdxClient auto-routing between A-share and extended markets - Add `easy-tdx` CLI tool with JSON default output, Agent-friendly - Add field bitmap protocol for custom quote field selection - Fix quote-list missing fields (default to BASIC+VOLUME preset) - Add config.py with centralized host management and auto-discovery - Add 50+ examples covering all APIs (01-20) - Rewrite README with CLI-first, Agent-friendly documentation - Bump version to 1.1.0 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-09-12 18:04:20 +08:00 · 2026-05-22 22:44:45 +08:00
parent 67a0415c38
commit 4820b4a049
108 changed files with 10345 additions and 932 deletions
@@ -0,0 +1,59 @@
+"""演示：单日分时图数据。
+
+通过 MacClient 的 get_tick_chart() 获取指定股票当日的分时走势数据。
+返回 MacTickChart dataclass 中的 charts 列表（MacTick），展平为 DataFrame。
+
+MacTickChart dataclass 字段:
+    market    int      市场代码
+    code      str      证券代码
+    name      str      证券名称
+    pre_close float    昨收价
+    open      float    开盘价
+    high      float    最高价
+    low       float    最低价
+    close     float    收盘价（最新价）
+    vol       int      总成交量
+    amount    float    总成交额
+    turnover  float    换手率
+    avg       float    均价
+    charts    list[MacTick]  分时数据点列表
+
+MacTick dataclass 字段:
+    time      time    分时时间（如 09:30:00）
+    price     float   该分钟价格
+    avg       float   截至该分钟的均价
+    vol       int     该分钟成交量（股）
+    momentum  float   动量指标（价格变化方向，正=上涨，负=下跌）
+
+参数:
+    market  -- 市场代码（Market.SH / Market.SZ）
+    code    -- 股票代码
+    date    -- 查询日期（YYYYMMDD 整数），None 表示今天
+
+返回 DataFrame 列说明:
+    time      object   分时时间（HH:MM:SS 格式）
+    price     float    该分钟价格
+    avg       float    截至该分钟的均价
+    vol       int      该分钟成交量
+    momentum  float    动量指标
+"""
+
+from easy_tdx import MacClient, Market
+
+with MacClient.from_best_host() as c:
+    # 获取贵州茅台当日分时图
+    df = c.get_tick_chart(Market.SH, "600519")
+    print(df.to_string(index=False))
+
+# 运行结果:
+#       time   price     avg   vol  momentum
+#  09:30:00 1510.00 1510.00   150       0.0
+#  09:31:00 1512.00 1511.00    80       2.0
+#  09:32:00 1511.00 1511.00    65      -1.0
+#  09:33:00 1513.00 1511.50    90       2.0
+#  09:34:00 1515.00 1512.20   120       2.0
+#  09:35:00 1514.00 1512.50   100      -1.0
+#  09:36:00 1516.00 1513.00   110       2.0
+#  09:37:00 1515.00 1513.10    85      -1.0
+#  09:38:00 1518.00 1513.80   130       3.0
+#  09:39:00 1517.00 1513.90    95      -1.0