HTTP API
插件安装后自动拉起一个本地 HTTP 服务(server.js),供外部程序访问。控制台「API」Tab 有完整参数表与请求/响应示例。
服务
| 项 | 值 |
|---|---|
| 地址 | http://127.0.0.1:8099 |
| 端口 | HITRADING_PORT(默认 8099) |
| 鉴权 | HITRADING_TOKEN(设置后请求需带 token) |
| 独立库 | HITRADING_DB(默认同 GUI 的 ~/.dsh/storages/hitrading.db) |
| 健康检查 | GET /health(返回 service / name / version / repo / docs / time) |
| 版本信息 | GET /api?op=version |
| 技能包 | GET /skill.md |
端口被占用时服务进程会干净退出,不影响 Harness。
调用约定
# GET:参数放 querycurl -s "http://127.0.0.1:8099/api?op=quote&symbols=600519,000001"
# POST:op + argscurl -s -X POST http://127.0.0.1:8099/api \ -H 'Content-Type: application/json' \ -d '{"op":"quote","args":{"symbols":["600519"]}}'响应统一为 {"ok":true,"value":...},失败为 {"ok":false,"error":"..."}。
操作一览
| op | 说明 | 主要参数 |
|---|---|---|
suggest |
证券模糊搜索 | q、count |
quote |
批量实时行情 | symbols |
kline |
历史 K线 | symbol、period、limit |
analysis |
技术面 + 估值 | symbol |
energy |
市场量能 | days(20/40/60) |
powerful |
强势股 | date(可选) |
limitup |
涨停板(按连板梯队分组) | date(可选) |
auction |
盘前竞价(异动/指数/涨跌家数/竞价量委比) | date(可选), force(可选) |
screen |
全市场选股 | sort、limit、peMin… |
watchlist.list |
自选列表(含行情/T-n) | — |
watchlist.add |
加自选 | symbols、tier、tags |
watchlist.remove |
删自选 | symbols |
watchlist.setTier |
改关注度 | symbols、tier |
watchlist.setTags |
设标签(全量替换) | symbols、tags |
portfolio.list |
模拟仓持仓(含现金账户、总资产、当日盈亏、累计盈亏) | — |
portfolio.buy / sell |
模拟买入 / 卖出(按现价,可指定价格) | symbol、shares、price(可选) |
portfolio.trades / reset |
成交流水 / 重置模拟仓 | count(可选) / keepPositions(可选) |
news |
快讯/公告/龙虎榜 | type、symbol、count |
weibo |
微博列表(含提取标记) | page、pageSize、userId、keyword、days |
weibo.extract |
启动提取股票后台任务 | batch(1~50,默认 20)、maxBatches |
weibo.task / weibo.cancel |
查询任务进度 / 停止任务 | — |
weibo.model.get / weibo.model.set |
查询 / 设置提取专用模型 | provider、model(空则恢复跟随默认) |
backtest |
策略回测 | symbol、strategy、limit… |
alerts.list / create / delete |
预警规则 | symbol、condition、value |
示例:读取量能并落盘
import requests
r = requests.get("http://127.0.0.1:8099/api", params={"op": "energy", "days": 20}).json()stats = r["value"]["stats"]print(stats["date"], stats["total"], stats["status"])