Integration & API
Vom 30-Minuten-Iframe-Drop-in bis zum vollständigen Custom-Build auf REST + gRPC. Die Plattform bleibt Source of Truth — Sie steuern UX, Brand und Funnel.
Live-Demo · Zero Code
Keine Backend-Änderungen, keine Migration, kein Redesign. Kurzlebiges JWT signieren, Snippet unten in Ihr Client-Portal einbetten — Investoren landen in einer vollständig gebrandeten B2COPY-Experience ohne zweiten Login.
Iframe-Snippet kopieren, in jede Seite Ihres Portals einfügen — Leaderboard, Master-Profil, Subscribe-Flow, alles mobilfähig.
Externes JWT von Ihrem IdP ausstellen, via SideAuthenticate austauschen. Ihre Kunden sehen keinen separaten B2COPY-Login.
Übernimmt Ihre Farben, Typografie und Sprache über Query-Params und CSS-Tokens — out of the box.
Ein Contract
Jede öffentliche Methode ist in gemeinsamen `.proto`-Dateien beschrieben und über gRPC und REST verfügbar. Wählen Sie den Transport, der zu Ihrem Stack passt — Request- und Response-Shapes sind identisch.
Versionierte Routes aus denselben .proto-Dateien. Für CRMs, Web-Apps, Mobile Clients und No-Code — überall, wo HTTPS einfacher ist als gRPC.
Connect oder gRPC-Web für Microservices, interne Gateways und High-Throughput-Integrationen, bei denen Latency und Streaming zählen. Type-safe, codegenerierte Clients in jeder Sprache.
API-Surfaces
Drei schlanke Layers, ein Protobuf-Contract. Unabhängig nutzen oder stacken — Broker für Back Office, Frontend für Ihre eigene Client-App, Widget für Embeds auf Ihrer Marketing-Site.
Server-to-Server. Gebaut für CRM und Back Office — Admin-JWT, paginierte Kontolisten mit eingebetteten Owner-Daten, volles Abonnement-Management für Copier- und PAMM-Links.
Server-to-ServerIm Namen des Users. Treibt Ihre eigene Web- oder Mobile-Client: Auth, Konten, Abonnements, Deals, Gebühren, Transfers, Leaderboard, Charts, UI-Settings — alles vom Login bis zum Schließen einer Position.
User-scopedPublic-read-only Surface. Schlanke Layer für einbettbare Blöcke — Master-Cards, Charts, Leaderboards und Abonnementcode-Checks auf Ihrer Marketing-Site, ohne volle Client-App.
Public · read-onlyAuthentication
EC-signierte Tokens, scoped pro Tenant, unabhängig von User-Sessions rotierbar. Kein Passwort-Handling auf keiner Seite der Integration.
Ihre Back-Office-Services authentifizieren sich an der Broker API mit einem Admin-JWT, signiert mit Ihrem EC-Key. Tokens sind Tenant-scoped und ohne Eingriff in User-Sessions rotierbar.
Broker APIExternes JWT aus Ihrem Client-Portal ausstellen, via SideAuthenticate oder AuthUserWithExternalToken austauschen, dann normale user-scoped Calls. Kein zweiter Login für Ihre Kunden.
Frontend APIErste Schritte
Ein Szenario braucht einen Developer End-to-End 1–3 Tage. Zwei typische Ersteintegrationen: Leaderboard auf Ihrer Website (Widget API) oder CRM-Abonnement-Sync (Broker API).
01
Staging- und Production-Credentials holen — Admin-JWT für die Broker API, SSO-Setup für die Frontend API. Provisioniert innerhalb eines Werktags.
02
gRPC (Connect oder gRPC-Web) oder REST wählen. Die OpenAPI-Spec wird aus denselben .proto-Dateien generiert — wählen Sie, was zu Ihrem Stack passt.
03
Ein Leaderboard auf Ihrer Website (LeaderboardList + ChartService) oder CRM-Abonnement-Sync (Broker LinkService). Ein Szenario dauert 1–3 Tage.
04
SideAuthenticate → Frontend API mit dem User-JWT verketten. Ihre Kunden wechseln vom Portal in die B2COPY-Experience ohne erneute Authentifizierung.
Drei Integrationspfade
Jeder Pfad ist dokumentiert, supported und von anderen Brokern in Production genutzt. Heute mit dem Widget starten, später tiefere API ergänzen — Ihr Stack muss sich nicht bewegen.
Schnellster Weg
Ein vorgefertigtes Widget (Leaderboard, Master-Profil, Subscribe-Flow) in Ihr CRM, Client Area oder Ihre Marketing-Seite einbetten. SSO via signiertem JWT — Ihre Investoren landen bereits authentifiziert und in Ihrem Branding in B2COPY.
Live in 30 Minuten
<!-- 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
ReadyZero Dev
Bereits B2Core, Nullpoint oder FX Back Office im Einsatz? B2COPY ist bereit — Feature aktivieren und Copy Trading erscheint noch am selben Tag in Ihrem Client Area. Die B2Core-Integration schaltet außerdem das IB Module für Partnerprogramme frei.
Volle Kontrolle
Bauen Sie Ihre eigene Copy-Trading-UX von Grund auf. REST für CRMs, Web, Mobile und No-Code; gRPC für hochperformantes Echtzeit-Streaming. Aus denselben Protobuf-Contracts generiert — Semantik zwischen Transports identisch. Sandbox + dedizierter Integrationsingenieur inklusive.
2–3 Wochen · Sandbox + Engineer// REST APIGET/api/v1/copy/mastersPOST/api/v1/copy/subscriptionsGET/api/v1/copy/positionsPUT/api/v1/copy/subscriptions/{id}Abdeckung auf einen Blick
Als Größenreferenz nutzen: CRM-Team gegen Broker API, Client-App gegen Frontend API, Marketing-Site gegen Widget API.
| Feature | Broker API Server-to-Server | Frontend API Im Namen des Users | Widget API Public · read-only |
|---|---|---|---|
| Konten & Nutzer | Reads · paginierte Listen | Volles CRUD + Leaderboard | Reads · Abonnementcode |
| Copier- / PAMM-Abonnements | Vollständige Verwaltung | Vollständige Verwaltung | — |
| Trading & Historie | — | Positionen · Deals · Stats | Positionen · Stats |
| Profitabilität & Charts | — | ✓ | ✓ |
| Gebühren & Promo-Codes | — | ✓ | Aktiver Plan |
| Transfers | — | ✓ | — |
| Challenges & Contests | — | ✓ | — |
| Auth / SSO | — | ✓ | — |
| UI- & Plattformeinstellungen | — | ✓ | Plattformebene |
Broker API
Abonnement-Management und CRM-freundliche Listen-Reads mit Owner-Daten in Responses. Authentifizierung mit Admin-JWT, signiert mit Ihrem EC-Key.
Repräsentative Methoden, die die meisten CRMs am Tag eins brauchen — die volle Broker-API-Surface ist breiter und wird auf Anfrage an Ihr Back-Office-Modell angepasst.
Ein Call liefert eine paginierte Liste von Handelskonten mit Filtern, Sorting und Basis-Owner-Daten (id, E-Mail, Nickname, Land) — gebaut für CRM-Listenansichten.
| Method | Purpose |
|---|---|
List | Paginierte Liste von Handelskonten mit Filtern, Sorting und eingebetteten Owner-Daten — für One-Shot-CRM-Rendering. |
| Method | Purpose |
|---|---|
Get | B2COPY-User-Profil abrufen. |
List | Paginierte Liste von Users. |
Vollständige Verwaltungs-Surface für Copier- und PAMM-Abonnements — erstellen, aktualisieren, löschen, wiederherstellen, Details abrufen und mit Filtern listen.
| Method | Purpose |
|---|---|
CreateCopierLink | Copy-Trading-Abonnement erstellen (Investor → Master). |
CreatePAMMLink | PAMM-Abonnement erstellen. |
UpdateCopierSettings | Copying-Settings aktualisieren. |
UpdatePAMMSettings | PAMM-Settings aktualisieren. |
Delete | Ein Abonnement deaktivieren. |
Restore | Zuvor deaktiviertes Abonnement wiederherstellen. |
GetCopierLink / GetPAMMLink | Details zu einem einzelnen Abonnement. |
ListCopier / ListPAMM | Abonnements mit Filtern und Pagination listen. |
Typische Szenarien: Abonnements mit CRM syncen, Bulk-Ops aus Support-Tools, Master-/Investor-Onboarding auf Broker-Seite orchestrieren. Methode fehlt — Bulk-Reassignment, Custom Owner-Data-Shape, Internal-Tooling-Endpoint? Sagen Sie es beim Scoping; wir ergänzen es im nächsten Release.
Frontend API
Alles vom Login bis zum Schließen einer Position und Auszahlen von Gebühren. Als Ersatz oder Ergänzung zur Standard-B2COPY-Client-App — für Web und Mobile, Authentifizierung via SSO mit kurzlebigen JWT.
Ein repräsentativer Ausschnitt der Frontend API — die tatsächliche Surface umfasst deutlich mehr Services, Felder und Edge Cases. Wir erweitern sie auf Anfrage passend zu Ihrer Client-App-UX.
| Method | Purpose |
|---|---|
Login | Mit Plattform-Username / Passwort anmelden. |
AuthWithPlatformCredentials | Mit Handelskonto-Zugangsdaten authentifizieren. |
RefreshToken | Aktive Session erneuern. |
AuthUserWithExternalToken / AuthAccountWithExternalToken | SSO via externe Tokens — B2COPY in Ihr Client Area einbetten ohne zweiten Login. |
SideAuthenticate / SideLoginWithToken | Nahtloser Side-Login aus Ihrem Broker-Portal. |
Der breiteste Service in der API — deckt Account Lifecycle, öffentliches Leaderboard, Master-Profile, Finanzen, Abonnementcodes und Kontotyp-Management ab.
| Method | Purpose |
|---|---|
Create | B2COPY-Konto auf einem bestehenden MT- oder cTrader-Konto anlegen. |
Get / Update | Kontodaten lesen und bearbeiten. |
LeaderboardList | Öffentliches Master-Leaderboard — Filter, Sorting, Top-N-Feed. |
ListMyAccounts | Konten des aktuellen Users listen. |
ListAccountFinances | Finanzkennzahlen pro Konto. |
SetIsInLeaderboard | Umschalten, ob ein Master im Leaderboard erscheint. |
CheckSubscriptionCode / GenerateSubscriptionCode / SetSubscriptionCode | Abonnementcodes für geschlossene (Invite-only) Master. |
GetMasterByLogin | Master per Login nachschlagen. |
GetAccountView / UpdateAccountView | Öffentliche Profilansicht des Masters. |
SetMinimumDeposit | Mindesteinzahlung für Abonnenten. |
ResetPassword | Kontopasswort zurücksetzen. |
ListAvailableAccountTypes | Auf der Plattform verfügbare Kontotypen. |
| Method | Purpose |
|---|---|
CreateCopierLink / CreatePAMMLink | Abonnement im Namen des Users erstellen. |
UpdateCopierSettings | Copying-Settings aktualisieren. |
Delete / Restore | Unsubscribe und wiederherstellen. |
ListSubscribersCopier / ListSubscriptionsCopier | Copier-Abonnenten und Abonnements. |
ListSubscribersPAMM / ListSubscriptionsPAMM | PAMM-Abonnenten und Abonnements. |
GetOverviewMaster / GetOverviewInvestor | Zusammenfassungsansicht für Master- oder Investorenrolle. |
| Service · Method | Purpose |
|---|---|
PositionService.List / Close / Detach | Offene Positionen, Schließen und Detach von einem Master. |
DealService.List | Deal-Historie. |
StatService.GetTradingStatistics | Aggregierte Handelsstatistiken für Dashboards und Reports. |
| Service · Method | Purpose |
|---|---|
ReturnsService.List | Returns über Zeiträume. |
ProfitabilityService.GetPnlsByLinks | P&L pro Abonnement. |
ChartService.Get / List | Profitabilitäts-Charts für Master-Cards. |
| Service · Method | Purpose |
|---|---|
PlanService | Fee-Pläne erstellen / abrufen, aktiven Plan holen, Plan per Promo-Code abrufen. |
PromoCodeService | Promo-Codes erstellen, aktualisieren, löschen, listen. |
JobService | Fee-Jobs und gezahlte Gebühren pro Investor listen. |
CommissionSharingService | Revenue Share mit Partnern — Commission-Sharing-Setup speichern und lesen. |
| Method | Purpose |
|---|---|
Create | Zwischen Konten transferieren. |
ListTransfers | Transfer-Historie. |
ListMasterFees / ListInvestorFees | Mit Transfers verbundene Gebühren. |
Cancel | Einen Transfer stornieren. |
CanTransfer | Prüfen, ob ein Transfer möglich ist. |
| Service · Method | Purpose |
|---|---|
SettingsService.GetSettings / SetSettings | PAMM-Kontoeinstellungen. |
RolloverService.Start | Rollover auslösen. |
BalanceOperationService.List / SetCancelled (v2) | PAMM-Balance-Operationen. |
| Service · Method | Purpose |
|---|---|
ChallengeService.List | Aktive Challenges listen — Basis für Promo-Kampagnen und Gamification. |
PersonalChallengeService | User-Teilnahme und persönlicher Fortschritt (erstellen, Progress holen, listen). |
StatisticsService.GetDailySummary | Tagesübersicht für Contest-Leaderboards. |
| Service · Method | Purpose |
|---|---|
RiskLimitService.SetLossLimit | Verlustlimit pro Abonnement. |
RatioService.Get | Symbol-Ratios. |
TenantService.ListAllAvailable | Verfügbare Environments und Tenants. |
CommonSettingsService.GetPlatformSettings | Globale Plattformeinstellungen. |
MenuSettingsService.GetMenus | App-Menüstruktur. |
AccountSettingsService.ListBatch | UI-Settings pro Konto (inkl. unauthentifiziertem Zugang). |
UserService.GetCurrentUser / Update | Profil des aktuellen Users. |
ProductService | Produkte und Währungen für Kontoerstellung. |
CountryService.List | Länderreferenz. |
UploadService — GeneratePresignURL / ConfirmUpload / GetUpload | Avatare und Medien via S3-Presign. |
Widget API
Eine schlanke Public Layer, wenn Sie keine vollständige Client-Anwendung brauchen — Leaderboard anzeigen, Master-Card rendern oder einen Abonnementcode von Ihrer Marketing-Site prüfen. Derselbe Protobuf-Contract, weniger Surface.
Überblick der public-read-only Domains des eingebetteten Widgets — die tatsächliche Methodenzahl ist breiter; zusätzliche Read-Endpoints öffnen wir auf Anfrage für Custom-Embeds.
| Domain · Methods | Purpose |
|---|---|
Accounts — Get, List, CheckSubscriptionCode | Master-Card, Leaderboard-Liste fürs Widget, Abonnementcode-Check. |
Profitability — ReturnsService.List, ChartService.Get / List | Mini-Charts und Returns auf der Seite. |
Statistics — StatService.GetTradingStatistics | Headline-Metriken im Widget. |
Positions — PositionService.List | Offene Trades (public read). |
Fees — PlanService.GetActive, GetByPromoCode | Aktiver Plan für das Abonnement-Widget. |
UI — CommonSettingsService.GetPlatformSettings | Branding- und Plattformeinstellungen im Widget. |
Alle drei API-Surfaces sind in gemeinsamen `.proto`-Dateien beschrieben (proto/b2copy/broker, /frontend, /widget) und über gRPC und REST verfügbar — Clients für jede Sprache aus demselben Contract generieren. Die vollständige Methodenliste pro Surface ist deutlich größer als die Beispiele oben; die komplette Referenz steht in den API-Docs und wird auf Anfrage erweitert.
Hands-on-Integrations-Support
Die oben gelisteten Methoden sind eine Auswahl — die echte API ist deutlich breiter, und wir erweitern sie auf Anfrage für CRM, Client Area und Reporting. Ein dedizierter B2COPY-Engineer begleitet vom ersten Sandbox-Call bis zum ersten Live-Copy, damit der Broker eine saubere, passende Integration bekommt — nicht nur eine `.proto`-Datei und viel Glück.
Die Tabellen auf dieser Seite listen repräsentativ ~30 % der API-Surface — Methoden, die die meisten Broker in der ersten Integration nutzen. Der volle Proto-Contract ist über Broker, Frontend und Widget deutlich größer. Fehlt die benötigte Methode auf der Seite, existiert sie fast sicher bereits — und wenn nicht, ergänzen wir sie.
Vom Kickoff bis Go-Live zugewiesen. Prüft Ihren Datenfluss, empfiehlt die saubersten Methodenketten für Ihr Szenario und bleibt für Folgeintegrationen erreichbar.
Methode fehlt in der Liste? Neues Feld in einer bestehenden Response? Bulk-Mode für einen Internal-Tooling-Endpoint? Wir ergänzen es im nächsten Release — typischerweise Tage, nicht Quartale.
Full-Fidelity-Staging mit Sample-Masters, Investoren und Abonnements sowie privatem Slack-/Teams-Kanal mit dem Engineering-Team für schnelles Hin und Her während des Builds.
Wir gehen Endpoints, JWT-Setup, Pagination und Rate Handling gemeinsam durch, bevor Sie in Production gehen. Fängt Edge Cases, bevor sie zu Support-Tickets werden.
Erzählen Sie uns von CRM, Client-Portal und Reporting-Modell — wir mappen den Integrationspfad und zeigen, welche Methoden zu nutzen (und welche zu erweitern) sind.
Häufig gestellte Fragen
Nein. Die Tabellen oben zeigen eine repräsentative Auswahl — ungefähr den Ausschnitt, den die meisten Broker in der ersten Integration nutzen. Die echte API ist über alle drei Surfaces (Broker / Frontend / Widget) deutlich breiter. Die vollständige, aktuelle Referenz steht in den API-Docs unter docs.b2copy.b2broker.com.
Ja. Fehlt die benötigte Methode, das Response-Feld, der Filter oder Bulk-Mode im aktuellen Contract, ergänzen wir sie. Praktisch jeder Broker, den wir onboarden, erhält mindestens eine Custom Extension während der Integration — typischer Turnaround: Tage bis ein Release, nicht Quartale. Szenario beim Scoping nennen — es landet in der Sandbox, bevor Sie Client-Code dagegen schreiben.
Sie bekommen einen dedizierten B2COPY-Integrationsingenieur vom Kickoff bis Go-Live, eine Full-Fidelity-Sandbox mit Sample-Masters / Investoren / Abonnements, einen privaten Slack- oder Teams-Kanal mit dem Engineering-Team für schnelles Hin und Her sowie ein gemeinsames Pre-Prod-Review von Endpoints, JWT-Setup und Pagination vor dem Ship. Ziel: Integration, die zu Ihrem Stack passt — kein generisches Copy-Paste.
Für den Widget- + SSO-Pfad — nein. Ein Back-Office-Admin kann das Iframe-Snippet kopieren und JWTs über das Admin-Panel signieren. Bei vorgefertigten CRM-Connectors (B2Core, Nullpoint, FXBO) ist es ein Feature-Toggle. Tiefere REST- + gRPC-Integrationen brauchen typischerweise einen Backend-Developer 1–3 Tage pro Szenario.
Iframe-Widget in 30 Minuten einbetten — am selben Tag mit SSO. Vorgefertigte CRM-Aktivierung (B2Core / Nullpoint / FX Back Office) ebenfalls same-day. Vollständige Custom-Builds auf REST + gRPC dauern End-to-End 2–3 Wochen mit Sandbox und dediziertem B2COPY-Integrationsingenieur.
Ja. Jede öffentliche Methode ist in gemeinsamen .proto-Dateien beschrieben (proto/b2copy/broker, .../frontend, .../widget). REST-Routes und OpenAPI-Spec werden aus denselben Dateien generiert — Request- und Response-Semantik sind identisch, Sie wählen nur den passenden Transport.
Zwei klare Flows. Server-to-Server: Admin-JWT, signiert mit Ihrem EC-Key, scoped pro Tenant — gegen die Broker API. User Session: externes JWT aus dem Client-Portal ausstellen, via SideAuthenticate (oder AuthUserWithExternalToken) austauschen, dann Frontend API user-scoped. Kein Passwort-Handling auf keiner Seite.
Über 150 Einstellungen im Admin-Panel decken die meisten Aspekte von B2COPY ab, bevor Entwicklung nötig wird: Leaderboard-Spalten, Statistiksichtbarkeit, sechs Gebührenarten und ihre Formeln, vom Broker gesteuerte Risikolimits für Master, Standard-Kontosichtbarkeit, Symbol-Mapping und vollständiges Custom Branding (Farben, Logos, Themes).
Explore more
Performance-, Management-, Abonnement-, Volumen-, Beitritts- und Gewinngebühren.
Mehr erfahrenTageslimits, Max-Drawdown-Controls und persönliche Verlustlimits.
Mehr erfahrenSechs Allokationsmethoden — proportional, Ratio-Multiplier oder Fixed Lot.
Mehr erfahrenTrades über MT4-, MT5-, cTrader- und B2Trader-Server kopieren.
Mehr erfahrenWidget SSO, CRM-Integrationen, REST- und gRPC-APIs.
Mehr erfahrenWir prüfen CRM, Client Area und Back Office und schlagen den Integrationspfad vor, der zu Ihrer Engineering-Tiefe passt — Widget heute, volle API in drei Wochen.
