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.

close() → None[源代码]
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.

get_last_price(symbol_code: str, market: str) → float[源代码]
login(duration: int = 30) → str | None[源代码]

Authenticate afresh; insufficient evidence returns None, never old state.

Status=0 is a conservative local gate, not a verified broker protocol. Transport/decoding errors propagate after invalidating authentication.

query_asset_and_position()[源代码]
query_funds_flow(size, start_time, end_time)[源代码]
query_history_orders(size, start_time, end_time)[源代码]
query_history_trades(size, start_time, end_time)[源代码]
query_orders()[源代码]
query_trades()[源代码]
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_asset_and_position()[源代码]

Get asset and position.

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:

emtl.query_history_trades(size, start_time, end_time)[源代码]

查询历史成交.

参数:
  • size (int) – 请求的数据的条目数

  • start_time (str) – 起始时间, 格式”%Y-%m-%d”

  • end_time (str) – 起始时间, 格式”%Y-%m-%d”

Return dict:

emtl.query_orders()[源代码]

查询订单.

emtl.query_trades()[源代码]

查询成交.