Integrazione e API
Da un iframe in 30 minuti a un build totalmente custom su REST + gRPC. La piattaforma resta la source of truth — tu controlli UX, brand e funnel.
Demo live · zero codice
Nessuna modifica backend, nessuna migrazione, nessun redesign. Firma un JWT a breve durata, incorpora lo snippet sotto nel portale client — gli investitori arrivano in un’esperienza B2COPY completamente temata senza secondo login.
Copia lo snippet iframe, incollalo in qualsiasi pagina del portale — classifica, profilo master, flusso di subscribe, tutto mobile-ready.
Emetti un JWT esterno dal tuo IdP, scambialo via SideAuthenticate. I clienti non vedono mai un login B2COPY separato.
Eredita colori, tipografia e lingua tramite query param e token CSS — out of the box.
Un contratto
Ogni metodo pubblico è descritto in file `.proto` condivisi ed esposto su gRPC e REST. Scegli il transport che combacia con lo stack — forme di request e response identiche.
Route versionate generate dagli stessi file .proto. Per CRM, app web, client mobile e scenari no-code — ovunque HTTPS sia più semplice di gRPC.
Usa Connect o gRPC-Web per microservizi, gateway interni e integrazioni ad alto throughput dove latenza e streaming contano. Client type-safe generati in qualsiasi linguaggio.
Superfici API
Tre layer leggeri, un contratto protobuf. Usali in modo indipendente o impilali — Broker per il back office, Frontend per la tua app client, Widget per gli embed sul sito marketing.
Server-to-server. Pensato per CRM e back office — JWT admin, liste account paginate con dati owner embedded, gestione completa degli abbonamenti per link copier e PAMM.
Server-to-serverPer conto dell’utente. Alimenta la tua app web o mobile: auth, account, abbonamenti, deal, fee, transfer, classifica, chart, impostazioni UI — tutto dal login alla chiusura di una posizione.
User-scopedSuperficie pubblica read-only. Uno strato ridotto per blocchi embeddabili — card master, chart, classifiche e check dei codici di abbonamento sul sito marketing, senza un’app client completa.
Public · read-onlyAutenticazione
Token firmati EC scopati per tenant, ruotati indipendentemente dalle sessioni utente. Nessuna gestione password da entrambe le parti dell’integrazione.
I servizi di back-office si autenticano alla Broker API con un JWT admin firmato con la tua chiave EC. I token sono scoped per tenant e possono essere ruotati senza toccare le sessioni utente.
Broker APIEmetti un JWT esterno dal portale client, scambialo via SideAuthenticate o AuthUserWithExternalToken, poi procedi con chiamate user-scoped normali. Nessun secondo login per i clienti.
Frontend APIPer iniziare
Uno scenario richiede 1–3 giorni end-to-end a uno sviluppatore. Due prime integrazioni tipiche: una classifica sul sito (Widget API), o sync abbonamenti CRM (Broker API).
01
Ottieni credenziali staging e production — JWT admin per la Broker API, setup SSO per la Frontend API. Provisionate entro un giorno lavorativo.
02
Scegli gRPC (Connect o gRPC-Web) o REST. La spec OpenAPI è generata dagli stessi file .proto — prendi quello che combacia con il tuo stack.
03
Una classifica sul tuo sito (LeaderboardList + ChartService), o sync degli abbonamenti CRM (Broker LinkService). Uno scenario richiede 1–3 giorni.
04
Collega SideAuthenticate → Frontend API con lo JWT utente. I clienti passano dal tuo portale all’esperienza B2COPY senza riautenticarsi.
Tre percorsi di integrazione
Ogni percorso è documentato, supportato e usato in produzione da altri broker. Inizia oggi con il widget, aggiungi API più profonde dopo — nulla del tuo stack deve muoversi.
Percorso più rapido
Inserisci un widget predefinito (classifica, profilo master, subscribe-flow) nel CRM, area clienti o pagina marketing. SSO via JWT firmato — gli investitori arrivano in B2COPY già autenticati, con il tuo brand.
Live in 30 minuti
<!-- 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 sviluppo
Usi già B2Core, Nullpoint o FX Back Office? B2COPY è pronto — attiva la funzione e il copy trading compare nell’area clienti lo stesso giorno. L’integrazione B2Core sblocca anche il modulo IB per i partner program.
Controllo totale
Costruisci la tua UX di copy trading da zero. REST per CRM, web, mobile e no-code; gRPC per streaming real-time ad alte prestazioni. Generato dagli stessi contratti protobuf — semantica identica tra i transport. Sandbox + integration engineer dedicato inclusi.
2–3 settimane · sandbox + engineer// REST APIGET/api/v1/copy/mastersPOST/api/v1/copy/subscriptionsGET/api/v1/copy/positionsPUT/api/v1/copy/subscriptions/{id}Copertura a colpo d’occhio
Usalo come riferimento di sizing: il team CRM lavora contro la Broker API, l’app client contro la Frontend API e il sito marketing contro la Widget API.
| Feature | Broker API Server-to-server | Frontend API Per conto dell’utente | Widget API Public · read-only |
|---|---|---|---|
| Account e utenti | Letture · liste paginate | CRUD completo + classifica | Letture · codice di abbonamento |
| Abbonamenti Copier / PAMM | Gestione completa | Gestione completa | — |
| Trading e storico | — | Positions · deals · stats | Positions · stats |
| Profitabilità e chart | — | ✓ | ✓ |
| Fee e codici promo | — | ✓ | Piano attivo |
| Trasferimenti | — | ✓ | — |
| Challenge e contest | — | ✓ | — |
| Auth / SSO | — | ✓ | — |
| UI e impostazioni piattaforma | — | ✓ | A livello piattaforma |
Broker API
Gestione abbonamenti e letture lista CRM-friendly con dati owner embedded nelle response. Autentica con un JWT admin firmato dalla tua chiave EC.
Metodi rappresentativi di cui la maggior parte dei CRM ha bisogno dal giorno uno — la superficie Broker API completa è più ampia e si estende su richiesta per adattarsi al modello back-office.
Una sola chiamata restituisce una lista paginata di conti di trading con filtri, ordinamento e dati owner di base (id, email, nickname, paese) — pensata per le list view CRM.
| Method | Purpose |
|---|---|
List | Lista paginata di conti di trading con filtri, ordinamento e dati owner embedded — per rendering CRM in un colpo. |
| Method | Purpose |
|---|---|
Get | Recupera un profilo utente B2COPY. |
List | Lista paginata di utenti. |
Superficie di gestione completa per abbonamenti copier e PAMM — crea, aggiorna, elimina, ripristina, recupera dettagli e elenca con filtri.
| Method | Purpose |
|---|---|
CreateCopierLink | Crea un abbonamento copy trading (investitore → master). |
CreatePAMMLink | Crea un abbonamento PAMM. |
UpdateCopierSettings | Aggiorna le impostazioni di copia. |
UpdatePAMMSettings | Aggiorna le impostazioni PAMM. |
Delete | Disabilita un abbonamento. |
Restore | Ripristina un abbonamento precedentemente disabilitato. |
GetCopierLink / GetPAMMLink | Dettagli di un singolo abbonamento. |
ListCopier / ListPAMM | Elenca abbonamenti con filtri e paginazione. |
Scenari tipici: sync abbonamenti al CRM, operazioni bulk da tool di supporto, orchestrazione onboarding master / investitore lato broker. Serve un metodo non elencato — riassegnazione bulk, shape custom dei dati owner, endpoint di tooling interno? Diccelo in scoping; lo aggiungiamo alla prossima release.
Frontend API
Tutto, dal login alla chiusura di una posizione e al pagamento delle fee. Sostituisci o completa l’app client B2COPY standard — web e mobile, autenticazione utente via SSO con JWT a breve durata.
Una selezione rappresentativa della Frontend API — la superficie reale copre molti più servizi, campi e casi limite. La estendiamo su richiesta per adattarla all’UX della tua app client.
| Method | Purpose |
|---|---|
Login | Accedi con username / password della piattaforma. |
AuthWithPlatformCredentials | Autenticati con le credenziali del conto di trading. |
RefreshToken | Aggiorna la sessione attiva. |
AuthUserWithExternalToken / AuthAccountWithExternalToken | SSO via token esterni — incorpora B2COPY nell’area clienti senza secondo login. |
SideAuthenticate / SideLoginWithToken | Side-login seamless dal portale broker. |
Il servizio più ampio dell’API — copre ciclo di vita account, classifica pubblica, profili master, finanze, codici di abbonamento e gestione dei tipi di account.
| Method | Purpose |
|---|---|
Create | Crea un account B2COPY sopra un account MT o cTrader esistente. |
Get / Update | Leggi e modifica i dati account. |
LeaderboardList | La classifica pubblica dei master — filtri, ordinamento, feed top-N. |
ListMyAccounts | Elenca gli account di proprietà dell’utente corrente. |
ListAccountFinances | Metriche finanziarie per account. |
SetIsInLeaderboard | Attiva/disattiva se un master compare in classifica. |
CheckSubscriptionCode / GenerateSubscriptionCode / SetSubscriptionCode | Codici di abbonamento per master chiusi (solo su invito). |
GetMasterByLogin | Cerca un master per login. |
GetAccountView / UpdateAccountView | La vista profilo pubblico del master. |
SetMinimumDeposit | Deposito minimo richiesto agli iscritti. |
ResetPassword | Reimposta la password dell’account. |
ListAvailableAccountTypes | Tipi di account disponibili sulla piattaforma. |
| Method | Purpose |
|---|---|
CreateCopierLink / CreatePAMMLink | Crea un abbonamento per conto dell’utente. |
UpdateCopierSettings | Aggiorna le impostazioni di copia. |
Delete / Restore | Disiscriviti e ripristina. |
ListSubscribersCopier / ListSubscriptionsCopier | Iscritti e abbonamenti Copier. |
ListSubscribersPAMM / ListSubscriptionsPAMM | Iscritti e abbonamenti PAMM. |
GetOverviewMaster / GetOverviewInvestor | Vista riepilogo per il ruolo master o investitore. |
| Service · Method | Purpose |
|---|---|
PositionService.List / Close / Detach | Posizioni aperte, chiusura e detach da un master. |
DealService.List | Storico deal. |
StatService.GetTradingStatistics | Statistiche di trading aggregate per dashboard e report. |
| Service · Method | Purpose |
|---|---|
ReturnsService.List | Rendimenti su periodi di tempo. |
ProfitabilityService.GetPnlsByLinks | P&L per abbonamento. |
ChartService.Get / List | Chart di profitabilità per le card master. |
| Service · Method | Purpose |
|---|---|
PlanService | Crea / recupera piani fee, ottieni il piano attivo, ottieni un piano per codice promo. |
PromoCodeService | Crea, aggiorna, elimina, elenca codici promo. |
JobService | Elenca job fee e fee pagate per investitore. |
CommissionSharingService | Revenue share con i partner — salva e leggi la configurazione di commission-sharing. |
| Method | Purpose |
|---|---|
Create | Trasferisci tra account. |
ListTransfers | Storico trasferimenti. |
ListMasterFees / ListInvestorFees | Fee associate ai trasferimenti. |
Cancel | Annulla un trasferimento. |
CanTransfer | Verifica se un trasferimento è possibile. |
| Service · Method | Purpose |
|---|---|
SettingsService.GetSettings / SetSettings | Impostazioni account PAMM. |
RolloverService.Start | Avvia il rollover. |
BalanceOperationService.List / SetCancelled (v2) | Operazioni di balance PAMM. |
| Service · Method | Purpose |
|---|---|
ChallengeService.List | Elenca i challenge attivi — base per campagne promo e gamification. |
PersonalChallengeService | Partecipazione utente e progresso personale (crea, ottieni progresso, elenca). |
StatisticsService.GetDailySummary | Riepilogo giornaliero per le classifiche dei contest. |
| Service · Method | Purpose |
|---|---|
RiskLimitService.SetLossLimit | Limite di perdita per abbonamento. |
RatioService.Get | Ratio dei simboli. |
TenantService.ListAllAvailable | Ambienti e tenant disponibili. |
CommonSettingsService.GetPlatformSettings | Impostazioni globali della piattaforma. |
MenuSettingsService.GetMenus | Struttura del menu dell’app. |
AccountSettingsService.ListBatch | Impostazioni UI per account (incluso accesso non autenticato). |
UserService.GetCurrentUser / Update | Profilo utente corrente. |
ProductService | Prodotti e valute per la creazione account. |
CountryService.List | Riferimento paesi. |
UploadService — GeneratePresignURL / ConfirmUpload / GetUpload | Avatar e media via S3 presign. |
Widget API
Uno strato pubblico ridotto per i casi in cui non serve un’app client completa — mostra la classifica, una card master o verifica un codice di abbonamento dal tuo sito marketing. Stesso contratto protobuf, meno superficie.
Panoramica dei domini public read-only usati dal widget embedded — il conteggio reale dei metodi è più ampio, e apriamo endpoint di lettura aggiuntivi su richiesta per embed custom.
| Domain · Methods | Purpose |
|---|---|
Accounts — Get, List, CheckSubscriptionCode | Card master, lista classifica per il widget, check del codice di abbonamento. |
Profitability — ReturnsService.List, ChartService.Get / List | Mini chart e rendimenti sulla pagina. |
Statistics — StatService.GetTradingStatistics | Metriche headline nel widget. |
Positions — PositionService.List | Trade aperti (lettura pubblica). |
Fees — PlanService.GetActive, GetByPromoCode | Piano attivo per il widget di abbonamento. |
UI — CommonSettingsService.GetPlatformSettings | Branding e impostazioni piattaforma nel widget. |
Tutte e tre le superfici API sono descritte in file `.proto` condivisi (proto/b2copy/broker, /frontend, /widget) ed esposte su gRPC e REST — genera client in qualsiasi linguaggio dallo stesso contratto. L’elenco completo dei metodi per superficie è molto più ampio degli esempi sopra; il riferimento completo è nella doc API e si estende su richiesta.
Supporto di integrazione hands-on
I metodi elencati sopra sono una selezione — la vera API è molto più ampia, e la estendiamo su richiesta per adattarla a CRM, area clienti e reporting. Un engineer B2COPY dedicato ti accompagna dalla prima chiamata sandbox alla prima copia live, così il broker ottiene un’integrazione pulita e su misura invece di un file `.proto` e “in bocca al lupo”.
Le tabelle in questa pagina elencano circa ~30% rappresentativi della superficie API — i metodi a cui la maggior parte dei broker arriva nella prima integrazione. Il contratto proto completo è significativamente più ampio su Broker, Frontend e Widget. Se il metodo che ti serve non è in pagina, quasi certamente esiste già — e se no, lo aggiungiamo.
Assegnato dal kickoff al go-live. Analizza i tuoi flussi dati, raccomanda le catene di metodi più pulite per il tuo scenario e resta disponibile per integrazioni successive.
Serve un metodo non in elenco? Un nuovo campo su una response esistente? Una modalità bulk per un endpoint di tooling interno? Lo aggiungiamo alla prossima release — tipicamente giorni, non trimestri.
Ambiente di staging ad alta fedeltà con master, investitori e abbonamenti di esempio, più un canale Slack / Teams privato con il team engineering per scambi rapidi durante il build.
Esaminiamo insieme endpoint, setup JWT, paginazione e rate handling prima della produzione. Cattura i casi limite prima che diventino ticket di supporto.
Raccontaci di CRM, portale client e modello di reporting — mapperemo il percorso di integrazione e mostreremo quali metodi usare (e quali estendere).
Domande frequenti
No. Le tabelle sopra mostrano una selezione rappresentativa di metodi — circa la fetta che la maggior parte dei broker usa nella prima integrazione. La vera API è significativamente più ampia sulle tre superfici (Broker / Frontend / Widget). Il riferimento completo e aggiornato è nella doc API su docs.b2copy.b2broker.com.
Sì. Se il metodo, il campo di response, il filtro o la modalità bulk che ti serve non è nel contratto attuale, lo aggiungiamo. Praticamente ogni broker che onboarding ottiene almeno un’estensione custom durante l’integrazione — turnaround tipico: giorni fino a una sola release, non trimestri. Dicci lo scenario in scoping e arriva in sandbox prima che tu scriva il codice client.
Ottieni un integration engineer B2COPY dedicato dal kickoff al go-live, un sandbox ad alta fedeltà con master / investitori / abbonamenti di esempio, un canale Slack o Teams privato con il team engineering per scambi rapidi, e una review pre-prod congiunta di endpoint, setup JWT e paginazione prima del go-live. L’obiettivo è un’integrazione su misura per lo stack, non un copia-incolla generico.
Per il percorso widget + SSO — no. Un admin di back-office può copiare lo snippet iframe e firmare JWT dal pannello admin. Per i connettori CRM predefiniti (B2Core, Nullpoint, FXBO) è un feature toggle. Integrazioni REST + gRPC più profonde richiedono tipicamente 1–3 giorni per scenario a uno sviluppatore backend.
Integra il widget iframe in 30 minuti — stesso giorno con SSO. L’attivazione CRM predefinita (B2Core / Nullpoint / FX Back Office) è anch’essa same-day. I build REST + gRPC custom richiedono 2–3 settimane end-to-end con sandbox e un integration engineer B2COPY dedicato.
Sì. Ogni metodo pubblico è descritto in file .proto condivisi (proto/b2copy/broker, .../frontend, .../widget). Le route REST e la spec OpenAPI sono generate dagli stessi file — semantica di request e response identica, scegli solo il transport adatto allo stack.
Due flussi distinti. Server-to-server: un JWT admin firmato con la tua chiave EC, scoped per tenant — usato contro la Broker API. Sessione utente: emetti un JWT esterno dal portale client, scambia via SideAuthenticate (o AuthUserWithExternalToken), poi chiama la Frontend API user-scoped. Nessuna gestione password da entrambe le parti.
Oltre 150 impostazioni del pannello di amministrazione coprono la maggior parte degli aspetti di B2COPY prima di qualsiasi sviluppo: colonne della classifica, visibilità delle statistiche, sei tipi di fee e le relative formule, limiti di rischio controllati dal broker per i master, default di visibilità account, mapping dei simboli e branding personalizzato completo (colori, loghi, temi).
Explore more
Fee di performance, management, subscription, volume, joining e profit.
Scopri di piùLimiti giornalieri, controlli di max drawdown e limiti di perdita personali.
Scopri di piùSei metodi di allocazione — proporzionale, ratio multiplier o lotto fisso.
Scopri di piùCopia i trade su server MT4, MT5, cTrader e B2Trader.
Scopri di piùWidget SSO, integrazioni CRM, API REST e gRPC.
Scopri di piùEsamineremo CRM, area clienti e back office e proporremo il percorso di integrazione adatto alla profondità engineering — widget oggi, API completa in tre settimane.
