Skip to main content

CLI stock strategy assistant

Project description

stock-up

CI PyPI version Python versions License: MIT

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

AI agent / 编程助手请先阅读 AGENTS.md,里面有安装、使用、开发和提交约定。

安装

从 PyPI 安装:

python3 -m pip install stock-up

验证安装:

stock-up --help

快速开始

普通使用只需要关注这几个命令:

1. 初始化

stock-up init

初始化本地配置、数据库和报告目录。

2. 添加持仓

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

常用规则:

wolf_swing = 狼大波段规则,偏趋势持股
hai_long   = 海指导规则,偏长线仓/时间验证
both       = 两套规则同时开启

3. 盘中检查

stock-up tick

更新观察池和持仓池的实时行情,并检查是否有需要动作的信号。

stock-up 不常驻,建议用系统定时任务在交易时间内每 20 秒调用一次。

4. 每日复盘

stock-up daily

建议每日 16:00 以后执行。默认使用 StockAPI,并自动扫描龙虎榜加入观察池,生成 Markdown 日报。

daily 依赖的数据源通常在每日 16:00 以后更新;太早执行可能拿不到当天最新数据。

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

5. 检查持仓

stock-up hold check

手动查看当前持仓是否触发止损、止盈、RSI 死叉或增持观察。

6. 卖出后关闭持仓

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

如果卖出后还想继续观察:

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

开发环境

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/config.yaml

stock-up init 会自动创建默认配置、数据库和报告目录。完整参数说明见 命令说明

更多文档

免责声明

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

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.2.3.tar.gz (43.6 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.2.3-py3-none-any.whl (34.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: stock_up-0.2.3.tar.gz
  • Upload date:
  • Size: 43.6 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.2.3.tar.gz
Algorithm Hash digest
SHA256 64e8c1f8cd488200274b9e99d298081e4e0725ef3a6234998f9f8cf2b6cb04e8
MD5 4fb7964bf49729688b44b9c419aa5f56
BLAKE2b-256 e04fa62850e1462910b13e34ba6a6c61f40d0569f162d1c0a286981d08109bcc

See more details on using hashes here.

File details

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

File metadata

  • Download URL: stock_up-0.2.3-py3-none-any.whl
  • Upload date:
  • Size: 34.7 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.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 0300cb2cc89988a1732b80c5e5631d69bed5245826b900e0e74797af0d1121a4
MD5 34c3844ad445cc3005e5ce04b1b94fb3
BLAKE2b-256 b9a31dc36e2966bc18b20fd3074cdceb546bd7e76518d29bae51d38be1c1f890

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