emtl¶
版本 0.3.0 的计划支持范围为 Linux / CPython 3.11。
公开函数签名、成功返回值及 CLI 参数与退出码遵循以下契约;
新增功能需补充契约测试,废弃接口需提供变更记录和迁移说明。
删除或不兼容修改必须另行批准并确定版本策略,P4 未授权删除既有接口。
当前导出的接口¶
emtl.__all__ 包含九个旧模块级函数和 TradingClient。
旧接口直接引用 emtl.core 的对应函数,保留共享会话与令牌的
历史行为;参见上述 P0 契约。
同步独立账户客户端 TradingClient 提供:
login(duration=30)、close()query_asset_and_position()、query_orders()、query_trades()query_history_orders(size, start_time, end_time)query_history_trades(size, start_time, end_time)query_funds_flow(size, start_time, end_time)get_last_price(symbol_code, market)create_order(stock_code, trade_type, market, price, amount)cancel_order(order_str)
TradeOutcomeUnknown 与 BrokerHTTPError 位于
emtl.errors,并未从包根目录通过 __all__ 导出。
它们适用于 P3 约定的显式客户端,不适用于旧模块级交易接口。
实际使用方式与交易风险说明参见 使用指南。
- class emtl.TradingClient(username: str, password: str | None = None, *, session_factory=None, ocr_factory=None)[源代码]¶
Own one account identity and one independent HTTP session.
- __init__(username: str, password: str | None = None, *, session_factory=None, ocr_factory=None)[源代码]¶
- cancel_order(order_str: str)[源代码]¶
Attempt one revocation; post-boundary failures raise TradeOutcomeUnknown.
Never automatically retry or interpret the returned text as execution.
- create_order(stock_code, trade_type, market: str, price: float, amount: int)[源代码]¶
Attempt one POST; ordinary post-boundary failures raise TradeOutcomeUnknown.
This is not acceptance/execution evidence or permission to resubmit. Authentication and other pre-boundary failures are not trade unknowns.
- emtl.cancel_order(order_str: str)[源代码]¶
取消交易接口.
- 参数:
order_str (str) – 订单字符串, 由成交日期+成交编号组成. 在create_order和query_order接口, Wtrq的值是成交日期, Wtbh的值是成交编号, 格式为: 20240520_130662
- emtl.create_order(stock_code, trade_type, market: str, price: float, amount: int)[源代码]¶
交易接口, 买入或卖出.
- 参数:
stock_code (str) – 股票代码
trade_type (str) – 交易方向,B for buy, S for sell
market (str) – 股票市场,HA 上海, SA
price (float) – 股票价格
amount (int) – 买入/卖出数量
- emtl.login(username: str = '', password: str = '', duration: int = 30) str | None[源代码]¶
登录接口.
- 参数:
username (str) – 用户名
password (str) – 密码(明文)
duration (int, optional) – 在线时长(分钟), defaults to 30
- 返回:
- emtl.query_funds_flow(size, start_time, end_time)[源代码]¶
查询资金.
- 参数:
size (int) – 请求的数据的条目数
start_time (str) – 起始时间, 格式”%Y-%m-%d”
end_time (str) – 起始时间, 格式”%Y-%m-%d”
- Return dict:
- emtl.query_history_orders(size, start_time, end_time)[源代码]¶
查询历史订单.
- 参数:
size (int) – 请求的数据的条目数
start_time (str) – 起始时间, 格式”%Y-%m-%d”
end_time (str) – 起始时间, 格式”%Y-%m-%d”
- Return dict: