Intégration et API
D’un iframe en 30 minutes à un build 100 % custom sur REST + gRPC. La plateforme reste la source de vérité — vous contrôlez l’UX, la marque et le funnel.
Démo live · zéro code
Aucun changement backend, aucune migration, aucun redesign. Signez un JWT à courte durée, embarquez le snippet ci-dessous dans votre portail client — vos investisseurs arrivent dans une expérience B2COPY entièrement thématisée sans seconde connexion.
Copiez le snippet iframe, collez-le dans n’importe quelle page de votre portail — classement, profil master, flux d’abonnement, tout mobile-ready.
Émettez un JWT externe depuis votre IdP, échangez-le via SideAuthenticate. Vos clients ne voient jamais une connexion B2COPY séparée.
Hérite de vos couleurs, typographie et langue via query params et tokens CSS — dès le départ.
Un contrat
Chaque méthode publique est décrite dans des fichiers `.proto` partagés et exposée en gRPC et REST. Choisissez le transport qui correspond à votre stack — formes de requête et de réponse identiques.
Routes versionnées générées à partir des mêmes fichiers .proto. Pour CRM, apps web, clients mobiles et scénarios no-code — partout où HTTPS est plus simple que gRPC.
Utilisez Connect ou gRPC-Web pour microservices, gateways internes et intégrations haut débit où latence et streaming comptent. Clients type-safe générés dans n’importe quel langage.
Surfaces API
Trois couches légères, un contrat protobuf. Utilisez-les indépendamment ou empilez-les — Broker pour le back office, Frontend pour votre app client, Widget pour les embeds sur votre site marketing.
Server-to-server. Conçu pour votre CRM et back office — JWT admin, listes de comptes paginées avec données propriétaire embarquées, gestion complète des abonnements pour liens copier et PAMM.
Server-to-serverAu nom de l’utilisateur. Alimente votre propre client web ou mobile : auth, comptes, abonnements, deals, frais, transferts, classement, graphiques, paramètres UI — tout, de la connexion à la clôture d’une position.
User-scopedSurface publique en lecture seule. Une couche allégée pour blocs embarquables — cartes master, graphiques, classements et vérifications de code d’abonnement sur votre site marketing, sans app client complète.
Public · lecture seuleAuthentification
Tokens signés EC scopés par tenant, rotés indépendamment des sessions utilisateur. Aucune gestion de mot de passe de part et d’autre de l’intégration.
Vos services back-office s’authentifient à la Broker API avec un JWT admin signé avec votre clé EC. Les tokens sont scopés par tenant et peuvent être rotés sans toucher aux sessions utilisateur.
Broker APIÉmettez un JWT externe depuis votre portail client, échangez-le via SideAuthenticate ou AuthUserWithExternalToken, puis poursuivez avec des appels user-scoped normaux. Pas de seconde connexion pour vos clients.
Frontend APIPremiers pas
Un scénario prend 1–3 jours de bout en bout pour un développeur. Deux premières intégrations typiques : un classement sur votre site (Widget API), ou la sync d’abonnements CRM (Broker API).
01
Obtenez les credentials staging et production — JWT admin pour la Broker API, setup SSO pour la Frontend API. Provisionnés sous un jour ouvré.
02
Choisissez gRPC (Connect ou gRPC-Web) ou REST. La spec OpenAPI est générée à partir des mêmes fichiers .proto — prenez celui qui correspond à votre stack.
03
Un classement sur votre site (LeaderboardList + ChartService), ou la sync des abonnements CRM (Broker LinkService). Un scénario prend 1–3 jours.
04
Enchaînez SideAuthenticate → Frontend API avec le JWT utilisateur. Vos clients passent de votre portail à l’expérience B2COPY sans se réauthentifier.
Trois parcours d’intégration
Chaque parcours est documenté, supporté et utilisé en production par d’autres brokers. Commencez par le widget aujourd’hui, ajoutez l’API plus profonde plus tard — rien dans votre stack n’a à bouger.
Parcours le plus rapide
Déposez un widget prêt à l’emploi (classement, profil master, flux d’abonnement) dans votre CRM, espace client ou page marketing. SSO via JWT signé — vos investisseurs arrivent dans B2COPY déjà authentifiés, aux couleurs de votre marque.
Live en 30 minutes
<!-- 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
ReadyZéro dev
Vous utilisez déjà B2Core, Nullpoint ou FX Back Office ? B2COPY est prêt — activez la fonctionnalité et le copy trading apparaît dans votre espace client le jour même. L’intégration B2Core débloque aussi le module IB pour les programmes partenaires.
Contrôle total
Construisez votre propre UX de copy trading from scratch. REST pour CRM, web, mobile et no-code ; gRPC pour le streaming temps réel haute performance. Généré à partir des mêmes contrats protobuf — sémantique identique entre transports. Sandbox + ingénieur d’intégration dédié inclus.
2–3 semaines · sandbox + ingénieur// REST APIGET/api/v1/copy/mastersPOST/api/v1/copy/subscriptionsGET/api/v1/copy/positionsPUT/api/v1/copy/subscriptions/{id}Couverture en un coup d’œil
Utilisez-le comme référence de dimensionnement : votre équipe CRM travaille contre la Broker API, votre app client contre la Frontend API, et votre site marketing contre la Widget API.
| Feature | Broker API Server-to-server | Frontend API Au nom de l’utilisateur | Widget API Public · lecture seule |
|---|---|---|---|
| Comptes et utilisateurs | Lectures · listes paginées | CRUD complet + classement | Lectures · code d’abonnement |
| Abonnements Copier / PAMM | Gestion complète | Gestion complète | — |
| Trading et historique | — | Positions · deals · stats | Positions · stats |
| Profitabilité et graphiques | — | ✓ | ✓ |
| Frais et codes promo | — | ✓ | Plan actif |
| Transferts | — | ✓ | — |
| Challenges et concours | — | ✓ | — |
| Auth / SSO | — | ✓ | — |
| UI et paramètres plateforme | — | ✓ | Niveau plateforme |
Broker API
Gestion des abonnements et lectures de listes adaptées au CRM avec données propriétaire embarquées dans les réponses. Authentifie avec un JWT admin signé par votre clé EC.
Méthodes représentatives dont la plupart des CRM ont besoin dès le premier jour — la surface Broker API complète est plus large et s’étend sur demande pour coller à votre modèle back-office.
Un seul appel renvoie une liste paginée de comptes de trading avec filtres, tri et données propriétaire de base (id, e-mail, nickname, pays) — conçu pour les vues liste CRM.
| Method | Purpose |
|---|---|
List | Liste paginée de comptes de trading avec filtres, tri et données propriétaire embarquées — pour un rendu CRM en un coup. |
| Method | Purpose |
|---|---|
Get | Récupérer un profil utilisateur B2COPY. |
List | Liste paginée d’utilisateurs. |
Surface de gestion complète pour les abonnements copier et PAMM — créer, mettre à jour, supprimer, restaurer, récupérer les détails et lister avec filtres.
| Method | Purpose |
|---|---|
CreateCopierLink | Créer un abonnement copy trading (investisseur → master). |
CreatePAMMLink | Créer un abonnement PAMM. |
UpdateCopierSettings | Mettre à jour les paramètres de copie. |
UpdatePAMMSettings | Mettre à jour les paramètres PAMM. |
Delete | Désactiver un abonnement. |
Restore | Restaurer un abonnement précédemment désactivé. |
GetCopierLink / GetPAMMLink | Détails d’un abonnement unique. |
ListCopier / ListPAMM | Lister les abonnements avec filtres et pagination. |
Scénarios typiques : sync des abonnements vers votre CRM, opérations bulk depuis les outils support, orchestration de l’onboarding master / investisseur côté broker. Besoin d’une méthode absente — réaffectation bulk, forme custom des données propriétaire, endpoint d’outil interne ? Dites-le pendant le scoping ; nous l’ajoutons à la prochaine release.
Frontend API
Tout, de la connexion à la clôture d’une position et au paiement des frais. Remplacez ou complétez l’app client B2COPY standard — web et mobile, authentification utilisateur via SSO avec JWT à courte durée.
Un extrait représentatif de la Frontend API — la surface réelle couvre bien plus de services, champs et cas limites. Nous l’étendons sur demande pour coller à l’UX de votre application client.
| Method | Purpose |
|---|---|
Login | Connexion avec identifiant / mot de passe plateforme. |
AuthWithPlatformCredentials | Authentification avec les identifiants du compte de trading. |
RefreshToken | Rafraîchir la session active. |
AuthUserWithExternalToken / AuthAccountWithExternalToken | SSO via tokens externes — embarquez B2COPY dans votre espace client sans seconde connexion. |
SideAuthenticate / SideLoginWithToken | Side-login transparent depuis votre portail broker. |
Le service le plus large de l’API — couvre le cycle de vie des comptes, le classement public, les profils master, les finances, les codes d’abonnement et la gestion des types de compte.
| Method | Purpose |
|---|---|
Create | Créer un compte B2COPY au-dessus d’un compte MT ou cTrader existant. |
Get / Update | Lire et éditer les données de compte. |
LeaderboardList | Le classement public des masters — filtres, tri, feed top-N. |
ListMyAccounts | Lister les comptes détenus par l’utilisateur courant. |
ListAccountFinances | Métriques financières par compte. |
SetIsInLeaderboard | Basculer l’apparition d’un master dans le classement. |
CheckSubscriptionCode / GenerateSubscriptionCode / SetSubscriptionCode | Codes d’abonnement pour masters fermés (sur invitation). |
GetMasterByLogin | Rechercher un master par login. |
GetAccountView / UpdateAccountView | La vue profil public du master. |
SetMinimumDeposit | Dépôt minimum requis des abonnés. |
ResetPassword | Réinitialiser le mot de passe du compte. |
ListAvailableAccountTypes | Types de comptes disponibles sur la plateforme. |
| Method | Purpose |
|---|---|
CreateCopierLink / CreatePAMMLink | Créer un abonnement au nom de l’utilisateur. |
UpdateCopierSettings | Mettre à jour les paramètres de copie. |
Delete / Restore | Désabonner et restaurer. |
ListSubscribersCopier / ListSubscriptionsCopier | Abonnés et abonnements Copier. |
ListSubscribersPAMM / ListSubscriptionsPAMM | Abonnés et abonnements PAMM. |
GetOverviewMaster / GetOverviewInvestor | Vue résumé pour le rôle master ou investisseur. |
| Service · Method | Purpose |
|---|---|
PositionService.List / Close / Detach | Positions ouvertes, clôture et détachement d’un master. |
DealService.List | Historique des deals. |
StatService.GetTradingStatistics | Statistiques de trading agrégées pour tableaux de bord et rapports. |
| Service · Method | Purpose |
|---|---|
ReturnsService.List | Rendements sur des périodes. |
ProfitabilityService.GetPnlsByLinks | P&L par abonnement. |
ChartService.Get / List | Graphiques de profitabilité pour les cartes master. |
| Service · Method | Purpose |
|---|---|
PlanService | Créer / récupérer des plans de frais, le plan actif, un plan par code promo. |
PromoCodeService | Créer, mettre à jour, supprimer, lister les codes promo. |
JobService | Lister les jobs de frais et les frais payés par investisseur. |
CommissionSharingService | Partage de revenus avec les partenaires — enregistrer et lire la config de commission-sharing. |
| Method | Purpose |
|---|---|
Create | Transférer entre comptes. |
ListTransfers | Historique des transferts. |
ListMasterFees / ListInvestorFees | Frais associés aux transferts. |
Cancel | Annuler un transfert. |
CanTransfer | Vérifier si un transfert est possible. |
| Service · Method | Purpose |
|---|---|
SettingsService.GetSettings / SetSettings | Paramètres de compte PAMM. |
RolloverService.Start | Déclencher le rollover. |
BalanceOperationService.List / SetCancelled (v2) | Opérations de balance PAMM. |
| Service · Method | Purpose |
|---|---|
ChallengeService.List | Lister les challenges actifs — base pour campagnes promo et gamification. |
PersonalChallengeService | Participation utilisateur et progression personnelle (créer, obtenir la progression, lister). |
StatisticsService.GetDailySummary | Résumé quotidien pour les classements de concours. |
| Service · Method | Purpose |
|---|---|
RiskLimitService.SetLossLimit | Limite de perte par abonnement. |
RatioService.Get | Ratios de symboles. |
TenantService.ListAllAvailable | Environnements et tenants disponibles. |
CommonSettingsService.GetPlatformSettings | Paramètres globaux de la plateforme. |
MenuSettingsService.GetMenus | Structure du menu de l’application. |
AccountSettingsService.ListBatch | Paramètres UI par compte (y compris accès non authentifié). |
UserService.GetCurrentUser / Update | Profil de l’utilisateur courant. |
ProductService | Produits et devises pour la création de compte. |
CountryService.List | Référentiel des pays. |
UploadService — GeneratePresignURL / ConfirmUpload / GetUpload | Avatars et médias via URL présignée S3. |
Widget API
Une couche publique allégée lorsque vous n’avez pas besoin d’une application client complète — afficher le classement, une carte master ou vérifier un code d’abonnement depuis votre site marketing. Même contrat protobuf, surface plus réduite.
Aperçu des domaines publics en lecture seule utilisés par le widget embarqué — le nombre réel de méthodes est plus large, et nous ouvrons des endpoints de lecture supplémentaires sur demande pour des embeds custom.
| Domain · Methods | Purpose |
|---|---|
Accounts — Get, List, CheckSubscriptionCode | Carte master, liste de classement pour le widget, vérification du code d’abonnement. |
Profitability — ReturnsService.List, ChartService.Get / List | Mini-graphiques et rendements sur la page. |
Statistics — StatService.GetTradingStatistics | Métriques clés dans le widget. |
Positions — PositionService.List | Trades ouverts (lecture publique). |
Fees — PlanService.GetActive, GetByPromoCode | Plan actif pour le widget d’abonnement. |
UI — CommonSettingsService.GetPlatformSettings | Branding et paramètres plateforme dans le widget. |
Les trois surfaces API sont décrites dans des fichiers `.proto` partagés (proto/b2copy/broker, /frontend, /widget) et exposées en gRPC et REST — générez des clients dans n’importe quel langage à partir du même contrat. La liste complète des méthodes par surface est nettement plus large que les exemples ci-dessus ; la référence complète est dans la doc API et s’étend sur demande.
Support d’intégration hands-on
Les méthodes listées ci-dessus sont une sélection — la vraie API est bien plus large, et nous l’étendons sur demande pour coller à votre CRM, espace client et modèle de reporting. Un ingénieur B2COPY dédié vous accompagne du premier appel sandbox à la première copie live, pour une intégration propre et adaptée plutôt qu’un fichier `.proto` et « bonne chance ».
Les tableaux de cette page listent environ ~30 % représentatifs de la surface API — les méthodes que la plupart des brokers atteignent en première intégration. Le contrat proto complet est nettement plus large sur Broker, Frontend et Widget. Si la méthode dont vous avez besoin n’est pas sur la page, elle existe presque certainement déjà — sinon, nous l’ajoutons.
Assigné du kickoff jusqu’au go-live. Analyse vos flux de données, recommande les chaînes de méthodes les plus propres pour votre scénario, et reste disponible pour les intégrations suivantes.
Besoin d’une méthode absente de la liste ? Un nouveau champ sur une réponse existante ? Un mode bulk pour un endpoint d’outil interne ? Nous l’ajoutons à la prochaine release — typiquement en jours, pas en trimestres.
Environnement de staging haute fidélité avec masters, investisseurs et abonnements d’exemple, plus un canal Slack / Teams privé avec l’équipe engineering pour des échanges rapides pendant le build.
Nous passons ensemble vos endpoints, setup JWT, pagination et gestion du rate avant la prod. Attrape les cas limites avant qu’ils ne deviennent des tickets support.
Parlez-nous de votre CRM, portail client et modèle de reporting — nous cartographierons le parcours d’intégration et montrerons quelles méthodes utiliser (et lesquelles étendre).
Questions fréquentes
Non. Les tableaux ci-dessus montrent une sélection représentative de méthodes — à peu près la tranche que la plupart des brokers utilisent en première intégration. La vraie API est nettement plus large sur les trois surfaces (Broker / Frontend / Widget). La référence complète et à jour est dans la doc API sur docs.b2copy.b2broker.com.
Oui. Si la méthode, le champ de réponse, le filtre ou le mode bulk dont vous avez besoin n’est pas dans le contrat actuel, nous l’ajoutons. Pratiquement chaque broker que nous onboardons obtient au moins une extension custom pendant l’intégration — délai typique : jours à une seule release, pas des trimestres. Dites-nous le scénario pendant le scoping et cela arrive dans le sandbox avant que vous n’écriviez le code client.
Vous obtenez un ingénieur d’intégration B2COPY dédié du kickoff au go-live, un sandbox haute fidélité avec masters / investisseurs / abonnements d’exemple, un canal Slack ou Teams privé avec l’équipe engineering pour des échanges rapides, et une revue pré-prod conjointe de vos endpoints, setup JWT et pagination avant la mise en prod. L’objectif est une intégration adaptée à votre stack, pas un copier-coller générique.
Pour le parcours widget + SSO — non. Un admin back-office peut copier le snippet iframe et signer les JWT via le panneau d’admin. Pour les connecteurs CRM prêts à l’emploi (B2Core, Nullpoint, FXBO), c’est un simple toggle. Les intégrations REST + gRPC plus profondes prennent typiquement 1–3 jours par scénario pour un développeur backend.
Intégrez le widget iframe en 30 minutes — le jour même avec SSO. L’activation CRM prête à l’emploi (B2Core / Nullpoint / FX Back Office) est aussi le jour même. Les builds REST + gRPC custom prennent 2–3 semaines de bout en bout avec sandbox et un ingénieur d’intégration B2COPY dédié.
Oui. Chaque méthode publique est décrite dans des fichiers .proto partagés (proto/b2copy/broker, .../frontend, .../widget). Les routes REST et la spec OpenAPI sont générées à partir des mêmes fichiers — sémantique de requête et de réponse identique, vous choisissez juste le transport qui convient à votre stack.
Deux flux distincts. Server-to-server : un JWT admin signé avec votre clé EC, scopé par tenant — utilisé contre la Broker API. Session utilisateur : émettez un JWT externe depuis votre portail client, échangez via SideAuthenticate (ou AuthUserWithExternalToken), puis appelez la Frontend API en user-scoped. Aucune gestion de mot de passe de part et d’autre.
Plus de 150 paramètres du panneau d’administration couvrent la plupart des aspects de B2COPY avant tout développement : colonnes du classement, visibilité des statistiques, six types de frais et leurs formules, limites de risque contrôlées par le broker pour les masters, visibilité des comptes par défaut, mapping des symboles et branding personnalisé complet (couleurs, logos, thèmes).
Explore more
Frais de performance, gestion, abonnement, volume, adhésion et profit.
En savoir plusLimites journalières, contrôles de drawdown max et limites de perte personnelles.
En savoir plusSix méthodes d’allocation — proportionnelle, multiplicateur de ratio ou lot fixe.
En savoir plusCopiez les trades entre serveurs MT4, MT5, cTrader et B2Trader.
En savoir plusWidget SSO, intégrations CRM, API REST et gRPC.
En savoir plusNous examinerons votre CRM, espace client et back office et proposerons le parcours d’intégration adapté à votre profondeur engineering — widget aujourd’hui, API complète en trois semaines.
