Integración y API
Desde un iframe en 30 minutos hasta un build totalmente custom sobre REST + gRPC. La plataforma sigue siendo la fuente de verdad — usted controla UX, marca y funnel.
Demo en vivo · zero code
Sin cambios de backend, sin migración, sin rediseño. Firme un JWT de corta duración, incruste el snippet abajo en su portal de cliente — sus inversores llegan a una experiencia B2COPY totalmente tematizada sin segundo login.
Copie el snippet del iframe, péguelo en cualquier página de su portal — leaderboard, perfil de master, flujo de suscripción, todo listo para móvil.
Emita un JWT externo desde su IdP, intercámbielo vía SideAuthenticate. Sus clientes nunca ven un login separado de B2COPY.
Hereda sus colores, tipografía e idioma mediante query params y tokens CSS — listo de fábrica.
Un contrato
Cada método público se describe en archivos `.proto` compartidos y se expone por gRPC y REST. Elija el transport que encaje con su stack — las formas de request y response son idénticas.
Rutas versionadas generadas a partir de los mismos archivos .proto. Úselo para CRMs, apps web, clientes mobile y escenarios no-code — donde HTTPS sea más fácil que gRPC.
Use Connect o gRPC-Web para microservicios, gateways internos e integraciones de alto throughput donde importan la latencia y el streaming. Clientes type-safe generados por código en cualquier lenguaje.
API surfaces
Tres capas ligeras, un contrato protobuf. Úselas de forma independiente o apílelas — Broker para back office, Frontend para su propia app cliente, Widget para embeds en su sitio de marketing.
Server-to-server. Pensado para su CRM y back office — JWT de admin, listas de cuentas paginadas con datos de owner embebidos, gestión completa de suscripciones para enlaces Copier y PAMM.
Server-to-serverEn nombre del usuario. Impulsa su propio cliente web o mobile: auth, cuentas, suscripciones, deals, comisiones, transferencias, leaderboard, charts, ajustes de UI — todo desde el login hasta cerrar una posición.
User-scopedSurface pública de solo lectura. Capa reducida para bloques embebibles — master cards, charts, leaderboards y comprobaciones de código de suscripción en su sitio de marketing, sin una app cliente completa.
Public · read-onlyAuthentication
Tokens firmados con EC, con scope por tenant, rotables independientemente de las sesiones de usuario. Sin manejo de contraseñas en ningún lado de la integración.
Sus servicios de back office se autentican en Broker API con un JWT de admin firmado con su clave EC. Los tokens tienen scope por tenant y pueden rotarse sin tocar las sesiones de usuario.
Broker APIEmita un JWT externo desde su portal de cliente, intercámbielo vía SideAuthenticate o AuthUserWithExternalToken y continúe con llamadas user-scoped normales. Sin segundo login para sus clientes.
Frontend APIPrimeros pasos
Un escenario lleva a un developer 1–3 días end-to-end. Dos primeras integraciones típicas: un leaderboard en su web (Widget API) o sync de suscripciones CRM (Broker API).
01
Obtenga credenciales de staging y producción — JWT de admin para Broker API, setup SSO para Frontend API. Provisionado en un día hábil.
02
Elija gRPC (Connect o gRPC-Web) o REST. La spec OpenAPI se genera a partir de los mismos archivos .proto — elija lo que encaje con su stack.
03
Un leaderboard en su web (LeaderboardList + ChartService) o sincronización de suscripciones CRM (Broker LinkService). Un escenario lleva 1–3 días.
04
Encadene SideAuthenticate → Frontend API con el JWT del usuario. Sus clientes pasan de su portal a la experiencia B2COPY sin reautenticarse.
Tres rutas de integración
Cada ruta está documentada, soportada y usada en producción por otros brokers. Empiece hoy con el widget y añada API más profunda después — su stack no tiene que moverse.
Camino más rápido
Inserte un widget prediseñado (leaderboard, perfil de master, flujo de suscripción) en su CRM, área de cliente o página de marketing. SSO mediante JWT firmado — sus inversores llegan a B2COPY ya autenticados y con su branding.
En vivo en 30 minutos
<!-- 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
¿Ya usa B2Core, Nullpoint o FX Back Office? B2COPY está listo: active la función y el copy trading aparece en su área de cliente el mismo día. La integración con B2Core también desbloquea el IB Module para programas de partners.
Control total
Construya su propia UX de copy trading desde cero. REST para CRMs, web, mobile y no-code; gRPC para streaming en tiempo real de alto rendimiento. Generado a partir de los mismos contratos protobuf — la semántica es idéntica entre transports. Sandbox + ingeniero de integración dedicado incluidos.
2–3 semanas · sandbox + ingeniero// REST APIGET/api/v1/copy/mastersPOST/api/v1/copy/subscriptionsGET/api/v1/copy/positionsPUT/api/v1/copy/subscriptions/{id}Cobertura de un vistazo
Úselo como referencia de tamaño: su equipo CRM trabaja contra Broker API, su app cliente contra Frontend API y su sitio de marketing contra Widget API.
| Feature | Broker API Server-to-server | Frontend API En nombre del usuario | Widget API Public · read-only |
|---|---|---|---|
| Cuentas y usuarios | Reads · listas paginadas | CRUD completo + leaderboard | Reads · código de suscripción |
| Suscripciones Copier / PAMM | Gestión completa | Gestión completa | — |
| Trading e historial | — | Posiciones · deals · stats | Posiciones · stats |
| Rentabilidad y charts | — | ✓ | ✓ |
| Comisiones y códigos promo | — | ✓ | Plan activo |
| Transferencias | — | ✓ | — |
| Challenges y contests | — | ✓ | — |
| Auth / SSO | — | ✓ | — |
| Ajustes de UI y plataforma | — | ✓ | Nivel de plataforma |
Broker API
Gestión de suscripciones y lecturas de lista amigables con CRM con datos de owner embebidos en las responses. Autentica con un JWT de admin firmado con su clave EC.
Métodos representativos que la mayoría de CRMs necesitan el día uno — la surface completa de Broker API es más amplia y se amplía bajo petición para adaptarse a su modelo de back office.
Una llamada devuelve una lista paginada de cuentas de trading con filtros, ordenación y datos básicos del owner (id, email, nickname, país) — pensada para vistas de lista CRM.
| Method | Purpose |
|---|---|
List | Lista paginada de cuentas de trading con filtros, ordenación y datos de owner embebidos — para renderizado CRM de un solo golpe. |
| Method | Purpose |
|---|---|
Get | Obtener un perfil de usuario B2COPY. |
List | Lista paginada de usuarios. |
Surface de gestión completa para suscripciones Copier y PAMM — crear, actualizar, eliminar, restaurar, obtener detalles y listar con filtros.
| Method | Purpose |
|---|---|
CreateCopierLink | Crear una suscripción de copy trading (inversor → master). |
CreatePAMMLink | Crear una suscripción PAMM. |
UpdateCopierSettings | Actualizar ajustes de copying. |
UpdatePAMMSettings | Actualizar ajustes PAMM. |
Delete | Desactivar una suscripción. |
Restore | Restaurar una suscripción previamente desactivada. |
GetCopierLink / GetPAMMLink | Detalles de una suscripción concreta. |
ListCopier / ListPAMM | Listar suscripciones con filtros y paginación. |
Escenarios típicos: sincronizar suscripciones con su CRM, ejecutar operaciones bulk desde herramientas de soporte, orquestar onboarding de master / inversor en el lado del broker. ¿Necesita un método no listado — reasignación bulk, forma custom de owner-data, endpoint de tooling interno? Díganoslo en el scoping; lo añadimos en el próximo release.
Frontend API
Todo desde el login hasta cerrar una posición y pagar comisiones. Úselo para reemplazar o complementar la app cliente estándar de B2COPY — web y mobile, autenticación del usuario vía SSO con JWT de corta duración.
Una muestra representativa de la Frontend API — la surface real cubre muchos más servicios, campos y casos límite. La ampliamos bajo petición para adaptarse a la UX de su app cliente.
| Method | Purpose |
|---|---|
Login | Iniciar sesión con usuario / contraseña de la plataforma. |
AuthWithPlatformCredentials | Autenticar con credenciales de cuenta de trading. |
RefreshToken | Renovar la sesión activa. |
AuthUserWithExternalToken / AuthAccountWithExternalToken | SSO vía tokens externos — incruste B2COPY en su área de cliente sin segundo login. |
SideAuthenticate / SideLoginWithToken | Side-login fluido desde su portal de broker. |
El servicio más amplio de la API — cubre el ciclo de vida de cuentas, leaderboard público, perfiles de master, finanzas, códigos de suscripción y gestión de tipos de cuenta.
| Method | Purpose |
|---|---|
Create | Crear una cuenta B2COPY sobre una cuenta MT o cTrader existente. |
Get / Update | Leer y editar datos de cuenta. |
LeaderboardList | El leaderboard público de masters — filtros, ordenación, feed top-N. |
ListMyAccounts | Listar cuentas del usuario actual. |
ListAccountFinances | Métricas financieras por cuenta. |
SetIsInLeaderboard | Alternar si un master aparece en el leaderboard. |
CheckSubscriptionCode / GenerateSubscriptionCode / SetSubscriptionCode | Códigos de suscripción para masters cerrados (solo invitación). |
GetMasterByLogin | Buscar un master por login. |
GetAccountView / UpdateAccountView | Vista pública del perfil del master. |
SetMinimumDeposit | Depósito mínimo requerido de los suscriptores. |
ResetPassword | Restablecer la contraseña de la cuenta. |
ListAvailableAccountTypes | Tipos de cuenta disponibles en la plataforma. |
| Method | Purpose |
|---|---|
CreateCopierLink / CreatePAMMLink | Crear una suscripción en nombre del usuario. |
UpdateCopierSettings | Actualizar ajustes de copying. |
Delete / Restore | Unsubscribe y restaurar. |
ListSubscribersCopier / ListSubscriptionsCopier | Suscriptores y suscripciones Copier. |
ListSubscribersPAMM / ListSubscriptionsPAMM | Suscriptores y suscripciones PAMM. |
GetOverviewMaster / GetOverviewInvestor | Vista resumen para el rol master o inversor. |
| Service · Method | Purpose |
|---|---|
PositionService.List / Close / Detach | Posiciones abiertas, cierre y detach de un master. |
DealService.List | Historial de deals. |
StatService.GetTradingStatistics | Estadísticas de trading agregadas para dashboards e informes. |
| Service · Method | Purpose |
|---|---|
ReturnsService.List | Returns a lo largo de periodos. |
ProfitabilityService.GetPnlsByLinks | P&L por suscripción. |
ChartService.Get / List | Charts de rentabilidad para master cards. |
| Service · Method | Purpose |
|---|---|
PlanService | Crear / obtener planes de comisiones, obtener el plan activo, obtener un plan por código promo. |
PromoCodeService | Crear, actualizar, eliminar y listar códigos promo. |
JobService | Listar jobs de comisiones y comisiones pagadas por inversor. |
CommissionSharingService | Revenue share con partners — guardar y leer la configuración de commission sharing. |
| Method | Purpose |
|---|---|
Create | Transferir entre cuentas. |
ListTransfers | Historial de transferencias. |
ListMasterFees / ListInvestorFees | Comisiones asociadas a transferencias. |
Cancel | Cancelar una transferencia. |
CanTransfer | Comprobar si una transferencia es posible. |
| Service · Method | Purpose |
|---|---|
SettingsService.GetSettings / SetSettings | Ajustes de cuenta PAMM. |
RolloverService.Start | Disparar rollover. |
BalanceOperationService.List / SetCancelled (v2) | Operaciones de balance PAMM. |
| Service · Method | Purpose |
|---|---|
ChallengeService.List | Listar challenges activos — base para campañas promo y gamificación. |
PersonalChallengeService | Participación del usuario y progreso personal (crear, obtener progreso, listar). |
StatisticsService.GetDailySummary | Resumen diario para leaderboards de contests. |
| Service · Method | Purpose |
|---|---|
RiskLimitService.SetLossLimit | Límite de pérdida por suscripción. |
RatioService.Get | Ratios de símbolos. |
TenantService.ListAllAvailable | Entornos y tenants disponibles. |
CommonSettingsService.GetPlatformSettings | Ajustes globales de plataforma. |
MenuSettingsService.GetMenus | Estructura del menú de la app. |
AccountSettingsService.ListBatch | Ajustes de UI por cuenta (incluido acceso no autenticado). |
UserService.GetCurrentUser / Update | Perfil del usuario actual. |
ProductService | Productos y divisas para creación de cuentas. |
CountryService.List | Referencia de países. |
UploadService — GeneratePresignURL / ConfirmUpload / GetUpload | Avatares y medios vía S3 presign. |
Widget API
Una capa pública reducida cuando no necesita una aplicación cliente completa: mostrar el leaderboard, renderizar una master card o comprobar un código de suscripción desde su sitio de marketing. El mismo contrato protobuf, menos surface.
Esquema de dominios public read-only usados por el widget embebido — el conteo real de métodos es más amplio, y abrimos endpoints de lectura adicionales bajo petición para embeds custom.
| Domain · Methods | Purpose |
|---|---|
Accounts — Get, List, CheckSubscriptionCode | Master card, lista de leaderboard para el widget, comprobación de código de suscripción. |
Profitability — ReturnsService.List, ChartService.Get / List | Mini charts y returns en la página. |
Statistics — StatService.GetTradingStatistics | Métricas headline en el widget. |
Positions — PositionService.List | Trades abiertos (public read). |
Fees — PlanService.GetActive, GetByPromoCode | Plan activo para el widget de suscripción. |
UI — CommonSettingsService.GetPlatformSettings | Branding y ajustes de plataforma dentro del widget. |
Las tres API surfaces se describen en archivos `.proto` compartidos (proto/b2copy/broker, /frontend, /widget) y se exponen por gRPC y REST: genere clientes en cualquier lenguaje desde el mismo contrato. La lista completa de métodos por surface es mucho mayor que los ejemplos anteriores; la referencia completa está en la documentación de la API y se amplía bajo petición.
Soporte de integración hands-on
Los métodos listados arriba son una selección — la API real es mucho más amplia, y la ampliamos bajo petición para encajar con su CRM, área de cliente y modelo de reporting. Un ingeniero B2COPY dedicado acompaña desde la primera llamada al sandbox hasta el primer copy en vivo, para que el broker obtenga una integración limpia y ajustada en lugar de un archivo `.proto` y mucha suerte.
Las tablas de esta página listan un ~30 % representativo de la API surface — métodos a los que la mayoría de brokers acude en la primera integración. El contrato proto completo es significativamente mayor en Broker, Frontend y Widget. Si el método que necesita no está en la página, casi seguro ya existe — y si no, lo añadimos.
Asignado desde el kickoff hasta el go-live. Revisa su flujo de datos, recomienda las cadenas de métodos más limpias para su escenario y permanece disponible para integraciones posteriores.
¿Necesita un método que no está listado? ¿Un campo nuevo en una response existente? ¿Un bulk-mode para un endpoint de tooling interno? Lo añadimos en el próximo release — típicamente días, no trimestres.
Entorno de staging full-fidelity con masters, inversores y suscripciones de muestra, más un canal privado de Slack / Teams con el equipo de ingeniería para ida y vuelta rápida durante el build.
Revisamos juntos sus endpoints, setup JWT, paginación y rate handling antes de pasar a producción. Detecta edge cases antes de que se conviertan en tickets de soporte.
Cuéntenos sobre su CRM, portal de cliente y modelo de reporting — mapearemos la ruta de integración y mostraremos qué métodos usar (y cuáles ampliar).
Preguntas frecuentes
No. Las tablas anteriores muestran una selección representativa de métodos — aproximadamente el slice que la mayoría de brokers usa en su primera integración. La API real es significativamente más amplia en las tres surfaces (Broker / Frontend / Widget). La referencia completa y actualizada está en la documentación de la API en docs.b2copy.b2broker.com.
Sí. Si el método, campo de response, filtro o bulk-mode que necesita no está en el contrato actual, lo añadimos. Prácticamente cada broker que onboardeamos obtiene al menos una extensión custom durante la integración — el turnaround típico es de días a un solo release, no trimestres. Cuéntenos el escenario en el scoping y llega al sandbox antes de que escriba código cliente contra él.
Obtiene un ingeniero de integración B2COPY dedicado del kickoff al go-live, un sandbox full-fidelity con masters / inversores / suscripciones de muestra, un canal privado de Slack o Teams con el equipo de ingeniería para ida y vuelta rápida, y una revisión conjunta pre-prod de endpoints, setup JWT y paginación antes de publicar. El objetivo es una integración que encaje con su stack, no un copy-paste genérico.
Para la ruta widget + SSO — no. Un admin de back office puede copiar el snippet del iframe y firmar JWTs desde el panel. En conectores CRM prediseñados (B2Core, Nullpoint, FXBO) es un feature toggle. Integraciones REST + gRPC más profundas suelen llevar a un backend developer 1–3 días por escenario.
Incruste el widget iframe en 30 minutos — el mismo día con SSO. La activación CRM prediseñada (B2Core / Nullpoint / FX Back Office) también es same-day. Builds custom completos sobre REST + gRPC llevan 2–3 semanas end-to-end con sandbox e ingeniero de integración B2COPY dedicado.
Sí. Cada método público se describe en archivos .proto compartidos (proto/b2copy/broker, .../frontend, .../widget). Las rutas REST y la spec OpenAPI se generan a partir de los mismos archivos — la semántica de request y response es idéntica; solo elige el transport que encaje con su stack.
Dos flujos distintos. Server-to-server: JWT de admin firmado con su clave EC, con scope por tenant — contra Broker API. Sesión de usuario: emita un JWT externo desde su portal de cliente, intercámbielo vía SideAuthenticate (o AuthUserWithExternalToken) y llame a Frontend API con scope de usuario. Sin manejo de contraseñas en ningún lado.
Más de 150 ajustes del panel de administración cubren la mayoría de aspectos de B2COPY antes de necesitar desarrollo: columnas del leaderboard, visibilidad de estadísticas, seis tipos de comisiones y sus fórmulas, límites de riesgo controlados por el broker para masters, visibilidad de cuentas por defecto, mapeo de símbolos y branding personalizado completo (colores, logos, temas).
Explore more
Comisiones de performance, management, suscripción, volumen, joining y profit.
Más informaciónLímites diarios, controles de max drawdown y límites de pérdida personales.
Más informaciónSeis métodos de asignación — proporcional, ratio multiplier o lote fijo.
Más informaciónCopie trades entre servidores MT4, MT5, cTrader y B2Trader.
Más informaciónWidget SSO, integraciones CRM, APIs REST y gRPC.
Más informaciónRevisaremos su CRM, área de cliente y back office y propondremos la ruta de integración que encaje con su profundidad de ingeniería — widget hoy, API completa en tres semanas.
