アカウント
b2copy.broker.accounts.v1.account1回の呼び出しで、フィルター、並べ替え、基本的な所有者データ(ID、メール、ニックネーム、国)が付いたトレーディングアカウントのページ分けされた一覧を取得できます — CRMの一覧表示向けに設計されています。
| Method | Purpose |
|---|---|
List | フィルター、並べ替え、所有者データを含む、ページ分けされたトレーディングアカウント一覧 — CRMでの一括表示向け。 |
統合とAPI
30分で設置できるiframeから、REST + gRPCによる完全カスタム構築まで。プラットフォームは常に唯一の信頼できるデータソースであり、UX、ブランド、ファネルはあなたが管理します。
ライブデモ · コード不要
バックエンドの変更、移行、再設計は一切不要です。有効期限の短いJWTに署名し、以下のスニペットをクライアントポータルに埋め込むだけ — 投資家は二度目のログインなしに、完全にテーマ設定されたB2COPY体験へアクセスできます。
iframeのスニペットをコピーし、ポータル内の任意のページに貼り付けるだけ — リーダーボード、マスタープロフィール、登録フローすべてモバイル対応です。
あなたのIdPから外部JWTを発行し、SideAuthenticateで交換します。クライアントはB2COPYの別のサインイン画面を目にすることはありません。
クエリパラメータとCSSトークンにより、初期設定のままであなたの配色、フォント、言語が継承されます。
1つのコントラクト
すべての公開メソッドは共有の`.proto`ファイルに記述され、gRPCとRESTの両方で公開されています。自社のスタックに合う通信方式を選んでください — リクエストとレスポンスの形式は同一です。
同じ.protoファイルから生成されたバージョン管理されたルート。CRM、Webアプリ、モバイルクライアント、ノーコードのシナリオなど、gRPCよりもHTTPSの方が扱いやすい場面でご利用ください。
レイテンシとストリーミングが重要となるマイクロサービス、内部ゲートウェイ、高スループットの統合にはConnectまたはgRPC-Webをご利用ください。任意の言語で型安全なコード生成クライアントを作成できます。
APIサーフェス
3つの軽量なレイヤーと1つのprotobufコントラクト。個別に使用することも組み合わせることもできます — バックオフィス向けにBroker、独自のクライアントアプリ向けにFrontend、マーケティングサイトへの埋め込み向けにWidgetです。
サーバー間通信。CRMとバックオフィス向けに構築 — 管理者JWT、所有者データ付きのページ分けされたアカウント一覧、コピーおよびPAMMリンクの完全なサブスクリプション管理。
Server-to-serverユーザーに代わって動作します。独自のWebまたはモバイルクライアントを支えます:認証、アカウント、サブスクリプション、取引、手数料、振替、リーダーボード、チャート、UI設定 — ログインからポジションのクローズまですべてを網羅します。
ユーザースコープ公開読み取り専用のサーフェス。マーケティングサイトに埋め込むブロック — マスターカード、チャート、リーダーボード、サブスクリプションコードの確認など — 向けの簡素化されたレイヤーで、完全なクライアントアプリは不要です。
公開 · 読み取り専用認証
テナントごとにスコープされたEC署名トークンは、ユーザーセッションとは独立してローテーションされます。統合のどちら側でもパスワード処理は発生しません。
あなたのバックオフィスサービスは、あなたのEC鍵で署名された管理者JWTを使用してBroker APIに認証します。トークンはテナントスコープであり、ユーザーセッションに影響を与えずにローテーションできます。
Broker APIクライアントポータルから外部JWTを発行し、SideAuthenticateまたはAuthUserWithExternalTokenで交換した後、通常のユーザースコープの呼び出しに進みます。クライアントは二度目のサインインを行う必要はありません。
Frontend APIはじめに
1つのシナリオは開発者が対応すると最初から最後まで1〜3日で完了します。典型的な最初の統合例は2つ — ウェブサイト上のリーダーボード(Widget API)、またはCRMのサブスクリプション同期(Broker API)です。
01
ステージングと本番の認証情報を取得 — Broker API用の管理者JWT、Frontend API用のSSO設定。営業日1日以内に発行されます。
02
gRPC(ConnectまたはgRPC-Web)またはRESTを選択できます。OpenAPI仕様は同じ.protoファイルから生成されているため、自社のスタックに合う方を選んでください。
03
ウェブサイト上のリーダーボード(LeaderboardList + ChartService)、またはCRMのサブスクリプション同期(Broker LinkService)。1つのシナリオは1〜3日で完了します。
04
SideAuthenticateをユーザーJWTでFrontend APIに連結。クライアントは再認証なしに、あなたのポータルからB2COPY駆動の体験へ移行します。
3つの統合パス
すべての導入パスはドキュメント化され、サポートされ、他のブローカーが実際の本番環境で利用しています。今日はウィジェットから始め、後で本格的な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モジュールも利用可能になります。
完全な制御
独自のコピートレーディングUXをゼロから構築できます。CRM、Web、モバイル、ノーコード向けにはREST、高パフォーマンスなリアルタイムストリーミングにはgRPC。いずれも同じprotobufコントラクトから生成されており、通信方式が異なってもセマンティクスは同一です。サンドボックスと専属の統合エンジニアも含まれます。
2〜3週間・サンドボックス+エンジニア// 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 Server-to-server | Frontend API ユーザーに代わって | Widget API 公開 · 読み取り専用 |
|---|---|---|---|
| アカウントとユーザー | 読み取り · ページ分け一覧 | 完全なCRUD + リーダーボード | 読み取り · サブスクリプションコード |
| コピー / PAMMサブスクリプション | 完全な管理 | 完全な管理 | — |
| トレーディングと履歴 | — | ポジション・取引・統計 | ポジション・統計 |
| 収益性とチャート | — | ✓ | ✓ |
| 手数料とプロモコード | — | ✓ | 有効なプラン |
| 振替 | — | ✓ | — |
| チャレンジとコンテスト | — | ✓ | — |
| Auth / SSO | — | ✓ | — |
| UIとプラットフォーム設定 | — | ✓ | プラットフォームレベル |
Broker API
サブスクリプション管理と、レスポンスに所有者データが埋め込まれたCRM向けの一覧読み取り。あなたのEC鍵で署名された管理者JWTで認証します。
ほとんどのCRMが導入初日に必要とする代表的なメソッド — Broker APIの実際の範囲はさらに広く、あなたのバックオフィスモデルに合わせてリクエストベースで拡張されます。
1回の呼び出しで、フィルター、並べ替え、基本的な所有者データ(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の代表的な一部です — 実際のAPI範囲はさらに多くのサービス、フィールド、エッジケースをカバーしています。クライアントアプリのUXに合わせてリクエストベースで拡張します。
| Method | Purpose |
|---|---|
Login | プラットフォームのユーザー名/パスワードでサインイン。 |
AuthWithPlatformCredentials | トレーディングアカウントの認証情報で認証。 |
RefreshToken | 有効なセッションを更新。 |
AuthUserWithExternalToken / AuthAccountWithExternalToken | 外部トークンによるSSO — 二度目のログインなしにB2COPYをクライアントエリアに組み込めます。 |
SideAuthenticate / SideLoginWithToken | ブローカーポータルからのシームレスなサイドログイン。 |
APIの中で最も広範なサービス — アカウントのライフサイクル、公開リーダーボード、マスタープロフィール、財務、サブスクリプションコード、アカウントタイプ管理をカバーします。
| Method | Purpose |
|---|---|
Create | 既存のMTまたはcTraderアカウント上にB2COPYアカウントを作成。 |
Get / Update | アカウントデータの読み取りと編集。 |
LeaderboardList | 公開マスターリーダーボード — フィルター、並べ替え、トップNフィード。 |
ListMyAccounts | 現在のユーザーが所有するアカウントを一覧表示。 |
ListAccountFinances | アカウントごとの財務指標。 |
SetIsInLeaderboard | マスターがリーダーボードに表示されるかどうかを切り替え。 |
CheckSubscriptionCode / GenerateSubscriptionCode / SetSubscriptionCode | 非公開(招待制)マスター向けのサブスクリプションコード。 |
GetMasterByLogin | ログインIDでマスターを検索。 |
GetAccountView / UpdateAccountView | マスターの公開プロフィールビュー。 |
SetMinimumDeposit | 加入者に必要な最低デポジット額。 |
ResetPassword | アカウントのパスワードをリセット。 |
ListAvailableAccountTypes | プラットフォームで利用可能なアカウントタイプ。 |
| Method | Purpose |
|---|---|
CreateCopierLink / CreatePAMMLink | ユーザーに代わってサブスクリプションを作成。 |
UpdateCopierSettings | コピー設定を更新。 |
Delete / Restore | 解約と復元。 |
ListSubscribersCopier / ListSubscriptionsCopier | コピー加入者とサブスクリプション。 |
ListSubscribersPAMM / ListSubscriptionsPAMM | PAMM加入者とサブスクリプション。 |
GetOverviewMaster / GetOverviewInvestor | マスターまたは投資家ロール向けのサマリービュー。 |
| Service · Method | Purpose |
|---|---|
PositionService.List / Close / Detach | ポジションのオープン、クローズ、マスターからの解除。 |
DealService.List | 取引履歴。 |
StatService.GetTradingStatistics | ダッシュボードとレポート向けの集計トレーディング統計。 |
| Service · Method | Purpose |
|---|---|
ReturnsService.List | 期間ごとのリターン。 |
ProfitabilityService.GetPnlsByLinks | サブスクリプションごとのP&L。 |
ChartService.Get / List | マスターカード向けの収益性チャート。 |
| Service · Method | Purpose |
|---|---|
PlanService | 手数料プランの作成/取得、有効なプランの取得、プロモコードによるプラン取得。 |
PromoCodeService | プロモコードの作成、更新、削除、一覧取得。 |
JobService | 手数料ジョブと投資家ごとの支払済み手数料を一覧表示。 |
CommissionSharingService | パートナーとの収益シェア — コミッションシェア設定の保存と読み取り。 |
| Method | Purpose |
|---|---|
Create | アカウント間で振替。 |
ListTransfers | 振替履歴。 |
ListMasterFees / ListInvestorFees | 振替に関連する手数料。 |
Cancel | 振替をキャンセル。 |
CanTransfer | 振替が可能かどうかを確認。 |
| Service · Method | Purpose |
|---|---|
SettingsService.GetSettings / SetSettings | PAMMアカウント設定。 |
RolloverService.Start | ロールオーバーを実行。 |
BalanceOperationService.List / SetCancelled (v2) | PAMM残高操作。 |
| Service · Method | Purpose |
|---|---|
ChallengeService.List | 有効なチャレンジを一覧表示 — プロモキャンペーンやゲーミフィケーションの基盤。 |
PersonalChallengeService | ユーザーの参加状況と個人の進捗(作成、進捗取得、一覧取得)。 |
StatisticsService.GetDailySummary | コンテストリーダーボード向けの日次サマリー。 |
| Service · Method | 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署名付きURLによるアバターとメディア。 |
Widget API
完全なクライアントアプリケーションが不要な場合向けの、簡素化された公開レイヤーです — マーケティングサイトからリーダーボードの表示、マスターカードの描画、サブスクリプションコードの確認などが可能です。同じprotobufコントラクトで、範囲はより限定的です。
組み込みウィジェットで使用される公開読み取り専用ドメインの概要です — 実際のメソッド数はさらに多く、カスタム埋め込み向けに追加の読み取りエンドポイントをリクエストに応じて開放しています。
| Domain · Methods | Purpose |
|---|---|
Accounts — Get, List, CheckSubscriptionCode | マスターカード、ウィジェット用リーダーボード一覧、サブスクリプションコードの確認。 |
Profitability — ReturnsService.List, ChartService.Get / List | ページ内のミニチャートとリターン。 |
Statistics — StatService.GetTradingStatistics | ウィジェット内の主要指標。 |
Positions — PositionService.List | オープン中の取引(公開読み取り)。 |
Fees — PlanService.GetActive, GetByPromoCode | サブスクリプションウィジェット用の有効なプラン。 |
UI — CommonSettingsService.GetPlatformSettings | ウィジェット内のブランディングとプラットフォーム設定。 |
3つのAPIサーフェスはすべて共有の`.proto`ファイル(proto/b2copy/broker、/frontend、/widget)に記述され、gRPCとRESTの両方で公開されています — 同じコントラクトから任意の言語でクライアントを生成できます。各サーフェスのメソッド一覧は上記のサンプルよりもはるかに多く、完全なリファレンスはAPIドキュメントに掲載されており、リクエストに応じて拡張されます。
実践的な統合サポート
上記に記載されているメソッドは一部の選択例です — 実際のAPIはさらに広範囲であり、あなたのCRM、クライアントエリア、レポーティングモデルに合わせてリクエストベースで拡張します。専属のB2COPYエンジニアが最初のサンドボックス呼び出しから最初のライブコピーまで同行するため、ブローカーは`.proto`ファイルと運任せではなく、整った適切な統合を手にできます。
このページの表には、API全体の代表的な約30%が記載されています — ほとんどのブローカーが最初の統合で利用するメソッドです。完全なprotoコントラクトは、Broker、Frontend、Widgetのすべてにおいてはるかに大規模です。必要なメソッドがこのページに記載されていない場合でも、ほぼ間違いなく既に存在しています — 存在しない場合は追加します。
キックオフからローンチまで専属で対応します。データフローを確認し、シナリオに最適なメソッドの組み合わせを提案し、その後の追加連携にも継続的に対応します。
リストにないメソッドが必要ですか?既存レスポンスへの新しいフィールドが必要ですか?社内ツール向けエンドポイントのバルクモードが必要ですか?次のリリースで追加します — 通常は数日、四半期単位ではありません。
サンプルのマスター、投資家、サブスクリプションを備えた本番同等のステージング環境に加え、構築期間中に迅速なやり取りができるエンジニアリングチームとの専用Slack/Teamsチャンネルを提供。
本番環境へのリリース前に、エンドポイント、JWT設定、ページネーション、レート処理について一緒に確認します。サポートチケットになる前にエッジケースを検出します。
あなたのCRM、クライアントポータル、レポーティングモデルについてお知らせください — 統合パスを設計し、どのメソッドを使用すべきか(そしてどれを拡張すべきか)をご提案します。
よくあるご質問
いいえ。上記の表は代表的なメソッドの選択例です — ほとんどのブローカーが最初の統合で使用する範囲におおむね対応しています。実際のAPIは、3つのサーフェス(Broker / Frontend / Widget)すべてにおいてはるかに広範です。完全かつ最新のリファレンスはdocs.b2copy.b2broker.comのAPIドキュメントにあります。
はい。必要なメソッド、レスポンスフィールド、フィルター、バルクモードが現在のコントラクトにない場合は追加します。オンボーディングするほぼすべてのブローカーが、統合中に少なくとも1つのカスタム拡張を受けています — 通常の対応期間は数日から1回のリリースまでで、四半期単位ではありません。スコーピング時にシナリオをお知らせいただければ、クライアントコードを書く前にサンドボックスに反映されます。
キックオフからローンチまで専属のB2COPY統合エンジニアが対応し、サンプルのマスター/投資家/サブスクリプションを備えた本番同等のサンドボックス、迅速なやり取りのためのエンジニアリングチームとの専用Slack/Teamsチャンネル、そしてリリース前のエンドポイント、JWT設定、ページネーションに関する共同の本番前レビューを提供します。目標は、汎用的なコピペではなく、あなたのスタックに適合した統合です。
ウィジェット + SSOのパスであれば不要です。バックオフィス管理者は管理パネルからiframeスニペットをコピーし、JWTに署名できます。構築済みCRMコネクタ(B2Core、Nullpoint、FXBO)の場合は機能の切り替えのみです。より深いREST + gRPC統合の場合、通常バックエンド開発者がシナリオごとに1〜3日を要します。
iframeウィジェットは30分で組み込み可能 — SSO込みでも当日中に完了します。構築済みCRM連携(B2Core / Nullpoint / FX Back Office)の有効化も当日中です。フルカスタムのREST + gRPC構築は、サンドボックスと専属のB2COPY統合エンジニアを含め、2〜3週間で完了します。
はい。すべての公開メソッドは共有の.protoファイル(proto/b2copy/broker、.../frontend、.../widget)に記述されています。RESTルートとOpenAPI仕様は同じファイルから生成されているため、リクエストとレスポンスのセマンティクスは同一であり、あなたのスタックに合う通信方式を選ぶだけです。
2つの異なるフローがあります。サーバー間通信:あなたのEC鍵で署名されたテナントスコープの管理者JWTをBroker APIに対して使用します。ユーザーセッション:クライアントポータルから外部JWTを発行し、SideAuthenticate(またはAuthUserWithExternalToken)で交換した後、ユーザースコープでFrontend APIを呼び出します。どちらの側でもパスワード処理は発生しません。
150以上の管理パネル設定により、開発が必要になる前にB2COPYのほとんどの側面をカバーできます。リーダーボードの列、統計の表示設定、6種類の手数料タイプとその計算式、ブローカーが管理するマスターのリスク制限、アカウント表示のデフォルト設定、シンボルマッピング、そして完全カスタムブランディング(カラー、ロゴ、テーマ)などです。