borsapy 是一个面向土耳其金融市场的 Python 数据库，它自带的borsapy CLI 命令行工具让你无需打开浏览器，就能在终端秒查 BIST 股价、财报、技术指标与买卖信号。本文是一份面向新手的完全手册：从安装到 25+ 个常用命令，帮你快速把「查行情 → 看财报 → 扫信号 → 导出数据」的整套工作流搬进终端。🚀

完整命令文档见 CLI.md，命令实现位于 borsapy/cli/commands/，入口程序为 borsapy/cli/app.py。

快速安装：一条命令上手 borsapy CLI

在已安装 Python 的环境中执行：

pip install borsapy

安装完成后，borsapy命令即可全局使用。输入borsapy --help查看全部命令，输入borsapy <命令> --help查看单个命令的参数。

提示：命令行适合「快速看一眼」的场景；批量回测、画图、组合优化等深度需求，可直接在 Python 中import borsapy使用同样的 API。

25+ 命令速查表：找到你需要的工具

秒查股价：price、quote、history、watch 四大件

日常用得最多的就是行情命令。一次可以传多个代码：

borsapy price THYAO GARAN ASELS # 股票快查 borsapy price USD EUR --type fx # 汇率 borsapy price BTCTRY --type crypto # 加密货币 borsapy quote THYAO # 详细报价（含市值、市盈率、股息率）

导出历史数据做自己的分析，只需重定向到文件：

borsapy history THYAO --period 1y --interval 1d -o csv > thyao.csv

常用参数：--period支持1d到max，--interval支持分钟级到月级；--actions可把分红拆股纳入价格调整。

实时盯盘则用watch，基于 TradingView WebSocket 推送：

borsapy watch THYAO GARAN --interval 0.5 # 每 0.5 秒刷新 borsapy watch THYAO --duration 60 # 只看 60 秒

按Ctrl+C即可停止。

信号与技术指标：signals、technical、scan 三件套

想知道「现在能不能买」，一条命令出信号（来自 TradingView Scanner API）：

borsapy signals THYAO # 默认周期 BUY/SELL/NEUTRAL borsapy signals THYAO --interval 1h borsapy signals THYAO --all --detail # 全周期 + 振荡器细节

technical可计算 11 种经典指标（rsi、macd、bollinger、supertrend等）：

borsapy technical THYAO -i rsi -i macd

最强大的是scan——用一行表达式扫描整个指数成分股，支持比较、逻辑与金叉死叉：

borsapy scan "rsi < 30" --index XU030 borsapy scan "rsi < 25 and volume > 5000000" # 超卖 + 放量 borsapy scan "sma_20 crosses_above sma_50" --index XU100 # 金叉

可用字段包括price、volume、market_cap、rsi_14、sma_50、macd、stoch_k等，详见 borsapy/cli/commands/scan.py。

财报与公告：financials 到 news 全覆盖

查一家公司的基本面，基本靠这几个命令：

borsapy financials THYAO --balance --quarterly # 近几期资产负债表 borsapy financials AKBNK --group UFRS # 银行报表格式 borsapy holders THYAO --etf # 谁在通过 ETF 持有它 borsapy targets THYAO --recommendations # 分析师目标价与评级 borsapy dividends THYAO # 历年分红 borsapy splits KAYSE # 送股/配股记录

news命令直接抓取 KAP（土耳其官方披露平台）公告，无需手动翻网页：

borsapy news THYAO

选股器 screen：基本面模板一把筛

不想写 Python 脚本也能做筛选，screen内置了常用模板：

borsapy screen --template high_dividend --index XU030 # 高股息 borsapy screen --template low_pe # 低市盈率 borsapy screen --sector Bankacılık --roe-min 15 # 银行股 + ROE>15% borsapy screen --rec AL --upside-min 30 # 分析师看多且空间>30%

也可用参数自由组合，如--pe-max 10 --div-min 3 --mcap-min 1000。对比多只股票用compare：

borsapy compare THYAO PGSUS TAVHL

找不到代码名？borsapy search banka可以按关键词模糊搜索。

外汇、债券与宏观：覆盖土耳其市场的方方面面

borsapy fx-rates USD # 各银行美元买卖价 borsapy fx-rates gram-altin # 克黄金价格 borsapy bonds 10Y # 10 年期国债利率 borsapy tcmb --history # 央行政策利率历史 borsapy economic --period today --country TR --importance high borsapy inflation --history -l 24 # 近 24 个月通胀

这些宏观数据与股票、基金命令组合使用，能搭出一套完整的每日盘前检查流程。

基金 fund 与期货 viop：TEFAS 数据一手掌握

fund命令对接 TEFAS 基金体系，可查净值、资产配置、风险指标，还能筛选与对比：

borsapy fund YAY --allocation # YAY 基金的持仓配置 borsapy fund --screen --type YAT --min-return-1y 50 # 筛一年收益>50%的基金 borsapy fund --compare YAY TTE AFO

期货方面，viop支持 BIST30、黄金等合约：

borsapy viop XU030D --detail borsapy viop --search gold

auth 登录：解锁实时数据

TradingView 数据默认约有 15 分钟延迟。登录后即可获取实时行情（watch、signals、scan效果最佳）：

borsapy auth login # 交互式登录，密码隐藏输入 borsapy auth status # 检查登录状态 borsapy auth logout # 退出

也支持用-u/-p直接传账号密码，或用浏览器 Cookie 方式登录（-s sessionid --session-sign 签名）。

小贴士：输出格式与每日工作流

所有命令都支持-o table/json/csv三种输出，方便接入jq或表格软件：

borsapy quote THYAO -o json | jq '.last' borsapy index XU100 --symbols -o json > xu100.json

一套推荐的每日分析流程：

# 1. 市场总览 + 今日重点经济事件 borsapy index XU030 borsapy economic --period today --country TR # 2. 盯住自选股 borsapy watch THYAO GARAN ASELS AKBNK # 3. 机会扫描 borsapy scan "rsi < 30" --index XU100 borsapy screen --template high_dividend --index XU030

常见问题快速排查

掌握以上 25+ 个命令，你就可以在终端里完成查股价、看财报、扫信号、导数据的全部日常操作。更多参数细节与示例，请直接阅读 CLI.md 获取完整说明。