Skip to main content

CLI stock strategy assistant

Project description

stock-up

CI PyPI version Python versions

命令行版个人股票策略执行助手。

安装

从 PyPI 安装:

python3 -m pip install stock-up

如果要使用 AkShare 备用数据源:

python3 -m pip install 'stock-up[akshare]'

验证安装:

stock-up --help

开发环境

git clone https://github.com/Guitenbay/stock-up.git
cd stock-up
python3 -m pip install -e '.[dev]'
pytest -q

如果开发时要使用 AkShare:

python3 -m pip install -e '.[dev,akshare]'

初始化

stock-up init

默认创建:

~/.stock-up/config.yaml
~/.stock-up/data.db
~/.stock-up/reports/

测试时可以指定目录:

stock-up init --home /tmp/stock-up-demo

观察池

手动加入观察:

stock-up watch add 300308 --name 中际旭创 --high 130 --low 110 --now 120

查看观察池:

stock-up watch list

检查观察信号:

stock-up watch check

查看废弃观察:

stock-up watch abandoned

修正高低点:

stock-up watch set 300308 --high 135 --low 112

持仓

添加持仓:

stock-up hold add 300308 --name 中际旭创 --cost 120 --qty 100 --rule wolf_swing

规则支持:

wolf_swing = 狼大波段规则
hai_long   = 海指导规则
both       = 两套规则同时开启

加仓:

stock-up hold add-buy 300308 --price 125 --qty 100

检查持仓:

stock-up hold check

关闭持仓:

stock-up hold close 300308 --price 135 --reason 止盈

关闭后重新加入观察:

stock-up hold close 300308 --price 135 --reason 止盈 --watch

盘中 tick

stock-up 不常驻。盘中由外部定时任务反复调用:

stock-up tick

默认使用腾讯实时行情。测试可用:

stock-up tick --provider mock

建议外部定时任务每 20 秒调用一次。

数据源

当前默认:

实时行情:腾讯 qt.gtimg.cn
自动加入观察:默认关闭
日 K / RSI:StockAPI,失败再尝试其他源

热点板块龙头自动加入观察目前默认关闭,因为 StockAPI 龙头接口需要 token:

auto_watch:
  hot_leader_scan_enabled: false

StockAPI 无 token 时会按 5 天窗口分段请求,以满足免费接口限制。

RSI 日 K 数据很宝贵,daily 更新 RSI 时遵循:

先更新持仓池
再更新观察池
达到 max_updates_per_daily 后停止

配置项:

technical:
  rsi:
    max_updates_per_daily: 50

涨停扫描

stock-up scan limit-up

默认使用 AkShare。测试可用:

stock-up scan limit-up --provider mock --date 2026-05-31

初始低点模式:

stock-up scan limit-up --low-mode same_day
stock-up scan limit-up --low-mode recent_1d

每日报告

stock-up daily

测试:

stock-up daily --provider mock --date 2026-05-31

报告输出到:

~/.stock-up/reports/YYYY-MM-DD.md

测试

pytest -q

免责声明

本工具仅用于个人复盘和策略辅助,不构成投资建议。

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stock_up-0.1.0.tar.gz (33.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

stock_up-0.1.0-py3-none-any.whl (31.4 kB view details)

Uploaded Python 3

File details

Details for the file stock_up-0.1.0.tar.gz.

File metadata

  • Download URL: stock_up-0.1.0.tar.gz
  • Upload date:
  • Size: 33.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.9

File hashes

Hashes for stock_up-0.1.0.tar.gz
Algorithm Hash digest
SHA256 319eb78733c6969967baed7e163d690732e04049c9f48f0b593b90a90080721d
MD5 92e8f077f32debe6ca83791e764b096f
BLAKE2b-256 e16d03247daa1485e23ceb2c14c3eab2d257930d7771acd2f5323ffa1d668f11

See more details on using hashes here.

File details

Details for the file stock_up-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: stock_up-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 31.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.9

File hashes

Hashes for stock_up-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c078efe1b041c91da7528d57841cbe419adc33942688acf6680caee3c2f85adb
MD5 ab369595b05ca9601cd5eabf58cf6f54
BLAKE2b-256 a611e24b1e8eba091a9ae4e6798e1976a0db81e3bc5aa9d6a22864ab200918e6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page