文档定价 B2STORE

集成与 API

嵌入跟单交易——以分钟计，而非数月

从 30 分钟 iframe 嵌入，到基于 REST + gRPC 的完整定制构建。平台始终是真实来源——您掌控体验、品牌与转化漏斗。

立即开始查看 API 文档

30 min: 嵌入式小组件——复制代码、粘贴、上线。
当天: 预构建 CRM 激活——拨动功能开关即可。
2–3 weeks: 完整 REST + gRPC 构建——沙箱 + 专属工程师。
3 个接口面: Broker · Frontend · Widget——同一套 protobuf 契约。

实时演示 · 零代码

嵌入一个 Iframe——30 分钟上线

无需后端改动、无需迁移、无需重新设计。签发短时 JWT，将下方代码嵌入客户门户——投资者进入完整品牌主题的 B2COPY 体验，无需二次登录。

yourbroker.com/copy-trading

30 分钟上线

复制 iframe 代码片段，粘贴到门户任意页面——排行榜、策略主资料、订阅流程，全部适配移动端。

SSO——无需二次登录

从您的 IdP 签发外部 JWT，经 SideAuthenticate 兑换。客户不会看到单独的 B2COPY 登录。

套用您的品牌主题

通过查询参数与 CSS 令牌继承您的颜色、字体与语言——开箱即用。

一套契约

两种传输，语义相同

每个公开方法均在共享 `.proto` 文件中描述，并通过 gRPC 与 REST 同时暴露。选择匹配您技术栈的传输方式——请求与响应结构完全一致。

REST · HTTPS 上的 JSON

由同一批 .proto 文件生成的版本化路由。适用于 CRM、Web 应用、移动客户端与无代码场景——凡是 HTTPS 比 gRPC 更方便的地方。

Grpc · Native Protobuf

对微服务、内部网关以及延迟与流式传输至关重要的高吞吐集成，使用 Connect 或 gRPC-Web。任意语言的类型安全、代码生成客户端。

API 接口面

选择匹配受众的接口面

三层轻量接口，一套 protobuf 契约。可独立使用或叠加——Broker 用于后台，Frontend 用于自有客户端应用，Widget 用于营销站点嵌入。

Broker API

服务器到服务器。专为您的 CRM 与后台打造——管理员 JWT、带嵌入所有者数据的账户分页列表，以及跟单与 PAMM 链接的完整订阅管理。

服务器到服务器

Frontend API

代表用户。驱动您自有的 Web 或移动客户端：认证、账户、订阅、成交、费用、转账、排行榜、图表、UI 设置——从登录到平仓的一切。

用户作用域

Widget API

公开只读接口面。面向可嵌入模块的精简层——在营销站点展示策略主卡片、图表、排行榜与订阅码校验，无需完整客户端应用。

公开 · 只读

认证

基于 JWT，并可无缝 SSO 进入您的门户

按租户隔离的 EC 签名令牌，可独立于用户会话轮换。集成双方均无需处理密码。

服务器到服务器 JWT

您的后台服务使用由您的 EC 密钥签名的管理员 JWT 向 Broker API 认证。令牌按租户隔离，可在不影响用户会话的情况下轮换。

Broker API

通过 SSO 的用户会话

从客户门户签发外部 JWT，经 SideAuthenticate 或 AuthUserWithExternalToken 兑换，然后进行常规用户作用域调用。客户无需二次登录。

Frontend API

开始使用

从开通到首个可运行场景的四个步骤

单个场景端到端约需开发人员 1–3 天。两种典型首次集成：网站排行榜（Widget API），或 CRM 订阅同步（Broker API）。

申请开通

获取预发与生产凭证——Broker API 的管理员 JWT，以及 Frontend API 的 SSO 配置。一个工作日内开通。

选择传输方式

选择 gRPC（Connect 或 gRPC-Web）或 REST。OpenAPI 规范由同一批 .proto 文件生成——选择最匹配您技术栈的方式即可。

从一个场景开始

在您的网站上展示排行榜（LeaderboardList + ChartService），或同步 CRM 订阅（Broker LinkService）。单个场景约需 1–3 天。

嵌入您的门户

将 SideAuthenticate → Frontend API 与用户 JWT 串联。客户从您的门户进入 B2COPY 体验时无需再次登录。

三条集成路径

选择您想深入的程度

每条路径均有文档、支持，并已被其他经纪商用于生产。今天从小组件起步，之后再叠加更深 API——无需迁移现有技术栈。

最快路径

嵌入式小组件 + SSO

将预构建小组件（排行榜、策略主资料、订阅流程）嵌入您的 CRM、客户区或营销页面。通过签名 JWT 实现 SSO——投资者进入 B2COPY 时已完成认证，并套用您的品牌主题。

30 分钟上线

<!-- Add to your client portal -->
<iframe
  src="https://widget.b2copy.com/copy"
  data-sso-token="{{user.jwt}}"
  data-theme="dark">
</iframe>

B2Core

+ IB Module

Nullpoint CRM

Ready

FX Back Office

Ready

零开发

预构建 CRM 连接器

已在使用 B2Core、Nullpoint 或 FX Back Office？B2COPY 已就绪——打开功能开关，跟单交易当天即可出现在客户区。B2Core 集成还可解锁用于合作伙伴计划的 IB Module。

B2Core 专属： 与 IB Module 原生集成——合作伙伴可自动从每笔跟单交易获得佣金。

当天激活

完全掌控

REST & Grpc API

从零构建您自己的跟单交易体验。REST 适用于 CRM、Web、移动端与无代码场景；gRPC 适用于高性能实时流。由同一套 protobuf 契约生成——两种传输语义完全一致。包含沙箱与专属集成工程师。

2–3 weeks · sandbox + engineer

// REST API
GET/api/v1/copy/masters
POST/api/v1/copy/subscriptions
GET/api/v1/copy/positions
PUT/api/v1/copy/subscriptions/{id}

覆盖一览

哪个 API 接口面覆盖哪些领域

将其作为范围参考：CRM 团队对接 Broker API，客户端应用对接 Frontend API，营销站点对接 Widget API。

Feature	Broker API 服务器到服务器	Frontend API 代表用户	Widget API 公开 · 只读
账户与用户	读取 · 分页列表	完整 CRUD + 排行榜	读取 · 订阅码
跟单 / PAMM 订阅	完整管理	完整管理	—
交易与历史	—	仓位 · 成交 · 统计	仓位 · 统计
盈利能力与图表	—	✓	✓
费用与优惠码	—	✓	当前方案
转账	—	✓	—
挑战与竞赛	—	✓	—
认证 / SSO	—	✓	—
UI 与平台设置	—	✓	平台级

Broker API

服务器到服务器，专为您的 CRM 打造

订阅管理与面向 CRM 的列表读取，响应中嵌入所有者数据。使用由您的 EC 密钥签名的管理员 JWT 进行认证。

多数 CRM 首日所需的代表性方法——完整 Broker API 接口面更广，并可按需扩展以匹配您的后台模型。

账户

b2copy.broker.accounts.v1.account

一次调用返回带筛选、排序及基础所有者数据（id、邮箱、昵称、国家）的交易账户分页列表——专为 CRM 列表视图打造。

Method	Purpose
`List`	带筛选、排序及嵌入所有者数据的交易账户分页列表——用于一次性 CRM 渲染。

用户

b2copy.broker.accounts.v1.user

Method	Purpose
`Get`	检索 B2COPY 用户资料。
`List`	用户分页列表。

订阅（链接）

b2copy.broker.accounts.v1.link

跟单与 PAMM 订阅的完整管理面——创建、更新、删除、恢复、获取详情，以及带筛选的列表。

Method	Purpose
`CreateCopierLink`	创建跟单交易订阅（投资者 → 策略主账户）。
`CreatePAMMLink`	创建 PAMM 订阅。
`UpdateCopierSettings`	更新跟单设置。
`UpdatePAMMSettings`	更新 PAMM 设置。
`Delete`	停用订阅。
`Restore`	恢复先前已停用的订阅。
`GetCopierLink / GetPAMMLink`	单个订阅的详情。
`ListCopier / ListPAMM`	按筛选条件与分页列出订阅。

典型场景：将订阅同步到 CRM、从支持工具执行批量操作、在经纪商侧编排策略主账户 / 投资者入驻。需要未列出的方法——批量重分配、自定义所有者数据形态、内部工具端点？在范围界定时告诉我们；我们会在下一次发布中加入。

Frontend API

您自己的客户端应用

从登录到平仓与费用结算的全流程。可用于替代或补充标准 B2COPY 客户端应用——支持 Web 与移动端，通过短时 JWT 以 SSO 认证用户。

Frontend API 的代表性子集——实际接口覆盖更多服务、字段与边界场景。我们可按需扩展，以匹配您的客户端应用体验。

认证

auth.v1.authn

Method	Purpose
`Login`	使用平台用户名 / 密码登录。
`AuthWithPlatformCredentials`	使用交易账户凭证进行认证。
`RefreshToken`	刷新当前会话。
`AuthUserWithExternalToken / AuthAccountWithExternalToken`	通过外部令牌实现 SSO——将 B2COPY 嵌入客户区，无需二次登录。
`SideAuthenticate / SideLoginWithToken`	从经纪商门户无缝侧边登录。

账户

accounts.v1.account

API 中覆盖面最广的服务——涵盖账户生命周期、公开排行榜、策略主资料、财务、订阅码与账户类型管理。

Method	Purpose
`Create`	基于现有 MT 或 cTrader 账户创建 B2COPY 账户。
`Get / Update`	读取并编辑账户数据。
`LeaderboardList`	公开策略主排行榜——筛选、排序与 top-N 动态。
`ListMyAccounts`	列出当前用户拥有的账户。
`ListAccountFinances`	每个账户的财务指标。
`SetIsInLeaderboard`	切换策略主账户是否出现在排行榜。
`CheckSubscriptionCode / GenerateSubscriptionCode / SetSubscriptionCode`	封闭（仅邀请）策略主账户的订阅码。
`GetMasterByLogin`	按登录名查找策略主账户。
`GetAccountView / UpdateAccountView`	策略主账户的公开资料视图。
`SetMinimumDeposit`	订阅者所需的最低入金。
`ResetPassword`	重置账户密码。
`ListAvailableAccountTypes`	平台上可用的账户类型。

订阅（链接）

accounts.v1.link

Method	Purpose
`CreateCopierLink / CreatePAMMLink`	代用户创建订阅。
`UpdateCopierSettings`	更新跟单设置。
`Delete / Restore`	退订与恢复。
`ListSubscribersCopier / ListSubscriptionsCopier`	跟单订阅者与订阅。
`ListSubscribersPAMM / ListSubscriptionsPAMM`	PAMM 订阅者与订阅。
`GetOverviewMaster / GetOverviewInvestor`	策略主账户或投资者角色的汇总视图。

交易与统计

trades.v1

服务 · 方法	Purpose
`PositionService.List / Close / Detach`	持仓、平仓，以及与策略主账户解绑。
`DealService.List`	成交历史。
`StatService.GetTradingStatistics`	用于仪表盘与报告的汇总交易统计。

盈利能力

profitability.v1

服务 · 方法	Purpose
`ReturnsService.List`	各时间段的收益。
`ProfitabilityService.GetPnlsByLinks`	每个订阅的盈亏。
`ChartService.Get / List`	策略主卡片的盈利能力图表。

费用与联盟收入

fees.v1, fees.v2

服务 · 方法	Purpose
`PlanService`	创建 / 获取费用方案，获取当前方案，按优惠码获取方案。
`PromoCodeService`	创建、更新、删除、列出优惠码。
`JobService`	列出费用任务及每位投资者已付费用。
`CommissionSharingService`	与合作伙伴的收入分成——保存并读取佣金分成配置。

转账

transfers.v1.transfer

Method	Purpose
`Create`	账户间转账。
`ListTransfers`	转账历史。
`ListMasterFees / ListInvestorFees`	与转账相关的费用。
`Cancel`	取消一笔转账。
`CanTransfer`	检查是否可以转账。

PAMM

pamm.v1, pamm.v2

服务 · 方法	Purpose
`SettingsService.GetSettings / SetSettings`	PAMM 账户设置。
`RolloverService.Start`	触发滚动结算。
`BalanceOperationService.List / SetCancelled (v2)`	PAMM 余额操作。

挑战与竞赛

challenges.v1

服务 · 方法	Purpose
`ChallengeService.List`	列出进行中的挑战——促销活动与游戏化的基础。
`PersonalChallengeService`	用户参与与个人进度（创建、获取进度、列表）。
`StatisticsService.GetDailySummary`	竞赛排行榜的日汇总。

风险、品种、租户、UI 设置

supporting services

服务 · 方法	Purpose
`RiskLimitService.SetLossLimit`	每个订阅的亏损限额。
`RatioService.Get`	品种比率。
`TenantService.ListAllAvailable`	可用环境与租户。
`CommonSettingsService.GetPlatformSettings`	全局平台设置。
`MenuSettingsService.GetMenus`	应用菜单结构。
`AccountSettingsService.ListBatch`	每个账户的 UI 设置（含未认证访问）。
`UserService.GetCurrentUser / Update`	当前用户资料。
`ProductService`	用于开户的产品与货币。
`CountryService.List`	国家参考数据。
`UploadService — GeneratePresignURL / ConfirmUpload / GetUpload`	通过 S3 预签名上传头像与媒体。

Widget API

可嵌入模块 · 公开只读

精简的公开层，适用于无需完整客户端应用的场景——在营销站点展示排行榜、渲染策略主卡片，或校验订阅码。同一套 protobuf 契约，更小的接口面。

嵌入式小组件所用公开只读领域概览——实际方法数量更多，我们也可按需开放额外只读端点以支持定制嵌入。

Widget 只读接口面

b2copy.widget.*

领域 · 方法	Purpose
`Accounts — Get, List, CheckSubscriptionCode`	策略主卡片、小组件排行榜列表、订阅码校验。
`Profitability — ReturnsService.List, ChartService.Get / List`	页面上的迷你图表与收益。
`Statistics — StatService.GetTradingStatistics`	小组件中的关键指标。
`Positions — PositionService.List`	持仓交易（公开只读）。
`Fees — PlanService.GetActive, GetByPromoCode`	订阅小组件的当前方案。
`UI — CommonSettingsService.GetPlatformSettings`	小组件内的品牌与平台设置。

三个 API 接口面均在共享 `.proto` 文件中描述（proto/b2copy/broker、/frontend、/widget），并通过 gRPC 与 REST 同时暴露——可从同一契约为任意语言生成客户端。每个接口面的完整方法列表远大于上文示例；完整参考见 API 文档，并可按需扩展。

实操式集成支持

我们与您共建集成——而不是只交付一份契约

上文列出的方法只是一部分——真实 API 远更广阔，我们可按需扩展以匹配您的 CRM、客户区与报告模型。专属 B2COPY 工程师从首次沙箱调用陪跑到首次实盘跟单，让经纪商获得贴合的干净集成，而不是一个 `.proto` 文件加一句「祝你好运」。

~30%上文所示

本页表格列出了约 30% 的代表性 API 接口面——多数经纪商首次集成会用到的方法。完整 proto 契约在 Broker、Frontend 与 Widget 上显著更大。若您需要的方法不在页面上，几乎可以肯定它已存在——若尚不存在，我们会添加。

专属集成工程师

从启动到上线全程跟进。审阅您的数据流，推荐最简洁的方法链路，并在后续集成中持续支持。

可按需扩展 API

需要未列出的方法？现有响应上的新字段？内部工具端点的批量模式？我们会在下一次发布中加入——通常以天计，而非季度。

沙箱 + 私有沟通

含示例策略主账户、投资者与订阅的高保真预发环境，以及与工程团队的私有 Slack / Teams 频道，便于构建期间快速沟通。

联合预发评审

在您上线生产前，我们一起走查端点、JWT 配置、分页与限流处理。在边缘情况变成支持工单之前将其拦截。

告诉我们您的 CRM、客户门户与报告模型——我们将规划集成路径，并说明应使用（以及应扩展）哪些方法。

预约集成沟通查看完整 API 文档

常见问题解答

常见问题

不会。上表展示的是代表性方法子集——大致是多数经纪商首次集成会用到的部分。真实 API 在三个接口面（Broker / Frontend / Widget）上都显著更广。完整、最新的参考文档位于 docs.b2copy.b2broker.com。

是的。若您需要的方法、响应字段、筛选器或批量模式不在当前契约中，我们会添加。实际上几乎每位接入的经纪商都会在集成期间获得至少一次定制扩展——典型周转以天到单次发布计，而非季度。在范围界定时告诉我们场景，它会在您编写客户端代码前进入沙箱。

从启动到上线，您将获得专属 B2COPY 集成工程师、含示例策略主账户 / 投资者 / 订阅的高保真沙箱、与工程团队的私有 Slack 或 Teams 频道以便快速沟通，以及上线前对端点、JWT 配置与分页的联合预发评审。目标是贴合您技术栈的集成，而非通用复制粘贴。

若走小组件 + SSO 路径——不需要。后台管理员可复制 iframe 代码，并在管理面板中签发 JWT。预构建 CRM 连接器（B2Core、Nullpoint、FXBO）只需打开功能开关。更深的 REST + gRPC 集成通常每个场景需后端开发 1–3 天。

30 分钟内嵌入 iframe 小组件——配合 SSO 可当天完成。预构建 CRM 激活（B2Core / Nullpoint / FX Back Office）同样可当天完成。完整自定义 REST + gRPC 构建端到端约 2–3 周，含沙箱与专属 B2COPY 集成工程师。

是的。每个公开方法均在共享 .proto 文件中描述（proto/b2copy/broker、.../frontend、.../widget）。REST 路由与 OpenAPI 规范由同一批文件生成——请求与响应语义完全一致，您只需选择适合技术栈的传输方式。

两套截然不同的流程。服务器到服务器：由您的 EC 密钥签名、按租户隔离的管理员 JWT——用于 Broker API。用户会话：从客户门户签发外部 JWT，经 SideAuthenticate（或 AuthUserWithExternalToken）兑换，然后调用用户作用域的 Frontend API。双方均无需处理密码。

150+ 项管理面板设置覆盖 B2COPY 的大部分能力，无需开发即可配置：排行榜列、统计可见性、六种费用类型及其公式、经纪商控制的策略主账户风险限额、账户可见性默认值、品种映射，以及完整自定义品牌（颜色、徽标、主题）。

Explore more

联系集成团队

让 B2COPY 在您的技术栈中上线

我们将审阅您的 CRM、客户区与后台，并据此提出匹配工程深度的集成路径——今天用小组件，三周内完成完整 API。

立即开始联系销售

嵌入跟单交易——以分钟计，而非数月

嵌入一个 Iframe——30 分钟上线

30 分钟上线

SSO——无需二次登录

套用您的品牌主题

两种传输，语义相同

REST · HTTPS 上的 JSON

Grpc · Native Protobuf

选择匹配受众的接口面

Broker API

Frontend API

Widget API

基于 JWT，并可无缝 SSO 进入您的门户

服务器到服务器 JWT

通过 SSO 的用户会话

从开通到首个可运行场景的四个步骤

申请开通

选择传输方式

从一个场景开始

嵌入您的门户

选择您想深入的程度

嵌入式小组件 + SSO

预构建 CRM 连接器

REST & Grpc API

哪个 API 接口面覆盖哪些领域

服务器到服务器，专为您的 CRM 打造

您自己的客户端应用

可嵌入模块 · 公开只读

我们与您共建集成——而不是只交付一份契约

专属集成工程师

可按需扩展 API

沙箱 + 私有沟通

联合预发评审

常见问题

See Related Capabilities

6 种费用类型

风险管理

仓位规模

多服务器跟单

集成选项

让 B2COPY 在您的技术栈中上线