自动获取 Interactive Brokers (IBKR) 交易数据并生成中国税务申报报表的工具。
- ✅ 自动从 IBKR 获取交易记录
- ✅ 解析交易、股息、预扣税数据
- ✅ 自动获取实时汇率或使用固定汇率
- ✅ 生成 Excel 报表和 JSON 数据
- ✅ 自动计算应纳税额和可抵免税额
- ✅ 支持多账户合并
- ✅ 投资表现分析：计算总收益率、年化收益率、最大回撤、已实现 ROI
- ✅ 仓位查询：实时获取账户持仓信息（股票代码、数量、市值、成本）
- ✅ 行情查询：获取股票实时价格
- ✅ 订单管理：查看所有活跃订单状态
- ✅ 追踪止损：下追踪止损单保护利润
- 支持卖单（SELL）：跟随股价上涨自动上移止损价
- 支持买单（BUY）：逢低买入策略
- ✅ 批量操作：为所有持仓批量下单或取消订单
- ✅ 订单取消：取消指定订单或批量取消
注意：交易功能使用 IBKR Web API，需要运行 Client Portal Gateway
- ✅ 账户查询：获取账户列表和详细信息
- ✅ 持仓查询：查看账户持仓和市值
- ✅ 账户摘要：查询余额、购买力、保证金等
- ✅ 订单查询：查看活跃订单状态
- ✅ 合约搜索：搜索股票合约信息
- ✅ 行情快照：获取实时市场数据
注意：Web API 功能需要运行 Client Portal Gateway
# 克隆或下载项目
cd ibkr-toolkit
# 使用 uv 安装（推荐）
uv pip install -e .
# 或使用传统 pip
pip install -e .复制配置文件模板：
cp .env.example .env编辑 .env 文件，填入你的 IBKR 凭证：
IBKR_FLEX_TOKEN=你的token
IBKR_QUERY_ID=你的query_id
USD_CNY_RATE=7.2
USE_DYNAMIC_EXCHANGE_RATES=true
OUTPUT_DIR=./data/output配置参数说明：
税务报表功能（必填）：
IBKR_FLEX_TOKEN: IBKR Flex Query Token（必填）IBKR_QUERY_ID: Flex Query ID（必填）
税务报表功能（可选）：
USD_CNY_RATE: 固定汇率，作为 API 失败时的备用汇率（默认 7.2）USE_DYNAMIC_EXCHANGE_RATES: 是否使用动态汇率（默认 true）OUTPUT_DIR: 输出目录（默认 ./data/output）FIRST_TRADE_YEAR: 首次交易年份（可选，用于--all参数）
Web API 功能（可选）：
IBKR_WEB_API_URL: Client Portal Gateway URL（默认 https://localhost:5001/v1/api）IBKR_WEB_API_VERIFY_SSL: 是否验证 SSL 证书（默认 false）IBKR_WEB_API_TIMEOUT: 请求超时时间（默认 30 秒）IBKR_WEB_API_MAX_REQUESTS_PER_SECOND: 速率限制（默认 50 次/秒）
# 使用默认日期范围（Flex Query 中配置的日期）
uv run ibkr-toolkit report
# 指定单个税务年度（推荐，适用于中国税务申报）
uv run ibkr-toolkit report --year 2025
# 获取当前年度数据
uv run ibkr-toolkit report --year $(date +%Y)
# 查询从指定年份到当前的所有数据（自动分年查询）
uv run ibkr-toolkit report --from-year 2020
# 查询从开始交易到现在的所有数据（需配置 FIRST_TRADE_YEAR）
uv run ibkr-toolkit report --all
# 查看所有可用选项
uv run ibkr-toolkit --help前置条件：需要先启动 Client Portal Gateway 并登录（方法见下方 Web API 功能部分）。
# 查看所有持仓（自动显示所有账户）
uv run ibkr-toolkit stop-loss place U12345678 --percent 5.0
# 为指定账户的所有持仓下追踪止损单（5% 止损）
uv run ibkr-toolkit stop-loss place U12345678 --percent 5.0
# 为特定股票下追踪止损单
uv run ibkr-toolkit stop-loss place U12345678 --percent 5.0 --symbols AAPL TSLA
# 下追踪止损买单（逢低买入策略）
uv run ibkr-toolkit stop-loss place-buy U12345678 --percent 5.0 --symbols AAPL TSLA
# 查看所有活跃订单
uv run ibkr-toolkit stop-loss orders
# 查看指定账户的订单
uv run ibkr-toolkit stop-loss orders --account U12345678
# 取消指定订单
uv run ibkr-toolkit stop-loss cancel 15 12
# 取消账户的所有追踪止损单
uv run ibkr-toolkit stop-loss cancel --account U12345678
# 取消指定股票的订单
uv run ibkr-toolkit stop-loss cancel --account U12345678 --symbols AAPL TSLA前置条件：需要先启动 Client Portal Gateway 并登录。
启动 Gateway：
cd clientportal.gw
bin/run.sh root/conf.yaml
# 然后在浏览器访问 https://localhost:5001 登录命令示例：
# 查看账户信息
uv run ibkr-toolkit web account-info
# 查看账户持仓
uv run ibkr-toolkit web positions U12345678
# 查看账户摘要（余额、购买力等）
uv run ibkr-toolkit web summary U12345678
# 查看活跃订单
uv run ibkr-toolkit web orders U12345678
# 搜索股票合约
uv run ibkr-toolkit web search AAPL
# 获取市场数据快照（需要先通过 search 获取 contract ID）
uv run ibkr-toolkit web snapshot 265598,76792991
# 以 JSON 格式输出
uv run ibkr-toolkit web positions U12345678 --format json前置条件：需要先启动 Client Portal Gateway 并登录（同 Web API 功能）。
命令示例：
# 查看单个账户的月度表现（默认）
uv run ibkr-toolkit performance U12345678
# 查看多个账户的表现
uv run ibkr-toolkit performance U12345678 U87654321
# 指定不同的时间周期
uv run ibkr-toolkit performance U12345678 --period 1D # 1天
uv run ibkr-toolkit performance U12345678 --period 7D # 7天
uv run ibkr-toolkit performance U12345678 --period MTD # 月初至今
uv run ibkr-toolkit performance U12345678 --period 1M # 1个月（默认）
uv run ibkr-toolkit performance U12345678 --period YTD # 年初至今
uv run ibkr-toolkit performance U12345678 --period 1Y # 1年
# 以 JSON 格式输出
uv run ibkr-toolkit performance U12345678 --format json重要提示：
- 速率限制：此 API 端点每 15 分钟只能请求 1 次
- 数据范围：默认最多查询 365 天的历史数据
- 返回的数据包括：总回报、已实现/未实现盈亏、净值变化等指标
日期参数说明：
--year/-y：指定单个税务年度，查询该年 1月1日 至 12月31日 的数据--from-year：指定起始年份，自动分年查询从该年到当前年份的所有数据--all：查询从FIRST_TRADE_YEAR（.env 配置）到当前年份的所有数据- 不指定任何参数：使用 Flex Query 中预设的日期范围
- 这些参数互斥，只能使用其中一个
多年查询特性：
- 使用
--from-year或--all时，工具会自动按年分段查询 - 每年查询一次（1/1 - 12/31），自动合并所有数据
- 某一年查询失败不会中断，会继续查询其他年份
- 避免 IBKR API 365 天的单次查询限制
要使用此工具，你需要在 IBKR 客户端门户创建一个 Flex Query。
访问 IBKR Client Portal 并登录。
- 进入 Reports → Flex Queries
- 点击 Create 创建新查询
- 选择 Activity Flex Query
确保包含以下数据类型：
-
Trades (交易记录)
- 包含字段：Symbol, Date/Time, Quantity, Price, Proceeds, Commission, Realized P/L, Currency
-
Cash Transactions (现金交易)
- 包含字段：Symbol, Date/Time, Amount, Type, Currency
- 用于获取股息数据
-
Withholding Tax (预扣税)
- 包含字段：Date, Amount, Currency
- 用于计算外国税额抵免
如需使用投资表现分析功能，需要额外添加以下数据类型：
-
Open Positions (持仓数据)
- 包含字段：Symbol, Quantity, Mark Price, Position Value, Cost Basis, FX P&L, Currency, Asset Category
- 用于计算期末净值、未实现盈亏等
-
Cash Report (现金报告)
- 选择 Base Currency Summary
- 包含字段：Starting Cash, Ending Cash, Deposits, Withdrawals, Deposit/Withdrawals
- 用于计算期初期末净值、净存入额等
根据你需要分析的时间段设置：
- From: 开始日期（如 2025-01-01）
- To: 结束日期（如 2025-12-31）
注意：工具支持通过命令行参数 --year 覆盖这里设置的日期范围。建议在 Flex Query 中设置一个较长的默认日期范围（如最近一年），然后在命令行中根据需要指定具体年份。
- Format: XML
- Include Header/Trailer: Yes
- Include Audit Trail: No（可选）
- 保存查询后，系统会分配一个 Query ID
- 在 Flex Query 页面点击 Generate Token 生成 Token
- 将
Query ID和Token填入.env文件
运行工具验证配置是否正确：
uv run ibkr-toolkit report如果配置正确，工具将自动获取数据并生成报表。
本工具支持两种汇率计算模式：动态汇率和固定汇率。
配置方式：
USE_DYNAMIC_EXCHANGE_RATES=true工作原理：
- 为每笔交易获取当日的实际汇率（不是月平均汇率）
- 优先从本地缓存读取（
data/cache/exchange_rates_cache.json） - 缓存未命中时，按以下顺序调用 API：
- exchangerate-api.com（1500次/月免费额度）
- Frankfurter API（无限制，但数据仅到前一天）
- API 失败时使用
USD_CNY_RATE作为备用汇率 - 成功获取的汇率会自动缓存供后续使用
优势：
- 精确的税务计算，每笔交易使用当日汇率
- 符合税务申报要求
- 缓存机制提高性能，减少 API 调用
示例：
2025-01-05: 买入股票 $1000 → 使用 1月5日汇率 7.2456 = ¥7,245.60
2025-01-15: 卖出股票 $1200 → 使用 1月15日汇率 7.2512 = ¥8,701.44
2025-01-20: 收到股息 $50 → 使用 1月20日汇率 7.2489 = ¥362.45
配置方式：
USE_DYNAMIC_EXCHANGE_RATES=false
USD_CNY_RATE=7.2工作原理：
- 所有美元金额统一使用
USD_CNY_RATE转换为人民币 - 简化计算，不调用任何外部 API
- 适合网络不稳定或小额交易场景
示例：
所有交易使用固定汇率 7.2
$1000 → ¥7,200.00
$1200 → ¥8,640.00
$50 → ¥360.00
工具在以下三个场景应用汇率转换：
-
交易盈亏转换
- 已实现盈亏（Realized P/L）USD → CNY
- 佣金（Commission）USD → CNY
-
股息转换
- 股息金额（Dividend Amount）USD → CNY
-
预扣税转换
- 预扣税金额（Withholding Tax）USD → CNY
所有转换后的人民币金额将用于税务计算。
缓存位置：data/cache/exchange_rates_cache.json
缓存结构：
{
"2025-01-15": 7.2456,
"2025-01-16": 7.2512,
"2025-01-AVG": 7.2484
}建议：
- 每个税务年度初清理缓存，避免使用过期数据
- 可以手动编辑缓存文件添加已知的汇率
本工具按照中国个人所得税法，自动计算境外所得应纳税额。
根据中国税法，境外投资收益（包括交易盈亏和股息）适用 20% 的固定税率。
代码定义位置：src/ibkr_tax/constants.py:20
CHINA_DIVIDEND_TAX_RATE = 0.20 # 20% tax rate应纳税额 = 应税所得 × 20%
应税所得构成：
应税所得 = 交易净利润（人民币）+ 股息收入（人民币）
其中：
- 交易净利润 = 已实现损益 - 手续费（均按人民币计算）
- 股息收入 = 所有美元股息按汇率转换后的人民币金额
可抵免税额 = min(境外实际预扣税, 股息收入 × 20%)
这个公式确保：
- 不超额抵免（取较小值）
- 最多抵免到中国税率对应的税额
- 符合中国税法关于境外所得税收抵免的规定
应补税额 = 应纳税额 - 外国税额抵免
这是最终需要向中国税务机关缴纳的税额。
假设 2025 年有以下数据（已转换为人民币）：
输入数据：
- 交易盈亏：¥10,000
- 佣金：¥200
- 股息收入：¥3,000
- 境外预扣税：¥450
计算过程：
1. 交易净利润 = 10,000 - 200 = ¥9,800
2. 应税所得 = 9,800 + 3,000 = ¥12,800
3. 应纳税额 = 12,800 × 0.2 = ¥2,560
4. 可抵免税额 = min(450, 3,000 × 0.2) = min(450, 600) = ¥450
5. 应补税额 = 2,560 - 450 = ¥2,110
最终结果：需要补缴税款 ¥2,110
亏损情况：
- 如果交易产生亏损（负的盈亏），会直接体现在应税所得中
- 交易亏损可以抵减股息收入
- 示例：交易亏损 ¥5,000 + 股息 ¥3,000 = 应税所得 -¥2,000（可能无需缴税）
无股息情况：
- 如果没有股息收入，外国税额抵免为 0
- 仅对交易净利润征税
无交易盈亏情况：
- 如果只有股息收入，应税所得 = 股息收入
- 可以抵免境外预扣的股息税
核心税务计算函数：src/ibkr_tax/parsers/data_parser.py:321-342
工具会在 data/output/ 目录生成以下文件（文件名包含时间戳）：
文件名格式：ibkr_report_YYYYMMDD_HHMMSS.xlsx
包含 7 个工作表：
- DateTime: 交易日期时间
- Symbol: 股票代码
- Description: 证券名称
- Quantity: 数量
- Price: 价格
- Amount: 交易金额
- Cost: 成本
- Commission: 佣金
- Realized P&L: 已实现盈亏
- Buy Sell: 买入/卖出
- Currency: 货币
- Asset Category: 资产类别
- Open DateTime: 开仓时间
- Account: 账户
- Date: 发放日期
- Symbol: 股票代码
- Description: 证券名称
- Amount: 股息金额
- Currency: 货币
- Type: 类型
- Account: 账户
- Date: 日期
- Symbol: 股票代码
- Description: 证券名称
- Amount: 预扣税金额
- Currency: 货币
- Type: 类型
- Account: 账户
- Date: 日期
- Time: 时间
- Description: 描述
- Amount: 金额
- Currency: 货币
- FX Rate To Base: 汇率
- Amount Base Currency: 基础货币金额
- Transaction Type: 交易类型
- Account: 账户
-
Trade_Summary: 交易汇总
- Total_Trades: 总交易笔数
- Realized_P&L_USD: 美元盈亏
- Realized_P&L_CNY: 人民币盈亏
- Total_Commission_USD: 美元佣金
- Total_Commission_CNY: 人民币佣金
- Net_P&L_CNY: 净盈亏（人民币）
- Average_Exchange_Rate: 平均汇率
-
Dividend_Summary: 股息汇总
- Total_Dividends: 股息笔数
- Total_Amount_USD: 美元总额
- Total_Amount_CNY: 人民币总额
- Average_Exchange_Rate: 平均汇率
-
Tax_Summary: 预扣税汇总
- Total_Withholding_Tax_USD: 美元预扣税
- Total_Withholding_Tax_CNY: 人民币预扣税
- Average_Exchange_Rate: 平均汇率
-
China_Tax_Calculation: 中国税务计算
- Taxable_Income_CNY: 应税所得（人民币）
- Tax_Due_20pct_CNY: 应纳税额（20%）
- Foreign_Tax_Credit_CNY: 可抵免税额
- Tax_Payable_CNY: 应补税额
-
Account_Summary: 账户汇总（如有存取款）
- Total_Deposits_Count: 存款笔数
- Total_Withdrawals_Count: 取款笔数
- Total_Deposits_Base_Currency: 存款总额
- Total_Withdrawals_Base_Currency: 取款总额
- Net_Deposits_Base_Currency: 净存入额
- Symbol: 股票代码
- Description: 证券名称
- Quantity: 持仓数量
- Mark Price: 市场价格
- Position Value: 持仓市值
- Cost Basis: 成本基础
- Unrealized P&L: 未实现盈亏
- Currency: 货币
- Asset Category: 资产类别
- Account: 账户
包含以下指标：
Performance_Summary（投资表现汇总）：
- Beginning_Net_Worth_USD/CNY: 期初净值（美元/人民币）
- Ending_Net_Worth_USD/CNY: 期末净值（美元/人民币）
- Net_Deposits_USD/CNY: 净存入额（美元/人民币）
- Total_Return_Percent: 总收益率（%）
- Annualized_Return_Percent: 年化收益率（%）
- Max_Drawdown_Percent: 最大回撤（%）
- Realized_ROI_Percent: 已实现投资回报率（%）
- Investment_Period_Days: 投资天数
- Avg_Exchange_Rate: 平均汇率
Position_Details（持仓详情）（如有持仓）：
- Total_Positions: 持仓数量
- Total_Position_Value_USD/CNY: 持仓总市值（美元/人民币）
- Total_Cost_Basis_USD: 总成本基础
- Total_Unrealized_P&L_USD/CNY: 总未实现盈亏（美元/人民币）
投资表现指标说明：
-
总收益率：
(期末净值 - 期初净值 - 净存入) / 期初净值 × 100%- 衡量投资的整体增长情况，已剔除存取款影响
-
年化收益率：
(1 + 总收益率)^(365/投资天数) - 1- 将总收益率转换为年度百分比，便于比较不同投资期的表现
-
最大回撤：
(峰值 - 谷底) / 峰值 × 100%- 衡量投资期间从最高点到最低点的最大损失幅度
-
已实现 ROI：
已实现盈亏 / 投资成本 × 100%- 仅基于已平仓交易计算的回报率，不包括未实现盈亏
文件名格式：raw_data_YYYYMMDD_HHMMSS.json
从 IBKR Flex Query API 获取的原始 JSON 数据，用于调试和审计。
文件名格式：summary_YYYYMMDD_HHMMSS.json
包含所有汇总统计数据的 JSON 格式文件，便于其他工具或脚本读取。
ibkr-toolkit/
├── src/ibkr_toolkit/
│ ├── api/
│ │ ├── flex_query.py # IBKR Flex Query API 客户端（税务报表）
│ │ ├── trading_client.py # IBKR Trading API 客户端（交易管理）
│ │ └── web_client.py # IBKR Web API 客户端（RESTful API）
│ ├── parsers/
│ │ └── data_parser.py # 数据解析和税务计算
│ ├── services/
│ │ └── exchange_rate.py # 汇率服务
│ ├── utils/
│ │ └── logging.py # 日志工具
│ ├── cli.py # 税务报表命令行入口
│ ├── stop_loss_cli.py # 交易管理命令行入口
│ ├── web_cli.py # Web API 命令行入口
│ ├── main.py # 主入口（路由到各子命令）
│ ├── config.py # 配置管理
│ ├── constants.py # 常量定义
│ └── exceptions.py # 自定义异常
├── tests/ # 测试文件
├── data/
│ ├── cache/ # 汇率缓存
│ └── output/ # 输出文件
└── pyproject.toml # 项目配置
# 运行所有测试
uv run pytest
# 运行特定测试
uv run pytest tests/test_data_parser.py
# 查看测试覆盖率
uv run pytest --cov=ibkr_tax# 格式化代码
ruff format src tests
# 检查格式
ruff format --check src tests# 运行 linter
ruff check src tests
# 自动修复可修复的问题
ruff check --fix src tests项目配置了 pre-commit hooks 来自动检查代码质量和敏感信息：
# 安装 pre-commit hooks
uv run pre-commit install
# 手动运行所有 hooks
uv run pre-commit run --all-files
# 跳过 hooks 提交（不推荐）
git commit --no-verify配置的检查项：
- ✅ 代码格式化（ruff）
- ✅ Markdown/YAML/JSON 格式化（prettier）
- ✅ 检测私钥泄露
- ✅ 防止提交 .env 文件
- ✅ 防止提交输出文件（包含财务数据）
- ✅ 防止提交大文件（>500KB）
- ✅ 检查合并冲突标记
- ✅ 修复行尾空格和文件末尾换行
# 使用 uv 添加依赖
uv add package-name
# 添加开发依赖
uv add --dev package-nameA: 动态汇率为每笔交易使用当日实际汇率，更符合税务申报要求，计算结果更准确。特别是在汇率波动较大的情况下，差异会更明显。
A: exchangerate-api.com 有 1500 次/月的免费额度。如果超过，工具会自动切换到 Frankfurter API（无限制）。本地缓存机制可以大幅减少 API 调用次数。
A: 在 IBKR Flex Query 中配置多个账户，工具会自动合并所有账户的数据并在输出中标注账户信息。
A: 可以。缓存文件是标准 JSON 格式，你可以手动添加或修改汇率数据。格式为 {"YYYY-MM-DD": 汇率值}。
A: 这是所有交易使用的汇率的算术平均值，仅用于统计展示，不是用来计算金额的月平均汇率。每笔交易仍然使用其当日汇率。
A: 目前主要支持 USD 交易，自动转换为 CNY。其他货币的支持计划中。
A:
- 检查 Excel 中每笔交易的汇率和人民币金额
- 对比原始数据文件（rawdata*.json）
- 使用 Summary sheet 中的数据与自己的记录核对
A:
- 检查
.env中的IBKR_FLEX_TOKEN和IBKR_QUERY_ID是否正确 - 确认 IBKR Flex Query 已正确配置并包含必需的数据类型
- 检查网络连接
- 查看 IBKR Client Portal 中 Flex Query 的状态
A: 使用 --year 参数指定税务年度：
# 查询 2025 年数据
uv run ibkr-toolkit report --year 2025
# 查询 2024 年数据
uv run ibkr-toolkit report --year 2024工具会自动查询该年度 1月1日 至 12月31日 的所有交易记录，无需修改 Flex Query 配置。
A: 是的。当使用 --year、--from-year 或 --all 参数时，命令行指定的日期范围会覆盖 Flex Query 中预设的日期。建议：
- 在 Flex Query 中设置一个默认日期范围（如最近一年）
- 在实际使用时通过命令行参数指定具体年份
- 这样可以灵活查询不同年份的数据而无需修改 Flex Query 配置
A: 有两种方法：
方法 1：使用 --from-year 参数
# 从 2020 年查询到现在
uv run ibkr-toolkit report --from-year 2020方法 2：使用 --all 参数（推荐）
# 1. 在 .env 文件中设置首次交易年份
echo "FIRST_TRADE_YEAR=2020" >> .env
# 2. 运行工具
uv run ibkr-toolkit --all工具会自动按年查询（2020, 2021, 2022...直到当前年份），然后合并所有数据。
A: 会比单年查询慢，但工具已做优化：
- 按年分段查询，每年独立请求（避免 IBKR 365 天限制）
- 某一年失败不影响其他年份
- 显示实时进度，可以看到当前查询状态
- 示例：查询 5 年数据大约需要 1-2 分钟
A: 需要完成以下步骤：
-
下载并安装 Client Portal Gateway
- 下载页面
- 选择 Client Portal Gateway 版本
-
启动 Client Portal Gateway 并登录
cd clientportal.gw bin/run.sh root/conf.yaml- 然后在浏览器访问 https://localhost:5001 登录
-
配置环境变量（可选，使用默认值）
IBKR_WEB_API_URL=https://localhost:5001/v1/api IBKR_WEB_API_VERIFY_SSL=false IBKR_WEB_API_TIMEOUT=30
-
运行交易命令
uv run ibkr-toolkit stop-loss orders
A: 追踪止损单（Trailing Stop Order）是一种动态止损策略：
卖单（SELL）示例：
- 当前股价：$100
- 设置 5% 追踪止损
- 初始止损价：$95
- 股价涨到 $110 → 止损价自动上移到 $104.50
- 股价涨到 $120 → 止损价自动上移到 $114
- 股价跌到 $114 → 触发止损卖出
买单（BUY）示例（逢低买入）：
- 当前股价：$100
- 设置 5% 追踪止损买单
- 股价跌到 $95 → 不触发
- 股价继续跌到 $90 → 不触发
- 股价反弹到 $94.50（从最低点上涨 5%）→ 触发买入
优势：
- 订单提交到 IBKR 系统，24/7 自动监控
- 不需要本地程序一直运行
- 保护利润的同时允许股价继续上涨
A: 不影响。延迟行情（15-20 分钟延迟）仅用于显示价格信息，实际订单执行使用的是实时价格。追踪止损单提交后，IBKR 系统会使用实时价格监控和执行。
A: 使用 stop-loss place 命令时，工具会自动显示持仓信息：
# 会先显示账户的所有持仓，然后下单
uv run ibkr-toolkit stop-loss place U12345678 --percent 5.0输出示例：
Account: U12345678
---------------------------------------------
AAPL : 100 shares @ $150.50, Value: $15,050
TSLA : 50 shares @ $200.00, Value: $10,000
A: 可以。每次命令指定一个账户 ID：
# 账户 1
uv run ibkr-toolkit stop-loss place U12345678 --percent 5.0
# 账户 2
uv run ibkr-toolkit stop-loss place U98765432 --percent 3.0查看所有账户的订单：
uv run ibkr-toolkit stop-loss orders国家税务总局
个人所得税 APP
- APP 下载页面
- 用途：境外所得年度自行申报
相关政策文件
-
申报时间：次年 3月1日 至 6月30日
-
申报方式：
- 个人所得税 APP（推荐）
- 自然人电子税务局网页版
- 办税服务厅现场办理
-
所需资料：
- 境外所得证明（本工具生成的 Excel 报表）
- 境外纳税凭证（IBKR 税务文件，获取方法见下文）
- 身份证件
-
税收抵免：
- 境外已缴税款可抵免
- 抵免限额 = 境外所得 × 中国税率（20%）
- 本工具计算结果仅供参考，不构成税务建议
- 实际申报时请以税务机关要求为准
- 建议咨询专业税务顾问确认申报细节
- 保存好所有交易凭证和纳税证明以备核查
IBKR 每年会为账户持有人生成税务文件，用于证明境外已缴纳的税款。
获取步骤：
- 登录 IBKR 客户端门户
- 点击 Performance & Reports → Tax Documents
- 或通过 Menu → Reporting → Tax Documents
- 选择所需年份，下载税务文件
常见税务文件类型：
- Form 1042-S：非美国居民的美国来源收入预扣税证明（含股息税）
- 年度报表：完整的交易和收入记录
- 股息报告：股息收入明细
文件可用时间：
- 年度报表：次年 2月1日 起
- 股息报告：次年 2月15日 起
- Form 1042-S：次年 3月15日 起
参考链接：
MIT License
本工具仅供个人学习和税务申报参考使用。不保证数据的绝对准确性，税务申报请咨询专业税务顾问。
欢迎提交 Issue 和 Pull Request！
如有问题或建议，请在 GitHub 上提交 Issue。