mirror of
https://ghfast.top/https://github.com/aeroxw/easy-tdx.git
synced 2026-09-12 20:24:16 +08:00
GitHubandClaude Opus 4.7
4820b4a049
- 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>
316 lines
15 KiB
Bash
316 lines
15 KiB
Bash
#!/bin/bash
|
||
# easy-tdx CLI 使用示例大全
|
||
# 所有命令均不实际执行，仅供展示用法和注释输出。
|
||
#
|
||
# 通用参数说明:
|
||
# --table 以表格形式输出（默认 JSON）
|
||
# --output PATH 将结果写入文件（支持 .csv / .xlsx / .json）
|
||
# --count N 返回条数（默认因命令而异）
|
||
# --period ENUM K 线周期: DAILY / WEEKLY / MONTHLY / MIN_5 / MIN_15 / MIN_30 / MIN_60 / MIN_1
|
||
# --adjust ENUM 复权方式: NONE(不复权) / QFQ(前复权) / HFQ(后复权)
|
||
# --sort SORT 排序字段（如 CHANGE_PCT, VOLUME 等）
|
||
# --order ORDER 排序方向: DESC(降序) / ASC(升序)
|
||
# --market MKT 市场代码: SH(上证) / SZ(深证) / BJ(北证)
|
||
#
|
||
# 市场代码说明:
|
||
# SH -- 上海证券交易所（Market.SH = 1）
|
||
# SZ -- 深圳证券交易所（Market.SZ = 0）
|
||
# BJ -- 北京证券交易所（Market.BJ = 12）
|
||
#
|
||
# 扩展市场代码说明（ex 子命令使用）:
|
||
# HK_MAIN_BOARD -- 香港主板 (31) US_STOCK -- 美国股票 (74)
|
||
# CFFEX_FUTURES -- 中金所期货 (47) ZZ_FUTURES -- 郑州商品 (28)
|
||
# DL_FUTURES -- 大连商品 (29) SH_FUTURES -- 上海期货 (30)
|
||
# HK_GEM -- 香港创业板 (48)
|
||
|
||
echo "=== 1. 服务器测速 ==="
|
||
# 测试所有已知行情服务器的延迟。
|
||
# --timeout 5: 设置测速超时（秒）
|
||
# --table: 以表格形式输出（默认 JSON）
|
||
# easy-tdx ping [--timeout 5] [--table]
|
||
# 输出:
|
||
# [
|
||
# {"group": "standard", "host": "119.147.212.81", "latency_ms": 12.3},
|
||
# {"group": "standard", "host": "112.74.214.43", "latency_ms": 18.7},
|
||
# {"group": "standard", "host": "221.231.141.60", "latency_ms": 25.1},
|
||
# {"group": "mac", "host": "112.74.214.43", "latency_ms": 19.5},
|
||
# {"group": "mac", "host": "119.147.212.81", "latency_ms": 13.8}
|
||
# ]
|
||
|
||
echo "=== 2. 查看版本 ==="
|
||
# easy-tdx version
|
||
# 输出:
|
||
# easy-tdx 1.0.0
|
||
|
||
echo "=== 3. 获取K线（平安银行）==="
|
||
# 获取 K 线数据。SZ 表示深证，000001 为平安银行。
|
||
# 参数: <市场> <代码> --count N --period <周期> --adjust <复权>
|
||
# easy-tdx kline SZ 000001 --count 5 --table
|
||
# 输出:
|
||
# datetime open high low close volume amount
|
||
# 2025-05-15 00:00 12.35 12.50 12.30 12.45 45678900 567890000
|
||
# 2025-05-16 00:00 12.45 12.58 12.40 12.52 38901200 487650000
|
||
# 2025-05-19 00:00 12.50 12.65 12.48 12.60 42345600 534567000
|
||
# 2025-05-20 00:00 12.60 12.68 12.52 12.55 35678900 448760000
|
||
# 2025-05-21 00:00 12.55 12.70 12.50 12.68 40123400 508765000
|
||
|
||
echo "=== 4. 获取K线（贵州茅台，前复权）==="
|
||
# easy-tdx kline SH 600519 --adjust QFQ --period DAILY --table
|
||
# 输出:
|
||
# datetime open high low close volume amount
|
||
# 2025-05-15 00:00 1535.00 1548.00 1528.00 1542.00 345678 532456000000
|
||
# 2025-05-16 00:00 1542.00 1556.00 1535.00 1548.50 312345 483456000000
|
||
# 2025-05-19 00:00 1548.00 1560.00 1540.00 1555.00 378901 588765000000
|
||
# 2025-05-20 00:00 1555.00 1562.00 1545.00 1548.00 298765 462345000000
|
||
# 2025-05-21 00:00 1548.00 1558.00 1542.00 1552.50 323456 501234000000
|
||
|
||
echo "=== 5. 获取实时报价（多只）==="
|
||
# 批量获取实时报价。多只股票用逗号分隔，格式为 "市场 代码"。
|
||
# 参数: "市场 代码,市场 代码,..." --table
|
||
# 最多 80 只/次。
|
||
# 返回列: market, code, name, price, last_close, open, high, low, change, change_pct, volume, amount
|
||
# easy-tdx quote "SZ 000001,SH 600519" --table
|
||
# 输出:
|
||
# market code name pre_close open high low price vol amount ...
|
||
# 0 000001 平安银行 12.55 12.58 12.72 12.55 12.68 38901200 492345000 ...
|
||
# 1 600519 贵州茅台 1548.00 1552.00 1560.00 1545.00 1555.00 298765 464567000000 ...
|
||
|
||
echo "=== 6. 获取市场分类报价列表 ==="
|
||
# 获取市场分类排序报价。A=全部A股, SH=上证A, SZ=深证A, KCB=科创板, CYB=创业板。
|
||
# 参数: <分类> --count N --sort <排序字段>（0,1） --order <排序方向>（0,1,2）
|
||
# 返回列: market, code, name, price, change_pct, volume, amount, ...
|
||
# easy-tdx quote-list A --count 10 --table
|
||
# 输出:
|
||
# market code name price change_pct vol amount ...
|
||
# 0 300XXX 某某科技 25.80 +20.00 123456 318765000 ...
|
||
# 0 301XXX 某某电子 18.50 +15.32 98765 182765000 ...
|
||
# 1 688XXX 某某芯片 42.30 +12.56 67890 287456000 ...
|
||
# 0 002XXX 某某新材 33.60 +10.04 156789 527234000 ...
|
||
# 0 300XXX 某某医药 56.20 +8.75 45678 256789000 ...
|
||
# ...（共10条）
|
||
|
||
echo "=== 7. 获取分时图 ==="
|
||
# 获取当日分时走势。返回约 330 条分钟级数据。
|
||
# 返回列: datetime, price, avg_price, volume
|
||
# bs_flag: 0=买/1=卖/2=中性/5=盘后
|
||
# easy-tdx tick SZ 000001 --table
|
||
# 输出:
|
||
# datetime price avg_price volume
|
||
# 09:30:00 00:00 12.58 12.58 0
|
||
# 09:31:00 00:00 12.60 12.59 5600
|
||
# 09:32:00 00:00 12.62 12.60 3400
|
||
# 09:33:00 00:00 12.58 12.60 2800
|
||
# 09:34:00 00:00 12.55 12.59 4100
|
||
# ...（共约330条）
|
||
|
||
echo "=== 8. 获取多日分时图 ==="
|
||
# 获取多日分时走势。--days N 指定天数（最多 5 天）。
|
||
# 返回列: datetime, price, avg_price, volume（含日期标识每天数据）
|
||
# easy-tdx tick SH 600519 --days 5 --table
|
||
# 输出:
|
||
# datetime price avg_price volume
|
||
# 2025-05-15 09:30 1542.00 1542.00 0
|
||
# 2025-05-15 09:31 1543.50 1542.75 120
|
||
# 2025-05-15 09:32 1545.00 1543.50 85
|
||
# ...
|
||
# 2025-05-21 09:30 1548.00 1548.00 0
|
||
# 2025-05-21 09:31 1550.00 1549.00 95
|
||
# ...（共约1650条，5天）
|
||
|
||
echo "=== 9. 获取逐笔成交 ==="
|
||
# 获取逐笔成交明细。--count N 指定返回条数。
|
||
# 返回列: datetime, price, volume, num, bs (B=买/S=卖)
|
||
# bs_flag 值: 0=买入, 1=卖出, 2=中性, 5=盘后
|
||
# easy-tdx transaction SZ 000001 --count 20 --table
|
||
# 输出:
|
||
# datetime price volume num bs
|
||
# 09:30:05 00:00 12.58 100 1 B
|
||
# 09:30:05 00:00 12.58 200 1 B
|
||
# 09:30:06 00:00 12.59 300 1 B
|
||
# 09:30:06 00:00 12.57 500 1 S
|
||
# 09:30:07 00:00 12.58 100 1 B
|
||
# ...（共20条）
|
||
|
||
echo "=== 10. 获取集合竞价 ==="
|
||
# easy-tdx auction SH 600519 --table
|
||
# 输出:
|
||
# datetime price volume amount
|
||
# 09:15:01 00:00 1545.00 1234 1906530
|
||
# 09:15:06 00:00 1548.00 2345 3630060
|
||
# 09:15:11 00:00 1550.00 3456 5356800
|
||
# 09:15:16 00:00 1548.50 2567 3976479
|
||
# 09:15:21 00:00 1549.00 1890 2927610
|
||
# 09:25:00 00:00 1550.00 5678 8800900
|
||
|
||
echo "=== 11. 获取板块列表 ==="
|
||
# 获取板块列表。--type 指定板块类型: HY(行业), GN(概念), FG(风格), DQ(地区), ALL(全部)。
|
||
# 返回列: code, name, price, rise_speed, pre_close, symbol_code, symbol_name, ...
|
||
# easy-tdx board-list --type GN --count 10 --table
|
||
# 输出:
|
||
# code name change_pct stock_count
|
||
# 881XXX 人工智能 +3.25 128
|
||
# 881XXX 芯片概念 +2.87 96
|
||
# 881XXX 新能源车 +2.45 152
|
||
# 881XXX 锂电池 +2.12 110
|
||
# 881XXX 光伏概念 +1.98 87
|
||
# 881XXX 军工电子 +1.76 73
|
||
# 881XXX 医药电商 +1.54 45
|
||
# 881XXX 白酒概念 +1.32 32
|
||
# 881XXX 数字经济 +1.15 68
|
||
# 881XXX 机器人 +0.98 54
|
||
|
||
echo "=== 12. 获取板块成分股 ==="
|
||
# 获取板块成分股报价。参数为板块代码（如 881001）。
|
||
# --sort CHANGE_PCT --order DESC 按涨幅降序。
|
||
# 返回列: market, code, name, price, change_pct, volume, amount
|
||
# easy-tdx board-members 881001 --count 10 --table
|
||
# 输出:
|
||
# market code name price change_pct vol amount
|
||
# 0 300XXX 某某科技 25.80 +10.02 45678 117890000
|
||
# 1 688XXX 某某芯片 42.30 +8.56 23456 99234000
|
||
# 0 002XXX 某某软件 18.90 +6.78 67890 128345000
|
||
# 0 000XXX 某某信息 33.50 +5.43 12345 41356000
|
||
# 0 300XXX 某某电子 56.20 +4.32 34567 194345000
|
||
# ...（共10条）
|
||
|
||
echo "=== 13. 查询个股所属板块 ==="
|
||
# 查询指定股票所属的所有板块（行业、概念、风格等）。
|
||
# 返回列: board_type(0=行业/3=概念/4=风格), board_code, board_name, close, pre_close
|
||
# easy-tdx belong-board SZ 000001 --table
|
||
# 输出:
|
||
# code name type
|
||
# 881XXX 银行 HY
|
||
# 881XXX 深证成指 GN
|
||
# 881XXX 融资融券 GN
|
||
# 881XXX 沪深300 GN
|
||
# 881XXX MSCI概念 GN
|
||
# 881XXX 标普道琼斯 GN
|
||
|
||
echo "=== 14. 获取个股资金流向 ==="
|
||
# 获取个股多日资金流向。包含主力/大单/中单/小单的流入流出净额。
|
||
# 返回列: datetime, main_net, main_pct, huge_net, large_net, medium_net, small_net
|
||
# easy-tdx capital-flow SH 600519 --table
|
||
# 输出:
|
||
# datetime main_net main_pct huge_net large_net medium_net small_net
|
||
# 2025-05-21 15:00 12345.6 1.25 23456.7 -11111.1 -5678.9 -6666.7
|
||
# 2025-05-20 15:00 -8765.4 -0.89 12345.6 -21111.0 4321.0 4444.4
|
||
# 2025-05-19 15:00 5432.1 0.55 6789.0 -1356.9 -1234.5 -4197.6
|
||
|
||
echo "=== 15. 获取市场异动 ==="
|
||
# 获取全市场异动数据。包含快速拉升、大幅下跌、大笔成交等异动类型。
|
||
# 返回列: datetime, market, code, name, alert_type, price, change_pct
|
||
# easy-tdx unusual SZ --count 20 --table
|
||
# 输出:
|
||
# datetime market code name alert_type price change_pct
|
||
# 09:45:32 00:00 0 300XXX 某某科技 快速拉升 25.80 +8.56
|
||
# 09:52:18 00:00 0 002XXX 某某新材 大笔买入 33.60 +5.32
|
||
# 10:05:44 00:00 0 000XXX 某某医药 封涨停板 18.90 +10.00
|
||
# 10:12:07 00:00 0 300XXX 某某电子 快速下跌 12.45 -7.21
|
||
# 10:23:55 00:00 0 002XXX 某某食品 大笔卖出 45.60 -3.45
|
||
# ...（共20条）
|
||
|
||
echo "=== 16. 获取全市场涨跌统计 ==="
|
||
# easy-tdx market-stat --table
|
||
# 输出:
|
||
#+------------+--------------+-----------------+-------------------+---------------+----------------+----------------+--------------------+------------------+--------------------+
|
||
#| up_count | down_count | neutral_count | suspended_count | total_count | total_amount | total_volume | total_market_cap | limit_up_count | limit_down_count |
|
||
#+============+==============+=================+===================+===============+================+================+====================+==================+====================+
|
||
#| 3869 | 1509 | 126 | 18 | 5522 | 2.92468e+12 | 1.35881e+09 | 1.1915e+14 | 136 | 18 |
|
||
#+------------+--------------+-----------------+-------------------+---------------+----------------+----------------+--------------------+------------------+--------------------+
|
||
|
||
echo "=== 17. 获取服务器交易时段信息 ==="
|
||
# easy-tdx server-info --table
|
||
# 输出:
|
||
# name start end status
|
||
# 早盘集合竞价 09:15 09:25 closed
|
||
# 早盘连续竞价 09:30 11:30 open
|
||
# 午盘连续竞价 13:00 15:00 open
|
||
# 盘后固定价格 15:05 15:30 closed
|
||
|
||
echo "=== 18. 获取个股简要特征快照 ==="
|
||
# 获取个股简要特征快照。包含活跃度、内外盘、换手率、均价等。
|
||
# MacSymbolInfo 字段: market, code, name, time, activity, pre_close, open, high, low,
|
||
# close, momentum, vol, amount, inside_volume, outside_volume, turnover, avg
|
||
# easy-tdx symbol-info SZ 000001 --table
|
||
# 输出:
|
||
# field value
|
||
# 代码 000001
|
||
# 名称 平安银行
|
||
# 市场 SZ
|
||
# 总股本(万) 1940521.84
|
||
# 流通股(万) 1940521.84
|
||
# 总市值(亿) 24509.37
|
||
# 流通市值(亿) 24509.37
|
||
|
||
echo "=== 19. 列出扩展市场代码 ==="
|
||
# 列出所有可用的 ExMarket 枚举值和名称。
|
||
# 常用: HK_MAIN_BOARD=31, US_STOCK=74, CFFEX_FUTURES=47, ZZ_FUTURES=28, DL_FUTURES=29
|
||
# easy-tdx ex markets
|
||
# 输出:
|
||
# [
|
||
# {"code": 1, "name": "TEMP_STOCK"},
|
||
# {"code": 28, "name": "ZZ_FUTURES"},
|
||
# {"code": 29, "name": "DL_FUTURES"},
|
||
# {"code": 30, "name": "SH_FUTURES"},
|
||
# {"code": 31, "name": "HK_MAIN_BOARD"},
|
||
# {"code": 47, "name": "CFFEX_FUTURES"},
|
||
# {"code": 48, "name": "HK_GEM"},
|
||
# {"code": 74, "name": "US_STOCK"},
|
||
# ...
|
||
# ]
|
||
|
||
echo "=== 20. 获取扩展市场K线（港股腾讯）==="
|
||
# 获取扩展市场 K 线。参数: <ExMarket名称> <代码> --count N --period <周期>
|
||
# 返回列: datetime, open, high, low, close, volume, amount
|
||
# easy-tdx ex kline HK_MAIN_BOARD 00700 --count 10 --table
|
||
# 输出:
|
||
# datetime open high low close volume amount
|
||
# 2025-05-12 00:00 520.0 528.0 518.5 525.0 16543000 8676540000
|
||
# 2025-05-13 00:00 525.0 530.0 522.0 523.5 14321000 7498760000
|
||
# 2025-05-14 00:00 523.5 527.0 520.0 525.5 13456000 7076540000
|
||
# 2025-05-15 00:00 525.0 530.0 522.5 528.0 15234000 8011230000
|
||
# 2025-05-16 00:00 528.0 532.0 525.5 530.5 12345000 6543210000
|
||
# 2025-05-19 00:00 531.0 535.0 529.0 533.0 14567000 7765430000
|
||
# 2025-05-20 00:00 533.0 536.0 530.0 531.5 11234000 5987650000
|
||
# 2025-05-21 00:00 532.0 537.0 530.5 535.0 13456000 7187650000
|
||
# ...（共10条）
|
||
|
||
echo "=== 21. 获取扩展市场报价（美股苹果）==="
|
||
# 获取单只扩展市场股票报价。参数: <ExMarket名称> <代码>
|
||
# 返回列: market, code, name, pre_close, open, high, low, price, volume, amount
|
||
# easy-tdx ex quote US_STOCK AAPL --table
|
||
# 输出:
|
||
# market code name pre_close open high low price volume amount
|
||
# 74 AAPL APPLE 213.75 214.00 218.00 213.50 217.50 49876000 10789650000
|
||
|
||
echo "=== 22. 获取扩展市场商品列表（港股主板）==="
|
||
# 获取扩展市场商品列表。参数: <ExMarket名称> --count N
|
||
# 返回列: code(证券代码), name(证券名称), market(市场代码)
|
||
# easy-tdx ex quote-list HK_MAIN_BOARD --count 10 --table
|
||
# 输出:
|
||
# code name market
|
||
# 00001 长和 31
|
||
# 00002 中电控股 31
|
||
# 00003 香港中华煤气 31
|
||
# 00004 九龙仓集团 31
|
||
# 00005 汇丰控股 31
|
||
# 00006 电能实业 31
|
||
# 00007 高鑫零售 31
|
||
# 00008 新鸿基地产 31
|
||
# 00009 载通 31
|
||
# 00010 恒隆地产 31
|
||
|
||
echo "=== 23. 获取扩展市场分时图（港股腾讯）==="
|
||
# 获取扩展市场当日分时走势。参数: <ExMarket名称> <代码>
|
||
# 返回列: datetime, price, avg_price, volume
|
||
# easy-tdx ex tick HK_MAIN_BOARD 00700 --table
|
||
# 输出:
|
||
# datetime price avg_price volume
|
||
# 09:30:00 00:00 532.00 532.00 0
|
||
# 09:31:00 00:00 532.50 532.25 5600
|
||
# 09:32:00 00:00 533.00 532.50 3400
|
||
# 09:33:00 00:00 533.50 532.75 2800
|
||
# 09:34:00 00:00 532.80 532.56 4100
|
||
# 09:35:00 00:00 533.20 532.84 3500
|
||
# ...（共约330条）
|