帳戶
b2copy.broker.accounts.v1.account一次調用返回帶篩選、排序及基礎所有者資料(id、郵箱、暱稱、國家)的交易帳戶分頁列表——專為 CRM 列表視圖打造。
| Method | Purpose |
|---|---|
List | 帶篩選、排序及嵌入所有者資料的交易帳戶分頁列表——用於一次性 CRM 渲染。 |
實時演示 · 零代碼
無需後端改動、無需遷移、無需重新設計。簽發短時 JWT,將下方代碼嵌入客戶門戶——投資者進入完整品牌主題的 B2COPY 體驗,無需二次登錄。
複製 iframe 代碼片段,粘貼到門戶任意頁面——排行榜、策略主資料、訂閱流程,全部適配移動端。
從您的 IdP 簽發外部 JWT,經 SideAuthenticate 兌換。客戶不會看到單獨的 B2COPY 登錄。
通過查詢參數與 CSS 令牌繼承您的顏色、字體與語言——開箱即用。
一套契約
每個公開方法均在共享 `.proto` 文件中描述,並通過 gRPC 與 REST 同時暴露。選擇匹配您技術棧的傳輸方式——請求與響應結構完全一致。
由同一批 .proto 文件生成的版本化路由。適用於 CRM、Web 應用、移動客戶端與無代碼場景——凡是 HTTPS 比 gRPC 更方便的地方。
對微服務、內部網關以及延遲與流式傳輸至關重要的高吞吐集成,使用 Connect 或 gRPC-Web。任意語言的類型安全、代碼生成客戶端。
API 接口面
三層輕量接口,一套 protobuf 契約。可獨立使用或疊加——Broker 用於後臺,Frontend 用於自有客戶端應用,Widget 用於行銷站點嵌入。
伺服器到伺服器。專為您的 CRM 與後臺打造——管理員 JWT、帶嵌入所有者資料的帳戶分頁列表,以及跟單與 PAMM 鏈接的完整訂閱管理。
伺服器到伺服器代表用戶。驅動您自有的 Web 或移動客戶端:認證、帳戶、訂閱、成交、費用、轉賬、排行榜、圖表、UI 設置——從登錄到平倉的一切。
用戶作用域公開只讀接口面。面向可嵌入模塊的精簡層——在行銷站點展示策略主卡片、圖表、排行榜與訂閱碼校驗,無需完整客戶端應用。
公開 · 只讀認證
按租戶隔離的 EC 簽名令牌,可獨立於用戶會話輪換。集成雙方均無需處理密碼。
您的後臺服務使用由您的 EC 密鑰簽名的管理員 JWT 向 Broker API 認證。令牌按租戶隔離,可在不影響用戶會話的情況下輪換。
Broker API從客戶門戶簽發外部 JWT,經 SideAuthenticate 或 AuthUserWithExternalToken 兌換,然後進行常規用戶作用域調用。客戶無需二次登錄。
Frontend API開始使用
單個場景端到端約需開發人員 1–3 天。兩種典型首次集成:網站排行榜(Widget API),或 CRM 訂閱同步(Broker API)。
01
獲取預發與生產憑證——Broker API 的管理員 JWT,以及 Frontend API 的 SSO 配置。一個工作日內開通。
02
選擇 gRPC(Connect 或 gRPC-Web)或 REST。OpenAPI 規範由同一批 .proto 文件生成——選擇最匹配您技術棧的方式即可。
03
在您的網站上展示排行榜(LeaderboardList + ChartService),或同步 CRM 訂閱(Broker LinkService)。單個場景約需 1–3 天。
04
將 SideAuthenticate → Frontend API 與用戶 JWT 串聯。客戶從您的門戶進入 B2COPY 體驗時無需再次登錄。
三條集成路徑
每條路徑均有文檔、支持,並已被其他經紀商用於生產。今天從小組件起步,之後再疊加更深 API——無需遷移現有技術棧。
最快路徑
將預構建小組件(排行榜、策略主資料、訂閱流程)嵌入您的 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 ModuleNullpoint CRM
ReadyFX Back Office
Ready零開發
已在使用 B2Core、Nullpoint 或 FX Back Office?B2COPY 已就緒——打開功能開關,跟單交易當天即可出現在客戶專區。B2Core 集成還可解鎖用於合作伙伴計劃的 IB Module。
完全掌控
從零構建您自己的跟單交易體驗。REST 適用於 CRM、Web、移動端與無代碼場景;gRPC 適用於高性能實時流。由同一套 protobuf 契約生成——兩種傳輸語義完全一致。包含沙箱與專屬集成工程師。
2–3 weeks · sandbox + engineer// REST APIGET/api/v1/copy/mastersPOST/api/v1/copy/subscriptionsGET/api/v1/copy/positionsPUT/api/v1/copy/subscriptions/{id}覆蓋一覽
將其作為範圍參考:CRM 團隊對接 Broker API,客戶端應用對接 Frontend API,行銷站點對接 Widget API。
| Feature | Broker API 伺服器到伺服器 | Frontend API 代表用戶 | Widget API 公開 · 只讀 |
|---|---|---|---|
| 帳戶與用戶 | 讀取 · 分頁列表 | 完整 CRUD + 排行榜 | 讀取 · 訂閱碼 |
| 跟單 / PAMM 訂閱 | 完整管理 | 完整管理 | — |
| 交易與歷史 | — | 倉位 · 成交 · 統計 | 倉位 · 統計 |
| 盈利能力與圖表 | — | ✓ | ✓ |
| 費用與優惠碼 | — | ✓ | 當前方案 |
| 轉賬 | — | ✓ | — |
| 挑戰與競賽 | — | ✓ | — |
| 認證 / SSO | — | ✓ | — |
| UI 與平臺設置 | — | ✓ | 平臺級 |
Broker API
訂閱管理與面向 CRM 的列表讀取,響應中嵌入所有者資料。使用由您的 EC 密鑰簽名的管理員 JWT 進行認證。
多數 CRM 首日所需的代表性方法——完整 Broker API 接口面更廣,並可按需擴展以匹配您的後臺模型。
一次調用返回帶篩選、排序及基礎所有者資料(id、郵箱、暱稱、國家)的交易帳戶分頁列表——專為 CRM 列表視圖打造。
| Method | Purpose |
|---|---|
List | 帶篩選、排序及嵌入所有者資料的交易帳戶分頁列表——用於一次性 CRM 渲染。 |
| Method | Purpose |
|---|---|
Get | 檢索 B2COPY 用戶資料。 |
List | 用戶分頁列表。 |
跟單與 PAMM 訂閱的完整管理面——創建、更新、刪除、恢復、獲取詳情,以及帶篩選的列表。
| Method | Purpose |
|---|---|
CreateCopierLink | 創建跟單交易訂閱(投資者 → 策略主帳戶)。 |
CreatePAMMLink | 創建 PAMM 訂閱。 |
UpdateCopierSettings | 更新跟單設置。 |
UpdatePAMMSettings | 更新 PAMM 設置。 |
Delete | 停用訂閱。 |
Restore | 恢復先前已停用的訂閱。 |
GetCopierLink / GetPAMMLink | 單個訂閱的詳情。 |
ListCopier / ListPAMM | 按篩選條件與分頁列出訂閱。 |
典型場景:將訂閱同步到 CRM、從支持工具執行批量操作、在經紀商側編排策略主帳戶 / 投資者入駐。需要未列出的方法——批量重分配、自訂所有者資料形態、內部工具端點?在範圍界定時告訴我們;我們會在下一次發佈中加入。
Frontend API
從登錄到平倉與費用結算的全流程。可用於替代或補充標準 B2COPY 客戶端應用——支持 Web 與移動端,通過短時 JWT 以 SSO 認證用戶。
Frontend API 的代表性子集——實際接口覆蓋更多服務、字段與邊界場景。我們可按需擴展,以匹配您的客戶端應用體驗。
| Method | Purpose |
|---|---|
Login | 使用平臺用戶名 / 密碼登錄。 |
AuthWithPlatformCredentials | 使用交易帳戶憑證進行認證。 |
RefreshToken | 刷新當前會話。 |
AuthUserWithExternalToken / AuthAccountWithExternalToken | 通過外部令牌實現 SSO——將 B2COPY 嵌入客戶專區,無需二次登錄。 |
SideAuthenticate / SideLoginWithToken | 從經紀商門戶無縫側邊登錄。 |
API 中覆蓋面最廣的服務——涵蓋帳戶生命週期、公開排行榜、策略主資料、財務、訂閱碼與帳戶類型管理。
| Method | Purpose |
|---|---|
Create | 基於現有 MT 或 cTrader 帳戶創建 B2COPY 帳戶。 |
Get / Update | 讀取並編輯帳戶資料。 |
LeaderboardList | 公開策略主排行榜——篩選、排序與 top-N 動態。 |
ListMyAccounts | 列出當前用戶擁有的帳戶。 |
ListAccountFinances | 每個帳戶的財務指標。 |
SetIsInLeaderboard | 切換策略主帳戶是否出現在排行榜。 |
CheckSubscriptionCode / GenerateSubscriptionCode / SetSubscriptionCode | 封閉(僅邀請)策略主帳戶的訂閱碼。 |
GetMasterByLogin | 按登錄名查找策略主帳戶。 |
GetAccountView / UpdateAccountView | 策略主帳戶的公開資料視圖。 |
SetMinimumDeposit | 訂閱者所需的最低入金。 |
ResetPassword | 重置帳戶密碼。 |
ListAvailableAccountTypes | 平臺上可用的帳戶類型。 |
| Method | Purpose |
|---|---|
CreateCopierLink / CreatePAMMLink | 代用戶創建訂閱。 |
UpdateCopierSettings | 更新跟單設置。 |
Delete / Restore | 退訂與恢復。 |
ListSubscribersCopier / ListSubscriptionsCopier | 跟單訂閱者與訂閱。 |
ListSubscribersPAMM / ListSubscriptionsPAMM | PAMM 訂閱者與訂閱。 |
GetOverviewMaster / GetOverviewInvestor | 策略主帳戶或投資者角色的彙總視圖。 |
| 服務 · 方法 | Purpose |
|---|---|
PositionService.List / Close / Detach | 持倉、平倉,以及與策略主帳戶解綁。 |
DealService.List | 成交歷史。 |
StatService.GetTradingStatistics | 用於儀表盤與報告的彙總交易統計。 |
| 服務 · 方法 | Purpose |
|---|---|
ReturnsService.List | 各時間段的收益。 |
ProfitabilityService.GetPnlsByLinks | 每個訂閱的盈虧。 |
ChartService.Get / List | 策略主卡片的盈利能力圖表。 |
| 服務 · 方法 | Purpose |
|---|---|
PlanService | 創建 / 獲取費用方案,獲取當前方案,按優惠碼獲取方案。 |
PromoCodeService | 創建、更新、刪除、列出優惠碼。 |
JobService | 列出費用任務及每位投資者已付費用。 |
CommissionSharingService | 與合作伙伴的收入分成——保存並讀取佣金分成配置。 |
| Method | Purpose |
|---|---|
Create | 帳戶間轉賬。 |
ListTransfers | 轉賬歷史。 |
ListMasterFees / ListInvestorFees | 與轉賬相關的費用。 |
Cancel | 取消一筆轉賬。 |
CanTransfer | 檢查是否可以轉賬。 |
| 服務 · 方法 | Purpose |
|---|---|
SettingsService.GetSettings / SetSettings | PAMM 帳戶設置。 |
RolloverService.Start | 觸發滾動結算。 |
BalanceOperationService.List / SetCancelled (v2) | PAMM 餘額操作。 |
| 服務 · 方法 | Purpose |
|---|---|
ChallengeService.List | 列出進行中的挑戰——促銷活動與遊戲化的基礎。 |
PersonalChallengeService | 用戶參與與個人進度(創建、獲取進度、列表)。 |
StatisticsService.GetDailySummary | 競賽排行榜的日彙總。 |
| 服務 · 方法 | 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 契約,更小的接口面。
嵌入式小組件所用公開只讀領域概覽——實際方法數量更多,我們也可按需開放額外只讀端點以支持定製嵌入。
| 領域 · 方法 | 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% 的代表性 API 接口面——多數經紀商首次集成會用到的方法。完整 proto 契約在 Broker、Frontend 與 Widget 上顯著更大。若您需要的方法不在頁面上,幾乎可以肯定它已存在——若尚不存在,我們會添加。
從啟動到上線全程跟進。審閱您的資料流,推薦最簡潔的方法鏈路,並在後續集成中持續支持。
需要未列出的方法?現有響應上的新字段?內部工具端點的批量模式?我們會在下一次發佈中加入——通常以天計,而非季度。
含示例策略主帳戶、投資者與訂閱的高保真預發環境,以及與工程團隊的私有 Slack / Teams 頻道,便於構建期間快速溝通。
在您上線生產前,我們一起走查端點、JWT 配置、分頁與限流處理。在邊緣情況變成支持工單之前將其攔截。
告訴我們您的 CRM、客戶門戶與報告模型——我們將規劃集成路徑,並說明應使用(以及應擴展)哪些方法。
常見問題解答
不會。上表展示的是代表性方法子集——大致是多數經紀商首次集成會用到的部分。真實 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 的大部分能力,無需開發即可配置:排行榜列、統計可見性、六種費用類型及其公式、經紀商控制的策略主帳戶風險限額、帳戶可見性預設值、品種映射,以及完整自訂品牌(顏色、徽標、主題)。