Интеграция и API
От 30-минутного внедрения iframe до полностью кастомной интеграции на REST + gRPC. Платформа остаётся единым источником данных, а вы контролируете UX, бренд и воронку.
Демо в реальном времени · без кода
Без изменений backend, миграций и редизайна. Подпишите краткосрочный JWT, вставьте сниппет ниже в клиентский портал — ваши инвесторы попадут в полностью брендированную среду B2COPY без второго входа.
Скопируйте iframe-сниппет, вставьте на любую страницу портала — лидерборд, профиль мастера, поток подписки, всё mobile-ready.
Выпустите внешний JWT из своего IdP и обменяйте его через SideAuthenticate. Ваши клиенты никогда не увидят отдельный вход в B2COPY.
Наследует ваши цвета, типографику и язык через query-параметры и CSS-токены — сразу после подключения.
Один контракт
Каждый публичный метод описан в общих файлах `.proto` и доступен через gRPC и REST. Выберите транспорт, подходящий вашему стеку, — структуры запросов и ответов идентичны.
Версионированные маршруты, сгенерированные из тех же файлов .proto. Используйте для CRM, веб-приложений, мобильных клиентов и no-code сценариев — везде, где HTTPS удобнее gRPC.
Используйте Connect или gRPC-Web для микросервисов, внутренних шлюзов и высокопроизводительных интеграций, где важны задержка и стриминг. Типобезопасные, сгенерированные из кода клиенты на любом языке.
Поверхности API
Три лёгких уровня, один protobuf-контракт. Используйте их по отдельности или вместе: Broker для бэк-офиса, Frontend для собственного клиентского приложения, Widget для встраиваний на маркетинговом сайте.
Сервер-сервер. Создано для вашей CRM и бэк-офиса: административный JWT, пагинированные списки счетов со встроенными данными владельца, полное управление подписками для связей копировщиков и PAMM.
Сервер-серверОт имени пользователя. Основа вашего веб- или мобильного клиента: аутентификация, счета, подписки, сделки, комиссии, переводы, рейтинг, графики, настройки UI — всё от входа до закрытия позиции.
В контексте пользователяПубличный интерфейс только для чтения. Облегчённый слой для встраиваемых блоков: карточек мастеров, графиков, рейтингов и проверки кодов подписки на маркетинговом сайте без полноценного клиентского приложения.
Публичный · только для чтенияAuthentication
Токены с подписью EC, ограниченные уровнем арендатора и ротируемые независимо от пользовательских сессий. Обработка паролей не требуется ни на одной стороне интеграции.
Ваши сервисы бэк-офиса аутентифицируются в Broker API с помощью административного JWT, подписанного вашим EC-ключом. Токены ограничены уровнем арендатора и могут ротироваться без затрагивания пользовательских сессий.
Broker APIВыпустите внешний JWT из клиентского портала, обменяйте его через SideAuthenticate или AuthUserWithExternalToken, затем выполняйте обычные вызовы в контексте пользователя. Вашим клиентам не потребуется второй вход.
Frontend APIНачало работы
Один сценарий занимает у разработчика 1–3 дня от начала до конца. Две типичные первые интеграции: рейтинг на вашем сайте (Widget API) или синхронизация подписок с CRM (Broker API).
01
Получите учётные данные для staging и продакшена: административный JWT для Broker API и настройку SSO для Frontend API. Предоставляются в течение одного рабочего дня.
02
Выберите gRPC (Connect или gRPC-Web) или REST. OpenAPI-спецификация генерируется из тех же .proto файлов — берите то, что подходит вашему стеку.
03
Лидерборд на сайте (LeaderboardList + ChartService) или синхронизация подписок с CRM (Broker LinkService). Один сценарий занимает 1–3 дня.
04
Свяжите SideAuthenticate → Frontend API с JWT пользователя. Клиенты переходят из вашего портала в опыт на B2COPY без повторной аутентификации.
Три пути интеграции
Каждый путь документирован, поддерживается и уже используется другими брокерами в продакшене. Начните с виджета сегодня, затем подключайте более глубокую API-интеграцию — переносить стек не потребуется.
Самый быстрый путь
Добавьте готовый виджет (рейтинг, профиль мастера, сценарий подписки) в CRM, личный кабинет или маркетинговую страницу. SSO через подписанный JWT — инвесторы попадают в 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 Module
Nullpoint CRM
Ready
FX Back Office
ReadyБез разработки
Уже работаете на B2Core, Nullpoint или FX Back Office? B2COPY готов — включите функцию, и копитрейдинг появится в клиентской зоне в тот же день. Интеграция с B2Core также открывает IB Module для партнёрских программ.
Полный контроль
Соберите собственный UX копитрейдинга с нуля. REST для CRM, web, mobile и no-code; gRPC для высокопроизводительного стриминга в реальном времени. Генерация из тех же protobuf-контрактов — семантика идентична между транспортами. Sandbox + выделенный инженер по интеграции включены.
2–3 недели · sandbox + инженер// 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 Сервер-сервер | Frontend API От имени пользователя | Widget API Публичный · только для чтения |
|---|---|---|---|
| Счета и пользователи | Чтение · пагинированные списки | Полный CRUD + рейтинг | Чтение · код подписки |
| Подписки Copier / PAMM | Полное управление | Полное управление | — |
| Торговля и история | — | Позиции · сделки · статистика | Позиции · статистика |
| Доходность и графики | — | ✓ | ✓ |
| Комиссии и промокоды | — | ✓ | Активный план |
| Переводы | — | ✓ | — |
| Челленджи и конкурсы | — | ✓ | — |
| Auth / SSO | — | ✓ | — |
| Настройки UI и платформы | — | ✓ | На уровне платформы |
Broker API
Управление подписками и удобное для CRM чтение списков со встроенными данными владельца в ответах. Аутентификация административным JWT, подписанным вашим EC-ключом.
Репрезентативные методы, необходимые большинству CRM в первый день: полный набор Broker API шире и расширяется по запросу в соответствии с вашей моделью бэк-офиса.
Один вызов возвращает пагинированный список торговых счетов с фильтрами, сортировкой и базовыми данными владельца (id, email, никнейм, страна) — для списков в CRM.
| Method | Purpose |
|---|---|
Список | Пагинированный список торговых счетов с фильтрами, сортировкой и встроенными данными владельца — для единоразового отображения в CRM. |
| Method | Purpose |
|---|---|
Получить | Получить профиль пользователя B2COPY. |
Список | Пагинированный список пользователей. |
Полный набор управления подписками копировщиков и PAMM: создание, обновление, удаление, восстановление, получение сведений и просмотр с фильтрами.
| Method | Purpose |
|---|---|
CreateCopierLink | Создать подписку на Copy Trading (инвестор → мастер). |
CreatePAMMLink | Создать PAMM-подписку. |
UpdateCopierSettings | Обновить настройки копирования. |
UpdatePAMMSettings | Обновить настройки PAMM. |
Удалить | Отключить подписку. |
Восстановить | Восстановить ранее отключённую подписку. |
GetCopierLink / GetPAMMLink | Сведения по отдельной подписке. |
ListCopier / ListPAMM | Список подписок с фильтрами и пагинацией. |
Типичные сценарии: синхронизация подписок с CRM, массовые операции из инструментов поддержки, оркестрация онбординга мастеров и инвесторов на стороне брокера. Нужен метод, которого нет в списке, — массовое переназначение, кастомная структура данных владельца, endpoint для внутреннего инструмента? Сообщите нам при определении объёма работ: мы добавим его в следующем релизе.
Frontend API
Всё — от входа до закрытия позиции и выплаты комиссий. Используйте его вместо или в дополнение к стандартному клиентскому приложению B2COPY: подходит для веба и мобильных устройств, аутентифицирует пользователя через SSO с краткосрочным JWT.
Репрезентативный срез Frontend API — реальная поверхность покрывает гораздо больше сервисов, полей и edge cases. Мы расширяем её по запросу под UX вашего клиентского приложения.
| Method | Purpose |
|---|---|
Вход | Войдите с именем пользователя и паролем платформы. |
AuthWithPlatformCredentials | Аутентификация по учётным данным торгового счёта. |
RefreshToken | Обновить активную сессию. |
AuthUserWithExternalToken / AuthAccountWithExternalToken | SSO через внешние токены — встройте B2COPY в клиентский кабинет без второго входа. |
SideAuthenticate / SideLoginWithToken | Бесшовный вход со стороны брокерского портала. |
Самый широкий сервис в API: охватывает жизненный цикл счёта, публичный рейтинг, профили мастеров, финансы, коды подписки и управление типами счетов.
| Method | Purpose |
|---|---|
Создать | Создать счёт B2COPY на базе существующего счёта MT или cTrader. |
Получить / обновить | Чтение и редактирование данных счёта. |
LeaderboardList | Публичный рейтинг мастеров — фильтры, сортировка, лента top-N. |
ListMyAccounts | Список счетов, принадлежащих текущему пользователю. |
ListAccountFinances | Финансовые показатели по каждому счёту. |
SetIsInLeaderboard | Переключите отображение мастера в рейтинге. |
CheckSubscriptionCode / GenerateSubscriptionCode / SetSubscriptionCode | Коды подписки для закрытых мастеров (только по приглашению). |
GetMasterByLogin | Найти мастера по логину. |
GetAccountView / UpdateAccountView | Публичный профиль мастера. |
SetMinimumDeposit | Минимальный депозит для подписчиков. |
ResetPassword | Сбросить пароль счёта. |
ListAvailableAccountTypes | Типы счетов, доступные на платформе. |
| Method | Purpose |
|---|---|
CreateCopierLink / CreatePAMMLink | Создать подписку от имени пользователя. |
UpdateCopierSettings | Обновить настройки копирования. |
Удалить / восстановить | Отменить подписку и восстановить. |
ListSubscribersCopier / ListSubscriptionsCopier | Подписчики и подписки Copier. |
ListSubscribersPAMM / ListSubscriptionsPAMM | Подписчики и подписки PAMM. |
GetOverviewMaster / GetOverviewInvestor | Сводный вид для роли мастера или инвестора. |
| Сервис · метод | Purpose |
|---|---|
PositionService.List / Close / Detach | Открытые позиции, закрытие и отключение от мастера. |
DealService.List | История сделок. |
StatService.GetTradingStatistics | Агрегированная торговая статистика для дашбордов и отчётов. |
| Сервис · метод | Purpose |
|---|---|
ReturnsService.List | Доходность за периоды. |
ProfitabilityService.GetPnlsByLinks | P&L по подписке. |
ChartService.Get / List | Графики доходности для карточек мастеров. |
| Сервис · метод | Purpose |
|---|---|
PlanService | Создать / получить тарифные планы, получить активный план, получить план по промокоду. |
PromoCodeService | Создавать, обновлять, удалять и просматривать промокоды. |
JobService | Список задач по комиссиям и уплаченных комиссий по каждому инвестору. |
CommissionSharingService | Доля дохода с партнёрами — сохранение и получение настроек распределения комиссий. |
| Method | Purpose |
|---|---|
Создать | Перевод между счетами. |
ListTransfers | История переводов. |
ListMasterFees / ListInvestorFees | Комиссии, связанные с переводами. |
Cancel | Отменить перевод. |
CanTransfer | Проверить, возможен ли перевод. |
| Сервис · метод | Purpose |
|---|---|
SettingsService.GetSettings / SetSettings | Настройки PAMM-счёта. |
RolloverService.Start | Запустить ролловер. |
BalanceOperationService.List / SetCancelled (v2) | Операции с балансом PAMM. |
| Сервис · метод | Purpose |
|---|---|
ChallengeService.List | Список активных челленджей — основа для промокампаний и геймификации. |
PersonalChallengeService | Участие пользователя и персональный прогресс (создание, получение прогресса, список). |
StatisticsService.GetDailySummary | Ежедневная сводка для рейтингов конкурса. |
| Сервис · метод | 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 presign. |
Widget API
Урезанный публичный слой для случаев, когда полноценное клиентское приложение не нужно — показать лидерборд, карточку мастера или проверить код подписки с маркетингового сайта. Тот же protobuf-контракт, меньшая поверхность.
Структура публичных доменов только для чтения, используемых встроенным виджетом: фактическое количество методов больше, а дополнительные read-endpoint мы открываем по запросу для кастомных встраиваний.
| Домен · методы | Purpose |
|---|---|
Accounts — Get, List, CheckSubscriptionCode | Карточка мастера, список рейтинга для виджета, проверка кода подписки. |
Profitability — ReturnsService.List, ChartService.Get / List | Мини-графики и доходность на странице. |
Statistics — StatService.GetTradingStatistics | Ключевые показатели в виджете. |
Positions — PositionService.List | Открытые сделки (публичное чтение). |
Fees — PlanService.GetActive, GetByPromoCode | Активный план для виджета подписки. |
UI — CommonSettingsService.GetPlatformSettings | Брендинг и настройки платформы внутри виджета. |
Все три поверхности API описаны в общих `.proto` файлах (proto/b2copy/broker, /frontend, /widget) и доступны через gRPC и REST — генерируйте клиенты на любом языке из одного контракта. Полный список методов на каждой поверхности значительно шире примеров выше; полная справка — в API docs и расширяется по запросу.
Практическая поддержка интеграции
Перечисленные выше методы — лишь выборка: фактический API намного шире, и мы расширяем его по запросу под вашу CRM, клиентский кабинет и модель отчётности. Выделенный инженер B2COPY сопровождает вас от первого вызова в песочнице до первой живой копии, поэтому брокер получает чистую интеграцию, адаптированную под его задачи, а не только файл `.proto` и пожелание удачи.
Таблицы на этой странице показывают репрезентативные ~30% API — методы, к которым большинство брокеров обращается в первой интеграции. Полный proto-контракт существенно больше и охватывает Broker, Frontend и Widget. Если нужного метода нет на странице, он почти наверняка уже существует — а если нет, мы его добавим.
Назначен с kickoff до go-live. Разбирает ваш data flow, рекомендует самые чистые цепочки методов под ваш сценарий и остаётся на связи для последующих интеграций.
Нужен метод, которого нет в списке? Новое поле в существующем ответе? Массовый режим для endpoint внутреннего инструмента? Мы добавим его в следующем релизе — обычно за дни, а не кварталы.
Полнофункциональная staging-среда с примерами мастеров, инвесторов и подписок, а также закрытый канал Slack / Teams с инженерной командой для оперативного взаимодействия во время разработки.
Перед запуском в продакшен мы вместе прорабатываем ваши endpoint, настройку JWT, пагинацию и обработку лимитов запросов. Это помогает выявить пограничные случаи до того, как они станут обращениями в поддержку.
Расскажите нам о вашей CRM, клиентском портале и модели отчётности — мы определим путь интеграции и покажем, какие методы использовать и какие расширить.
Часто задаваемые вопросы
Нет. Таблицы выше показывают репрезентативную выборку методов — примерно тот набор, который большинство брокеров использует в первой интеграции. Фактический API существенно шире на всех трёх уровнях (Broker / Frontend / Widget). Полная и актуальная справка доступна в API-документации на docs.b2copy.b2broker.com.
Да. Если нужного вам метода, поля ответа, фильтра или массового режима нет в текущем контракте, мы его добавим. Практически каждый брокер, которого мы подключаем, получает хотя бы одно кастомное расширение во время интеграции — обычно это занимает от нескольких дней до одного релиза, а не кварталы. Опишите сценарий на этапе определения объёма работ, и он появится в песочнице до того, как вы начнёте писать клиентский код.
Вы получаете выделенного инженера B2COPY от старта до запуска, полнофункциональную песочницу с примерами мастеров, инвесторов и подписок, закрытый канал Slack или Teams с инженерной командой для оперативного взаимодействия и совместную проверку ваших endpoint, настройки JWT и пагинации перед выходом в продакшен. Цель — интеграция, соответствующая вашему стеку, а не универсальное копирование-вставка.
Для сценария с виджетом + SSO — нет. Администратор бэк-офиса может скопировать iframe-сниппет и подписывать JWT через административную панель. Для готовых CRM-коннекторов (B2Core, Nullpoint, FXBO) достаточно включить функцию. Более глубокая интеграция REST + gRPC обычно занимает у backend-разработчика 1–3 дня на сценарий.
Встройте iframe-виджет за 30 минут — с SSO в тот же день. Активация готовых CRM-коннекторов (B2Core / Nullpoint / FX Back Office) также выполняется в тот же день. Полная кастомная интеграция REST + gRPC занимает 2–3 недели от начала до конца с песочницей и выделенным инженером B2COPY.
Да. Каждый публичный метод описан в общих файлах .proto (proto/b2copy/broker, .../frontend, .../widget). REST-маршруты и спецификация OpenAPI генерируются из тех же файлов — семантика запросов и ответов идентична, вы просто выбираете транспорт, подходящий вашему стеку.
Два разных потока. Сервер-сервер: административный JWT, подписанный вашим EC-ключом и ограниченный уровнем арендатора, используется с Broker API. Пользовательская сессия: выпустите внешний JWT из клиентского портала, обменяйте через SideAuthenticate (или AuthUserWithExternalToken), затем выполняйте вызовы Frontend API в контексте пользователя. Обработка паролей не требуется ни на одной стороне.
150+ настроек админ-панели покрывают большую часть B2COPY без разработки: колонки лидерборда, видимость статистики, шесть типов комиссий и их формулы, риск-лимиты для мастеров под контролем брокера, видимость счетов по умолчанию, маппинг символов и полный кастомный брендинг (цвета, логотипы, темы).
Explore more
Комиссии за результат, управление, подписку, объём, подключение и прибыль.
ПодробнееДневные лимиты, контроль максимальной просадки и персональные лимиты убытков.
ПодробнееШесть методов распределения: пропорциональный, множитель соотношения или фиксированный лот.
ПодробнееКопируйте сделки между серверами MT4, MT5, cTrader и B2Trader.
ПодробнееWidget SSO, CRM-интеграции, REST и gRPC API.
ПодробнееМы изучим вашу CRM, клиентский кабинет и бэк-офис и предложим путь интеграции, соответствующий уровню вашей инженерной зрелости: виджет сегодня, полный API через три недели.
