跳转到内容

HTTP API

插件安装后自动拉起一个本地 HTTP 服务(server.js),供外部程序访问。控制台「API」Tab 有完整参数表与请求/响应示例。

API 文档页
API:每个操作的参数表、curl 请求与响应示例

服务

项 值
地址 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。

调用约定

Terminal window
# GET:参数放 query
curl -s "http://127.0.0.1:8099/api?op=quote&symbols=600519,000001"
# POST:op + args
curl -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"])