계정
b2copy.broker.accounts.v1.account한 번의 호출로 필터, 정렬 및 기본 소유자 데이터(id, 이메일, 닉네임, 국가)가 포함된 페이지네이션 트레이딩 계정 목록을 반환합니다. CRM 목록 보기에 최적화되었습니다.
| Method | Purpose |
|---|---|
목록 | 필터, 정렬 및 내장 소유자 데이터가 포함된 페이지네이션 트레이딩 계정 목록 — 일회성 CRM 렌더링용. |
통합 및 API
몇 달이 아닌 몇 분 만에 카피 트레이딩 삽입
30분 iframe 삽입부터 REST + gRPC 기반의 완전 맞춤형 구축까지 제공합니다. 플랫폼은 단일 진실 공급원으로 유지되며, 귀사는 UX, 브랜드 및 퍼널을 제어합니다.
- 30분
- 임베디드 위젯 — 스니펫을 복사해 붙여넣으면 바로 배포됩니다.
- 당일
- 사전 구축된 CRM 활성화 — 기능 스위치를 켜기만 하세요.
- 2–3주
- 전체 REST + gRPC 구축 — 샌드박스 + 전담 엔지니어.
- 3개 표면
- Broker · Frontend · Widget — 하나의 protobuf 계약.
라이브 데모 · 코드 불필요
Iframe 하나로 30분 내 시작
백엔드 변경, 마이그레이션, 재설계가 필요하지 않습니다. 단기 JWT에 서명하고 아래 스니펫을 클라이언트 포털에 삽입하세요. 투자자는 두 번째 로그인 없이 완전한 테마의 B2COPY 환경으로 이동합니다.
yourbroker.com/copy-trading
30분 내 시작
iframe 스니펫을 복사해 포털의 아무 페이지에나 붙여넣으세요 — 리더보드, 마스터 프로필, 구독 플로우, 모두 모바일 대응.
SSO — 두 번째 로그인 없음
IdP에서 외부 JWT를 발급하고 SideAuthenticate를 통해 교환하세요. 클라이언트는 별도의 B2COPY 로그인을 볼 필요가 없습니다.
브랜드에 맞춘 테마
쿼리 파라미터와 CSS 토큰을 통해 귀사의 색상, 타이포그래피 및 언어를 기본적으로 상속합니다.
하나의 계약
두 가지 전송 방식, 동일한 의미
모든 공개 메서드는 공통 `.proto` 파일에 정의되어 있으며 gRPC와 REST 모두로 제공됩니다. 스택에 맞는 전송 방식을 선택하세요. 요청 및 응답 형식은 동일합니다.
REST · JSON Over HTTPS
동일한 .proto 파일에서 생성된 버전 관리 라우트입니다. CRM, 웹 앱, 모바일 클라이언트 및 노코드 시나리오 등 HTTPS가 gRPC보다 편리한 모든 곳에서 사용하세요.
Grpc · Native Protobuf
지연 시간과 스트리밍이 중요한 마이크로서비스, 내부 게이트웨이 및 고처리량 통합에는 Connect 또는 gRPC-Web을 사용하세요. 모든 언어에서 타입 안전성과 코드 생성 클라이언트를 제공합니다.
API 표면
잠재고객에 맞는 인터페이스 선택
세 개의 경량 계층, 하나의 protobuf 계약. 독립적으로 사용하거나 함께 구성하세요 — 백오피스용 Broker, 자체 클라이언트 앱용 Frontend, 마케팅 사이트 임베드용 Widget.
Broker API
서버 간 연결. CRM 및 백오피스를 위해 설계되었습니다 — 관리자 JWT, 내장 소유자 데이터가 포함된 페이지네이션 계정 목록, 카피 트레이더 및 PAMM 링크의 전체 구독 관리.
서버 간Frontend API
사용자를 대신합니다. 자체 웹 또는 모바일 클라이언트를 구동합니다. 인증, 계정, 구독, 거래, 수수료, 이체, 리더보드, 차트, UI 설정 등 로그인부터 포지션 청산까지 모든 기능을 제공합니다.
사용자 범위Widget API
공개 읽기 전용 인터페이스. 전체 클라이언트 앱 없이 마케팅 사이트의 마스터 카드, 차트, 리더보드 및 구독 코드 확인을 위한 간소화된 계층입니다.
공개 · 읽기 전용Authentication
JWT 기반, 포털로 원활한 SSO
테넌트별로 범위가 지정된 EC 서명 토큰은 사용자 세션과 독립적으로 교체됩니다. 통합 양측에서 비밀번호를 처리할 필요가 없습니다.
서버 간 JWT
백오피스 서비스는 EC 키로 서명한 관리자 JWT를 사용해 Broker API에 인증합니다. 토큰은 테넌트 범위로 지정되며 사용자 세션에 영향을 주지 않고 교체할 수 있습니다.
Broker APISSO를 통한 사용자 세션
클라이언트 포털에서 외부 JWT를 발급한 뒤 SideAuthenticate 또는 AuthUserWithExternalToken을 통해 교환하고, 일반 사용자 범위 호출을 계속하세요. 클라이언트에게 두 번째 로그인이 필요하지 않습니다.
Frontend API시작하기
액세스부터 첫 작동 시나리오까지 네 단계
하나의 시나리오는 처음부터 끝까지 개발자 기준 1~3일이 소요됩니다. 대표적인 첫 통합 두 가지는 웹사이트 리더보드(Widget API) 또는 CRM 구독 동기화(Broker API)입니다.
01
액세스 요청
스테이징 및 프로덕션 자격 증명을 받으세요 — Broker API용 관리자 JWT, Frontend API용 SSO 설정. 영업일 기준 하루 내 프로비저닝됩니다.
02
전송 방식 선택
gRPC(Connect 또는 gRPC-Web) 또는 REST를 선택하세요. OpenAPI 스펙은 동일 .proto 파일에서 생성됩니다 — 스택에 맞는 것을 고르세요.
03
하나의 시나리오로 시작
웹사이트의 리더보드(LeaderboardList + ChartService) 또는 CRM 구독 동기화(Broker LinkService). 한 시나리오는 1–3일이 걸립니다.
04
포털에 삽입
사용자 JWT로 SideAuthenticate → Frontend API를 연결하세요. 고객은 재인증 없이 포털에서 B2COPY 경험으로 이동합니다.
세 가지 통합 경로
통합 깊이 선택
모든 경로는 문서화되어 지원되며 다른 브로커가 실제 운영에서 사용하고 있습니다. 오늘 위젯으로 시작하고 이후 더 깊은 API 통합을 추가하세요. 기존 스택을 옮길 필요가 없습니다.
가장 빠른 경로
임베디드 위젯 + SSO
사전 구축된 위젯(리더보드, 마스터 프로필, 구독 흐름)을 CRM, 클라이언트 영역 또는 마케팅 페이지에 삽입하세요. 서명된 JWT를 통한 SSO로 투자자는 이미 인증되고 브랜드 테마가 적용된 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개발 불필요
사전 구축된 CRM 커넥터
이미 B2Core, Nullpoint 또는 FX Back Office를 운영 중이신가요? B2COPY는 준비되어 있습니다 — 기능을 켜면 당일 고객 영역에 카피 트레이딩이 나타납니다. B2Core 연동은 파트너 프로그램을 위한 IB Module도 잠금 해제합니다.
B2Core 전용: IB Module과의 네이티브 통합 — 파트너는 모든 카피 거래에서 자동으로 커미션을 얻습니다.
당일 활성화완전한 제어
REST 및 Grpc API
처음부터 나만의 카피 트레이딩 UX를 구축하세요. CRM·웹·모바일·노코드용 REST; 고성능 실시간 스트리밍용 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}한눈에 보는 범위
어떤 API 인터페이스가 어떤 영역을 담당하나요
규모 산정 기준으로 활용하세요. CRM 팀은 Broker API, 클라이언트 앱은 Frontend API, 마케팅 사이트는 Widget API를 사용합니다.
| Feature | Broker API 서버 간 | Frontend API 사용자 대신 | Widget API 공개 · 읽기 전용 |
|---|---|---|---|
| 계정 및 사용자 | 조회 · 페이지네이션 목록 | 전체 CRUD + 리더보드 | 조회 · 구독 코드 |
| Copier / PAMM 구독 | 전체 관리 | 전체 관리 | — |
| 트레이딩 및 내역 | — | 포지션 · 거래 · 통계 | 포지션 · 통계 |
| 수익성 및 차트 | — | ✓ | ✓ |
| 수수료 및 프로모션 코드 | — | ✓ | 활성 플랜 |
| 이체 | — | ✓ | — |
| 챌린지 및 콘테스트 | — | ✓ | — |
| Auth / SSO | — | ✓ | — |
| UI 및 플랫폼 설정 | — | ✓ | 플랫폼 수준 |
Broker API
CRM을 위한 서버 간 연결
응답에 소유자 데이터가 포함된 구독 관리 및 CRM 친화적 목록 조회. EC 키로 서명한 관리자 JWT로 인증합니다.
대부분의 CRM이 첫날 필요로 하는 대표적인 메서드입니다. 전체 Broker API 인터페이스는 더 광범위하며, 백오피스 모델에 맞춰 요청 시 확장됩니다.
사용자
b2copy.broker.accounts.v1.user| Method | Purpose |
|---|---|
조회 | B2COPY 사용자 프로필을 조회합니다. |
목록 | 페이지네이션 사용자 목록. |
구독(링크)
b2copy.broker.accounts.v1.link카피 트레이더 및 PAMM 구독을 위한 전체 관리 인터페이스 — 생성, 업데이트, 삭제, 복원, 세부 조회 및 필터 목록 조회.
| Method | Purpose |
|---|---|
CreateCopierLink | 카피 트레이딩 구독을 생성합니다(투자자 → 마스터). |
CreatePAMMLink | PAMM 구독을 생성합니다. |
UpdateCopierSettings | 카피 설정 업데이트. |
UpdatePAMMSettings | PAMM 설정 업데이트. |
삭제 | 구독을 비활성화합니다. |
복원 | 이전에 비활성화된 구독을 복원합니다. |
GetCopierLink / GetPAMMLink | 단일 구독의 세부 정보. |
ListCopier / ListPAMM | 필터 및 페이지네이션으로 구독 목록을 조회합니다. |
일반적인 시나리오: CRM으로 구독 동기화, 지원 도구에서 대량 작업 실행, 브로커 측에서 마스터 / 투자자 온보딩 오케스트레이션. 목록에 없는 메서드가 필요하신가요 — 대량 재할당, 맞춤 소유자 데이터 형식, 내부 도구 엔드포인트? 스코핑 중에 알려 주세요. 다음 릴리스에 추가합니다.
Frontend API
자체 클라이언트 애플리케이션
로그인부터 포지션 청산과 수수료 지급까지 모든 기능을 제공합니다. 표준 B2COPY 클라이언트 앱을 대체하거나 보완할 수 있으며 웹과 모바일에서 작동하고, 단기 JWT 기반 SSO로 사용자를 인증합니다.
Frontend API의 대표 일부 — 실제 표면은 훨씬 더 많은 서비스, 필드, edge case를 다룹니다. 클라이언트 앱 UX에 맞게 요청 시 확장합니다.
Authentication
auth.v1.authn| Method | Purpose |
|---|---|
로그인 | 플랫폼 사용자 이름 / 비밀번호로 로그인. |
AuthWithPlatformCredentials | 거래 계정 자격 증명으로 인증합니다. |
RefreshToken | 활성 세션을 새로 고칩니다. |
AuthUserWithExternalToken / AuthAccountWithExternalToken | 외부 토큰 기반 SSO — 두 번째 로그인 없이 클라이언트 영역에 B2COPY를 삽입하세요. |
SideAuthenticate / SideLoginWithToken | 브로커 포털에서 원활한 측면 로그인. |
계정
accounts.v1.accountAPI에서 가장 광범위한 서비스로, 계정 라이프사이클, 공개 리더보드, 마스터 프로필, 금융, 구독 코드 및 계정 유형 관리를 포괄합니다.
| Method | Purpose |
|---|---|
생성 | 기존 MT 또는 cTrader 계정 기반의 B2COPY 계정을 생성합니다. |
조회 / 업데이트 | 계정 데이터를 읽고 편집합니다. |
LeaderboardList | 공개 마스터 리더보드 — 필터, 정렬, 상위 N 피드. |
ListMyAccounts | 현재 사용자가 소유한 계정 목록. |
ListAccountFinances | 계정별 재무 지표. |
SetIsInLeaderboard | 마스터가 리더보드에 표시되는지 전환합니다. |
CheckSubscriptionCode / GenerateSubscriptionCode / SetSubscriptionCode | 비공개(초대 전용) 마스터용 구독 코드. |
GetMasterByLogin | 로그인으로 마스터를 조회합니다. |
GetAccountView / UpdateAccountView | 마스터의 공개 프로필 보기. |
SetMinimumDeposit | 구독자에게 필요한 최소 예치금. |
ResetPassword | 계정 비밀번호를 재설정합니다. |
ListAvailableAccountTypes | 플랫폼에서 사용 가능한 계정 유형. |
구독(링크)
accounts.v1.link| Method | Purpose |
|---|---|
CreateCopierLink / CreatePAMMLink | 사용자를 대신하여 구독을 생성합니다. |
UpdateCopierSettings | 카피 설정 업데이트. |
삭제 / 복원 | 구독 해지 및 복원. |
ListSubscribersCopier / ListSubscriptionsCopier | Copier 구독자 및 구독. |
ListSubscribersPAMM / ListSubscriptionsPAMM | PAMM 구독자 및 구독. |
GetOverviewMaster / GetOverviewInvestor | 마스터 또는 투자자 역할의 요약 보기. |
트레이딩 및 통계
trades.v1| 서비스 · 메서드 | Purpose |
|---|---|
PositionService.List / Close / Detach | 마스터의 오픈 포지션, 청산 및 연결 해제. |
DealService.List | 거래 내역. |
StatService.GetTradingStatistics | 대시보드와 리포트용 집계 거래 통계. |
수익성
profitability.v1| 서비스 · 메서드 | Purpose |
|---|---|
ReturnsService.List | 기간별 수익률. |
ProfitabilityService.GetPnlsByLinks | 구독별 P&L. |
ChartService.Get / List | 마스터 카드용 수익성 차트. |
수수료 및 제휴 수익
fees.v1, fees.v2| 서비스 · 메서드 | Purpose |
|---|---|
PlanService | 수수료 플랜 생성/조회, 활성 플랜 조회, 프로모션 코드별 플랜 조회. |
PromoCodeService | 프로모션 코드를 생성, 업데이트, 삭제 및 조회합니다. |
JobService | 투자자별 수수료 작업 및 지급된 수수료 목록. |
CommissionSharingService | 파트너 수익 배분 — 커미션 배분 설정을 저장하고 조회합니다. |
이체
transfers.v1.transfer| Method | Purpose |
|---|---|
생성 | 계정 간 이체. |
ListTransfers | 이체 내역. |
ListMasterFees / ListInvestorFees | 이체와 관련된 수수료. |
Cancel | 이체를 취소합니다. |
CanTransfer | 이체 가능 여부를 확인합니다. |
PAMM
pamm.v1, pamm.v2| 서비스 · 메서드 | Purpose |
|---|---|
SettingsService.GetSettings / SetSettings | PAMM 계정 설정. |
RolloverService.Start | 롤오버 실행. |
BalanceOperationService.List / SetCancelled (v2) | PAMM 잔액 작업. |
챌린지 및 콘테스트
challenges.v1| 서비스 · 메서드 | Purpose |
|---|---|
ChallengeService.List | 활성 챌린지 목록 — 프로모션 캠페인 및 게이미피케이션의 기반. |
PersonalChallengeService | 사용자 참여 및 개인 진행 상황(생성, 진행 상황 조회, 목록). |
StatisticsService.GetDailySummary | 콘테스트 리더보드용 일일 요약. |
리스크, 심볼, 테넌트, UI 설정
지원 서비스| 서비스 · 메서드 | 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 계약, 더 작은 표면.
임베디드 위젯에서 사용하는 공개 읽기 전용 도메인 개요입니다. 실제 메서드 수는 더 많으며 맞춤형 임베드 요청 시 추가 읽기 엔드포인트를 제공합니다.
Widget 읽기 인터페이스
b2copy.widget.*| 도메인 · 메서드 | 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 인터페이스의 약 30%에 해당하는 대표적인 메서드, 즉 대부분의 브로커가 첫 통합에서 사용하는 메서드를 나열합니다. 전체 proto 계약은 Broker, Frontend 및 Widget 전반에서 훨씬 더 큽니다. 필요한 메서드가 페이지에 없다면 거의 확실히 이미 존재하며, 없다면 추가해 드립니다.
전담 통합 엔지니어
킥오프부터 라이브까지 배정됩니다. 데이터 플로우를 검토하고 시나리오에 가장 깔끔한 메서드 체인을 권장하며, 후속 연동에도 지원합니다.
요청 시 API 확장
목록에 없는 메서드가 필요하신가요? 기존 응답에 새 필드가 필요하신가요? 내부 도구 엔드포인트에 대량 모드가 필요하신가요? 다음 릴리스에 추가합니다 — 일반적으로 분기가 아닌 며칠 안에 제공됩니다.
샌드박스 + 전용 채팅
샘플 마스터, 투자자 및 구독이 포함된 완전한 스테이징 환경과 개발 중 빠른 협업을 위한 엔지니어링 팀 전용 Slack / Teams 채널을 제공합니다.
공동 사전 프로덕션 검토
프로덕션 배포 전에 엔드포인트, JWT 설정, 페이지네이션 및 속도 처리 방식을 함께 검토합니다. 지원 티켓이 되기 전에 엣지 케이스를 포착합니다.
CRM, 클라이언트 포털 및 보고 모델을 알려 주세요. 통합 경로를 설계하고 사용할 메서드(및 확장할 메서드)를 안내해 드립니다.
자주 묻는 질문
FAQ
아니요. 위 표는 대부분의 브로커가 첫 통합에서 사용하는 메서드의 대표적인 일부만 보여 줍니다. 실제 API는 세 가지 인터페이스(Broker / Frontend / Widget) 전반에서 훨씬 더 광범위합니다. 완전하고 최신의 레퍼런스는 docs.b2copy.b2broker.com의 API 문서에서 확인할 수 있습니다.
예. 필요한 메서드, 응답 필드, 필터 또는 대량 모드가 현재 계약에 없다면 추가합니다. 온보딩하는 거의 모든 브로커에 통합 중 적어도 하나의 맞춤 확장이 제공됩니다. 일반적인 처리 기간은 분기가 아니라 며칠에서 한 번의 릴리스 이내입니다. 스코핑 단계에서 시나리오를 알려 주시면 클라이언트 코드를 작성하기 전에 샌드박스에 반영됩니다.
킥오프부터 라이브 전환까지 전담 B2COPY 통합 엔지니어, 샘플 마스터 / 투자자 / 구독이 포함된 완전한 샌드박스, 빠른 협업을 위한 엔지니어링 팀 전용 Slack 또는 Teams 채널, 그리고 배포 전 엔드포인트, JWT 설정 및 페이지네이션 공동 사전 프로덕션 검토를 제공합니다. 목표는 일반적인 복사-붙여넣기가 아니라 귀사 스택에 맞는 통합입니다.
위젯 + SSO 경로에는 필요하지 않습니다. 백오피스 관리자가 iframe 스니펫을 복사하고 관리자 패널에서 JWT에 서명할 수 있습니다. 사전 구축된 CRM 커넥터(B2Core, Nullpoint, FXBO)는 기능 토글로 활성화합니다. 더 깊은 REST + gRPC 통합은 일반적으로 시나리오당 백엔드 개발자 기준 1~3일이 걸립니다.
iframe 위젯은 30분, SSO 적용도 당일에 완료됩니다. 사전 구축된 CRM(B2Core / Nullpoint / FX Back Office) 활성화도 당일 가능합니다. 전체 맞춤형 REST + gRPC 구축은 샌드박스와 전담 B2COPY 통합 엔지니어를 포함해 처음부터 끝까지 2~3주가 소요됩니다.
예. 모든 공개 메서드는 공통 .proto 파일(proto/b2copy/broker, .../frontend, .../widget)에 정의되어 있습니다. REST 라우트와 OpenAPI 사양은 같은 파일에서 생성되므로 요청 및 응답 의미는 동일합니다. 스택에 맞는 전송 방식을 선택하기만 하면 됩니다.
서로 다른 두 흐름. 서버 간 연결: 테넌트별 범위가 지정된 EC 키 서명 관리자 JWT를 Broker API에 사용합니다. 사용자 세션: 클라이언트 포털에서 외부 JWT를 발급하고 SideAuthenticate(또는 AuthUserWithExternalToken)를 통해 교환한 뒤 사용자 범위의 Frontend API를 호출합니다. 어느 쪽도 비밀번호 처리가 필요하지 않습니다.
150개 이상의 관리자 패널 설정이 개발 없이도 B2COPY의 대부분을 다룹니다: 리더보드 열, 통계 표시, 6가지 수수료 유형과 산식, 브로커가 통제하는 마스터 리스크 한도, 계정 표시 기본값, 심볼 매핑, 전체 커스텀 브랜딩(색상, 로고, 테마).
