海怪投资组合
德国Kraken日内交易者的投资组合跟踪器和税务工具。连接Kraken Futures和Spot API,计算FIFO成本基础,并告诉您是否欠税。
你得到了什么
仪表盘 在 http://localhost:8000 与:
- 期货和现货账户的现金余额
- 税务概述,包括申报状态(单身/已婚)和免税额计算
- 期货损益和现货损益摘要
- 将交易历史与源过滤、日期范围和分页合并
- 使用排序、侧边过滤(长/短)和源过滤定位表
- 所有内容均可按年过滤,可通过URL共享
MCP服务器 AI助手(Claude Code、Cursor、Codex)查询您的投资组合并生成税务报告。
REST API 用于程序化访问您的所有Kraken数据。
快速启动
git clone && cd kraken-portfolio-mcp
npm install创建 .env:
KRAKEN_FUTURES_PUBLIC_KEY=your_key
KRAKEN_FUTURES_PRIVATE_KEY=your_key
KRAKEN_SPOT_API_KEY=your_key
KRAKEN_SPOT_API_SECRET=your_key运行:
npm run dev # dashboard with auto-reload
npm start # production
npm run mcp # MCP server for AI assistants打开 http://localhost:8000 然后点击同步。
税务申报
为德国税法而建。仪表板显示每年的实时税务概览。有关详细报告,请咨询您的AI助手:
生成我的2025年德国加密货币税务报告
MCP工具处理一切:
- 即期交易 先进先出成本法,1年持有期检查,运费(1000欧元)
- 保证金头寸 损益分类为私人销售
- 期货 已实现损益+融资费用、备用备用轨道(1000/2000欧元)、20000损失上限
- 质押 按公平市场价值欧元奖励,256欧元Freigrenze
返回Elster行引用和WISO Steuer或Taxfix的CSV。
API
期货
| 端点 | 返回 |
|---|---|
GET /futures/balances | Flex+现金账户余额 |
GET /futures/positions | 损益表的平仓历史 |
GET /futures/transactions | 已实现损益、融资费用、转账 |
斑点
| 端点 | 返回 |
|---|---|
GET /spots/balances | 所有非零余额 |
GET /spots/positions | 损益结算保证金头寸 |
GET /spots/transactions | 基于FIFO成本的完整历史记录 |
其他
| 端点 | 返回 |
|---|---|
GET / | 仪表板 |
GET /sync | SSE流用于完全数据同步 |
GET /health | 服务器状态 |
MCP设置
添加到您的AI客户端配置中:
{
"mcpServers": {
"kraken-portfolio": {
"command": "npx",
"args": ["tsx", "/path/to/kraken-portfolio-mcp/src/mcp-server.ts"],
"env": {
"KRAKEN_FUTURES_PUBLIC_KEY": "...",
"KRAKEN_FUTURES_PRIVATE_KEY": "...",
"KRAKEN_SPOT_API_KEY": "...",
"KRAKEN_SPOT_API_SECRET": "..."
}
}
}
}可用工具
| 工具 | 它做什么 |
|---|---|
kraken_tracker_futures_balances | 期货账户余额 |
kraken_tracker_futures_positions | 已平仓期货头寸 |
kraken_tracker_futures_transactions | 期货交易历史 |
kraken_tracker_spot_balances | 即期余额 |
kraken_tracker_spot_positions | 现货保证金头寸 |
kraken_tracker_spot_transactions | FIFO现货交易 |
kraken_tracker_portfolio_summary | 组合投资组合概述 |
kraken_tracker_german_tax_report | CSV格式的完整德国税务报告 |
科技
- TypeScript+Express
- 用于AI工具集成的MCP SDK
- 基于成本的FIFO批次跟踪
- 服务器发送实时同步事件
- CoinGecko API加密图标
- 无前端框架,单一自包含的HTML页面
