用途:Shioaji 是永豐金證券的跨语言交易 API,面向台湾证券、期货与期权市场(TWSE/TPEX/TAIFEX),支持 Python、CLI 与 HTTP API 三种存取层。
主要能力:Python 层为 PyO3 原生绑定,支持同步与异步;CLI 用于服务器管理、交易与数据查询;HTTP API + SSE 在 localhost:8080 提供 REST 端点与实时串流,可被 JS/TS、Go、C/C++、C#、Rust、Java/Kotlin 等任意 HTTP 客户端使用。功能涵盖下单/改单/取消、委托与成交回报、实时行情订阅、历史 tick 与 K 线、快照、账户余额与持仓盈亏、自选清单管理等。
使用方式:安装、首次开通、API 金钥、约定书签署、CA、登录与就绪检查请参考 PREPARE.md。下单前务必确认服务器模式,默认模拟环境;CLI 可用 shioaji server check 检查模式,GET /api/v1/info 返回 simulation 字段;切换正式环境用 shioaji server start --production 或 SJ_PRODUCTION=true,切回模拟用 shioaji server stop 后重新 start。注销用 api.logout()。
限制与注意:正式环境会用真实资金交易,须先确认模式。速率限制方面每日流量 500MB–10GB(依交易量)、行情查询 50 次/5 秒、账务查询 25 次/5 秒、每人 5 个连线、每日登录 1000 次。HTTP API 以 JSON 返回错误(code/message/details)。空清单与 PendingSubmit 并非最终成功或失败信号,需查对应功能参考再决定下一步。不要将 API Key、Secret Key、CA 密码或凭证内容贴入对话,应保存在本地。跨层时不要用 Python 包装属性推断 HTTP/SSE/CLI 字段。
上述均为资料所述内容,价格与实际开通细节暂未提供。