From f7cb015ec6e69cd439d67a555a034d6074f80eca Mon Sep 17 00:00:00 2001
From: Justin Gu <97915@qq.com>
Date: Sat, 4 Jul 2026 03:19:11 +0800
Subject: [PATCH] =?UTF-8?q?docs(README):=20=E8=A1=A5=E5=85=85=E6=B8=AF?=
 =?UTF-8?q?=E8=82=A1=20goods=5Ftransaction=5Fall=20+=20=E9=80=90=E7=AC=94?=
 =?UTF-8?q?=E5=80=92=E5=BA=8F=E8=AF=AD=E4=B9=89=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

在 Python API「扩展市场」章节加 goods_transaction_all 示例（港股当日全部逐笔），
并补 start 倒序语义说明（start=0 为最新/收盘方向，count=2000 默认只取最近 2000
笔会集中在尾盘，需全天用 goods_transaction_all）。同步 GitHub Wiki。
---
 README.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/README.md b/README.md
index ed6ce54..2955dd7 100644
--- a/README.md
+++ b/README.md
@@ -1368,6 +1368,8 @@ with MacClient.from_best_host() as c:
 ### 扩展市场
 
 ```python
+from datetime import date
+
 from easy_tdx import MacExClient, ExMarket, Period
 
 with MacExClient.from_best_host() as c:
@@ -1377,8 +1379,11 @@ with MacExClient.from_best_host() as c:
     df = c.goods_quotes([(ExMarket.HK_MAIN_BOARD, "00700")])
     df = c.goods_tick_chart(ExMarket.HK_MAIN_BOARD, "00700")
     df = c.goods_transaction(ExMarket.HK_MAIN_BOARD, "00700", count=100)
+    df = c.goods_transaction_all(ExMarket.HK_MAIN_BOARD, "00700", date(2026, 7, 3))  # 港股当日全部逐笔
 ```
 
+> **逐笔成交排序**：通达信协议为**倒序**——`start=0` 指向最新一笔（收盘方向），`count=2000` 默认只取最近 2000 笔。港股单日成交常达数万笔（如 02715 约 1.3 万笔/日），若需当日全部成交，用 `goods_transaction_all`（仅港股股票类市场，自动按 1800/页翻页取全天，安全上限 9 万条；返回协议原生倒序，需正序展示自行 `df.iloc[::-1]`）。
+
 ### 统一客户端
 
 ```python