Introduction to API Broker
API Broker es la infraestructura financiera modular de AdCap Grupo Financiero que le permite a tu plataforma ofrecer servicios de inversión de forma rápida, segura y regulada. Billeteras digitales, fintechs, bancos e integradores tecnológicos se conectan a través de nuestras APIs para habilitar onboarding de inversores, fondos comunes de inversión, dólar MEP, trading y remuneración de saldo, sin asumir la complejidad operativa ni regulatoria.
La integración es 100% vía API y webhooks. La experiencia del usuario final es 100% tuya.
Cómo está organizada la documentación
🔐 Autenticación
Todas las APIs de API Broker utilizan autenticación Bearer (JWT) gestionada a través de AWS Cognito. El primer paso siempre es obtener un token válido.
POST /api/auth/login{
"username": "tu_usuario",
"password": "tu_password"
}El response incluye un AccessToken con vigencia de 1 hora y un RefreshToken para renovar la sesión. Todos los requests requieren el header:
Authorization: Bearer {AccessToken}Las credenciales son asignadas por el equipo de API Broker en la etapa de Staging y posteriormente en Producción. Cada ambiente tiene sus propias credenciales y URL base:
| Ambiente | URL base |
|---|---|
| Development(DEV) - Deprecado | https://apibroker.dev-adcap.com |
| Staging (STG) | https://apibroker.stg-adcap.com |
| Producción (PRD) | https://apibroker.prd-adcap.com |
⚙️ Onboarding
El onboarding es el prerequisito de todos los módulos. Antes de que un usuario pueda invertir, necesita una cuenta comitente activa (investment_account_id). El flujo tiene cuatro pasos secuenciales:
Paso 1 — Alta de persona POST /v2/persons
Registra al usuario en el sistema. Soporta personas físicas (DNI, datos personales) y personas jurídicas (razón social, datos societarios). Devuelve un person_id.
Paso 2 — Documentación
- Personas físicas:
POST /identity-documents— frente y dorso del DNI + selfie en base64. - Personas jurídicas:
POST /contracts(multipart) — instrumento constitutivo, balance certificado, nómina de autoridades, estructura de beneficiarios finales.
Paso 3 — Cuenta comitente POST /v2/investment-accounts
Crea la cuenta de inversión vinculando el person_id. Incluye el cuestionario de perfil de riesgo (5 preguntas) y define los mercados habilitados. Devuelve un investment_account_id.
Para personas jurídicas, el sistema genera automáticamente una cuenta cuotapartista, necesaria para operar FCI con método SIMPLE.
Paso 4 — Cuenta bancaria POST /bank-accounts
Vincula una cuenta bancaria same-name (misma titularidad, validada por CUIT) para habilitar depósitos y retiros. Devuelve un bank_account_id.
📦 Módulos disponibles
Una vez completado el onboarding, podés habilitar uno o más módulos de forma independiente según el producto que quieras ofrecer:
| Módulo | Qué permite | Endpoint principal |
|---|---|---|
| Remuneración de Saldo | Rendimiento automático sobre saldos ociosos en FCI Money Market | PUT /continuous-remuneration |
| Fondos Comunes de Inversión | Suscripción y rescate de FCI de Adcap Asset Management | POST /market/fund-requests |
| Dólar MEP | Compra y venta de dólares vía mercado de capitales (T+0) | POST /market/mep-order |
| Trading | Compra y venta de CEDEARs, acciones y bonos (BYMA) | POST /market/market-order/ |
Cada módulo funciona sobre el mismo investment_account_id y el mismo flujo de cash in / cash out.
🔔 Webhooks
Toda la operatoria es asincrónica. Tu plataforma debe exponer una URL para recibir los siguientes eventos:
| Evento | Cuándo se dispara |
|---|---|
deposit_create | Cuando se acredita un depósito en la cuenta comitente |
investment_account_update | Cuando la cuenta comitente o cuotapartista es creada exitosamente |
withdraw_request_update | Cuando cambia el estado de un retiro (IN_PROGRESS, COMPLETED, REJECTED) |
🔵 Back Office
API Broker pone a tu disposición un Back Office web para que tu equipo pueda consultar y gestionar la información de tus usuarios sin necesidad de ir directamente a la API.
Desde el Back Office podés:
- Buscar personas por CUIT y obtener su
person_id - Consultar el estado de cuentas comitentes y su cartera completa (saldos, FCI, CEDEARs, acciones, bonos)
- Revisar depósitos, extracciones y boletos
- Identificar rápidamente cuentas habilitadas o bloqueadas
El acceso al Back Office es configurado durante el proceso de integración junto con las credenciales de producción.
Modelo de negocio
API Broker funciona bajo un modelo B2B2C con revenue sharing.
No hay costos fijos de integración: la monetización es por volumen operado.
Para quién está pensado
| Tipo de partner | Caso de uso principal |
|---|---|
| Billeteras digitales | Remunerar saldos ociosos, ofrecer FCI y dólar MEP para aumentar engagement y revenue |
| Apps de inversión | Ampliar catálogo con CEDEARs, bonos, FCI y onboarding digital regulado |
| Bancos | Digitalizar la experiencia de inversión sin rediseñar sistemas legacy |
| Integradores tecnológicos | Ofrecer “inversión as a service” a sus clientes fintech |
| Tesorерías corporativas | Optimizar rendimiento de saldos ociosos vía money market |
Proceso de integración
El camino desde el primer contacto hasta el go live sigue estos hitos:
- Firma de NDA — acceso a documentación extendida y credenciales internas
- Credenciales de Staging — configuración de ambiente sandbox
- Desarrollo sobre Staging — integración y pruebas con acompañamiento técnico
- Homologación — pruebas conjuntas con el equipo de API Broker
- Credenciales de Producción — claves definitivas y dominios productivos
- Lanzamiento Beta — validación con tráfico controlado
- Go Live — operación plena con monitoreo conjunto en las primeras 72 horas
Acompañamos cada etapa con soporte técnico, de negocio y operativo directo. No sos un número de ticket: tenés un oficial de cuenta asignado desde el día uno.
Primeros pasos
- Escribinos a [email protected] para iniciar el proceso.
- Firmamos el NDA y te asignamos un oficial de cuenta.
- Recibís las credenciales de Staging y acceso a la documentación completa.
- Tu equipo empieza a integrar con soporte directo del equipo de API Broker.
API Broker nace dentro de AdCap Grupo Financiero, uno de los principales actores del mercado de capitales argentino con más de 20 años de trayectoria. Nuestro equipo combina experiencia en mercado financiero, tecnología, producto digital, regulación y compliance.
Updated 2 months ago