Capital.com 比特币交易：OpenData / OpenFinance 接口集成与协议分析

1) 把“可视化操作”变成“可查询数据”

你的团队不需要再反复下载 CSV/手动复制。我们把交易所界面背后的账户活动拆成结构化事件流（按时间窗口与类型过滤），再映射到你内部统一的 OpenFinance/账务实体。

结果是：对账表能对齐 `reference`、`instrumentName` 与交易状态字段，降低“口径不一致”的返工成本。

2) 为风控与运营提供可追溯的生命周期数据

工作订单包含 direction、epic、size/level、以及 guaranteed stop/trailing stop 等参数。我们将其转为“意图 → 创建 → 处置/确认”的状态链，让你能做更早的异常发现。

在需要时，我们会把错误处理策略也写进文档，例如会话过期后的重试、限流退避和幂等写入建议。

3) 兼顾行情分析与合规交付

Capital.com 的图表在 2024 年做了升级：新增 30+ 指标、绘图与模板保存能力，并引入多市场对比等体验改进。我们会把这些“分析工作流”落地为可同步的配置记录。

同时我们会结合隐私政策中对 GDPR 与 AML/CFT（反洗钱/反恐融资）处理与数据保留的说明，设计最小化采集与可审计导出策略。

1) 交易流水历史 API（Statement / Ledger 口径）

从账户活动中拉取入金、出金、交易、swap、以及交易手续费/费用等事件。再按时间区间与交易类型过滤，把字段统一到你的账务模型。

典型用法：按月生成“Capital.com 资金变动报表”，用于资金对账与审计归档。

2) 工作订单（Working Orders）与风险意图追踪

捕获 LIMIT/STOP 工作订单的 direction、epic、orderSize 与 level，同时识别 guaranteedStop、trailingStop 等约束条件。

典型用法：运营核查订单生命周期，发现“创建后未确认/参数异常”的情况并触发流程通知。

3) 仓位快照（Positions）与杠杆暴露面板

拉取开放仓位并做一致性映射，适用于 crypto CFD、altcoins 等资产的风险汇总与指标计算。

典型用法：生成“BTC/ETH 暴露与杠杆治理报表”，支持上限检查与波动差异分析。

4) 行情流（WebSocket）与客户情绪/市场统计（如可用）

对接实时价格推送，构建统一行情数据服务；将数据汇总到 OHLC 风格的历史视图，供分析层调用。

典型用法：把“价格路径”与“策略预期”对齐，做执行窗口评估与回测输入一致性验证。

5) 指标/图表配置同步（TradingView 工作流下游）

结合 Capital.com 的图表升级（2024）与 2025 年网页端 multi-chart（最多并排 6 个图）的能力，把分析模板标准化为配置记录。

典型用法：将指标、区间与布局作为“版本化策略配置”，用于告警评估与周期性报告。

6) 对账单生成与导出流水线

把交易流水 + 活动详情拼装成可读的对账单文档，支持对接你内部字段命名体系与导出格式（JSON/CSV/Excel）。

典型用法：用于财务归档或 ERP 导入，确保每次导出都有可追溯输入参数与处理日志。

方案 1：加密 CFD 组合的账务对账与报表生成

业务背景：运营团队希望每月输出一份“账本视图”，能与内部资金记录比对，并且每条记录可追溯来源。

接入数据：交易与资金事件（按 `from/to` 时间窗 + 类型 DEPOSIT/WITHDRAWAL/TRADE/SWAP/费用）。

OpenData/OpenFinance 映射：把原始事件标准化为“内部 Statement API”实体，报表层只读你的统一接口而不是直连 App。

方案 2：订单生命周期核查（保证金/止损/追踪止损）

业务背景：风控或合规团队需要识别“订单创建与执行之间的异常差异”，并在第一时间发现风险偏移。

接入数据：Working orders（包括 guaranteedStop / trailingStop）+ 订单确认/状态流（用于构建生命周期状态机）。

OpenData/OpenFinance 映射：将订单级事件变成可查询的 Exposure API，支持限额检查、监控和审计日志。

方案 3：TradingView 告警到交易操作的自动化桥接

业务背景：交易策略在图表端产生告警信号（例如买入 BTC 触发），希望自动转换成 Capital.com 可执行的订单行为。

接入数据：告警 payload → 订单意图字段（epic/symbol、direction、size、order type、stop-loss/take-profit 的距离或价格）。

OpenData/OpenFinance 映射：你的系统输出 “TradeIntent API” 事件；我们的适配器在获得授权后，调用对应的 working orders 端点并回传 dealReference 供追踪。

方案 4：多资产行情分析与加密仪表盘

业务背景：研究团队希望在统一面板内同时看 crypto、指数与外汇，并以同一套字段模型进行分析。

接入数据：WebSocket 实时报价（行情流）、再做标准化符号映射；同时参考平台 2024/2025 的图表升级与 multi-chart 规范化布局。

OpenData/OpenFinance 映射：行情流输出为 “MarketData API”，而账务/交易数据仍保持独立，便于数据治理与合规边界划分。

3) 工作订单创建（可组合止损/止盈参数）

若你的 OpenData/OpenFinance 系统需要“把交易意图落地成订单”，我们支持 `POST /api/v1/workingorders`。必填字段包含 `direction`、`epic`、`size`、`level`、`type`（LIMIT/STOP），可选字段包含 `guaranteedStop`、`trailingStop`、`stopDistance`、以及 profit/stop 的 level 或 distance。

# 例子：创建 LIMIT working order
POST https://api-capital.backend-capital.com/api/v1/workingorders
Headers:
  X-SECURITY-TOKEN: <SEC_TOKEN>
  CST: <CST_TOKEN>
Content-Type: application/json

{
  "epic": "BTC",
  "direction": "BUY",
  "size": 1,
  "level": 72000,
  "type": "LIMIT"
}

订单创建可能返回不同状态与拒绝原因。我们会把错误处理与降级策略写入集成层，并把返回的 dealReference 交给你的系统做后续确认追踪。

4) （可选）行情实时推送：WebSocket

对需要更快刷新的仪表盘，我们实现 WebSocket 客户端，对指定仪器集合订阅并接收行情更新。由于流式会话同样有时效，我们会计划续连与 keep-alive 处理。

# 伪代码：连接 WebSocket 获取行情
const ws = new WebSocket("wss://api-streaming-capital.backend-capital.com/connect");
ws.onopen = () => ws.send(JSON.stringify({
  type: "SUBSCRIBE",
  instruments: ["BTC", "ETH"]
}));
ws.onmessage = (msg) => ingestMarketTick(JSON.parse(msg.data));
ws.onerror = handleReconnectBackoff;

数据层面，我们会将“行情数据”与“用户个人数据”分离存储，减少合规边界复杂度，并便于后续 analytics 调用。

合规与隐私（Compliance & privacy）

金融集成必须有清晰的数据治理。Capital.com 的隐私政策声明其在 GDPR 框架下作为数据控制方，并提到与 AML/CFT（反洗钱与反恐融资）相关的处理方式以及数据保留要求。

在我们的交付中，我们坚持最小必要原则：只拉取集成必需字段、避免不必要的敏感标识长期存储，并为每次 ingestion 运行保留可审计日志。

同时对于 CFD 风险披露，我们会把相关风险提示纳入交付与管理端展示，帮助你的系统在对外输出报表时不遗漏关键告知。

隐私政策中还提到：与防止洗钱/恐怖融资相关的法律要求可能导致保留期在至少数年范围内，因此我们会从导出策略与数据生命周期管理上配合你的合规审查。

数据流 / 架构（Data flow / architecture）

一个常见且易验证的数据管道（我们会在项目中按你们的系统落地）：

• 客户端 App / 业务服务 → 发起“对账单/账本同步”任务（时间窗 + 交易类型）。
• 授权连接器 → 创建 session（`POST /api/v1/session`），安全保存短时 token，并调用 history / workingorders / positions 等接口。
• 归一化层 → 把原始字段（`transactionType`、`reference`、`epic`、`status` 等）映射为 OpenFinance 实体。
• 存储与导出层 → 生成可查询视图，并输出 CSV/Excel/JSON 给财务与风控工具。

这种分层能让个人数据处理与行情分析保持隔离边界，并让单元测试（字段映射）与集成测试（API 响应）更容易。

市场定位与用户画像（Market positioning & user profile）

Capital.com 面向零售与活跃交易者，提供覆盖加密货币（BTC 等）、股票/指数/外汇/大宗商品的 CFD 交易体验。公开信息中强调全球拥有 80 万以上用户，并将“交易学习（demo 练习）+ 图表分析工具 + 多语言支持”作为核心体验。

从集成落地的角度，最常见的需求来自合规/风控体系成熟的区域（例如与 CySEC 相关的监管体系），以及希望“移动端图表工作流（TradingView / MT5）→ 后台数据治理”的团队。

我们工作室的交付项（可直接投入生产）

我们交付的是可运行的集成，而不是只停留在文档。目标是把授权访问路径转成你系统可消费的接口与代码资产，让你尽快进入联调与上线阶段。

• 集成规范：端点清单、字段映射（OpenFinance 实体）、查询与导出示例。
• 工作源代码：连接器/适配器 + 轻量封装服务（你选择语言，如 Python / Node.js / Go）。
• 协议分析报告：session/auth 流、token 使用方式、限流与错误说明。
• API 文档 + 测试计划：示例请求、重试规则、幂等与校验策略。
• 合规要点：数据保留、日志策略、以及风控/风险披露接入点。

透明定价：服务起价 $300。并可提供“先交付结果、你确认满意后再付款”的选项，降低你试错成本。

工作流与 API 集成说明

1. 需求确认：提供目标 App 名称（本页已明确）与具体数据需求（交易流水、对账单、仓位、订单、行情）。
2. 数据映射：把 Capital.com 的界面能力转换为 OpenData/OpenFinance 实体与字段口径。
3. 授权连接器开发：实现 session/auth 处理与 endpoint client，再加入限流保护、重连/重试逻辑。
4. 验证：用样例时间窗、交易类型与订单场景跑集成测试，确认导出的结构与一致性。
5. 交付与迭代：交付代码、API 文档与日志；直到你的系统稳定完成 ingestion 与查询。

交付周期取决于接口复杂度。作为参考，包含交易历史与对账导出的一次可用版本通常在 1–2 周内推进；跨系统联动与多格式输出会更长。

常见问题

你需要我提供什么？

你是否宣称提供“开放银行/PSD2”接口？

你如何处理隐私与审计？

联系信息

只需在沟通中说明目标 App 名称与对应需求，我们将基于授权访问路径为你输出范围界定、字段映射、接口端点与交付清单。

访问 /contact.html

如果你已经有明确的数据集（例如“交易账本 + 月度对账单”），请补充样例时间范围与期望输出格式（JSON/CSV/Excel）。

关于我们

我们是一家专注于 App 界面集成与授权 API 集成的技术服务工作室。核心能力覆盖协议分析、接口重构、OpenData/OpenFinance 数据摄取，并交付可直接运行的源码、接口文档与测试计划。

• 交付强调合规：隐私友好日志、最小化采集、以及数据保留策略建议。
• 覆盖端到端流程：协议分析 → 实现 → 测试 → 接口文档。
• 交付成果以“代码 + 测试”为核心，方便你的工程团队快速落地。