En resumen
La API de Contratos Inteligentes de Blockradar te permite interactuar con cualquier contrato inteligente directamente desde tu billetera sin necesidad de gestionar endpoints RPC, flujos de firma o despliegues de contratos por tu cuenta.
La API de Contratos Inteligentes de Blockradar te permite interactuar con cualquier contrato inteligente directamente desde tu billetera sin necesidad de gestionar endpoints RPC, flujos de firma o despliegues de contratos por tu cuenta.

Prerrequisitos
Antes de usar la API de Contratos Inteligentes, asegúrate de tener:1
Clave API
Obtén tu clave API desde el Panel de Blockradar. Navega a Configuración → Claves API para generar una.
2
Billetera Creada
Crea una billetera mediante la API de Crear Billetera o el panel. Necesitarás el
walletId para todas las operaciones de contratos inteligentes.3
Saldo de Token Nativo
Financia tu billetera con moneda nativa (ETH, BNB, MATIC, etc.) para cubrir las tarifas de gas. Usa el endpoint de Tarifa de Red para estimar costos antes de ejecutar.
Blockchains Soportadas
La API de Contratos Inteligentes soporta todas las blockchains compatibles con EVM y Tron disponibles en Blockradar. Consulta Integraciones para la lista completa de redes soportadas y enlaces de faucets.Introducción
La API de Contratos Inteligentes transforma Blockradar de una infraestructura de billeteras en una capa de ejecución programable. Puedes leer el estado de contratos, ejecutar funciones de contratos, estimar tarifas de gas y firmar transacciones—todo a través de una superficie de API unificada.Operaciones de Lectura
Recupera datos de cualquier contrato inteligente en las blockchains soportadas.
Operaciones de Escritura
Ejecuta funciones de contratos inteligentes con gestión completa de transacciones.
Estimación de Tarifas
Calcula costos de gas antes de la ejecución para asegurar fondos suficientes.
Operaciones por Lote
Ejecuta múltiples llamadas a contratos en una sola solicitud de API.
Casos de Uso
La API de Contratos Inteligentes desbloquea capacidades poderosas para desarrolladores fintech:- Integración DeFi: Conecta con protocolos como Uniswap, Aave o Compound para gestión de rendimientos y liquidez
- Operaciones de Tesorería: Automatiza la gestión de tesorería dentro de tu plataforma fintech
- Activos Tokenizados: Integra activos del mundo real en tus flujos de productos
- Liquidaciones Programables: Ejecuta verificaciones de cumplimiento y liquidaciones automatizadas
- Activos Personalizados: Gestiona activos personalizados, sistemas de recompensas y programas de fidelidad
Billetera Principal vs Dirección Hija
La API de Contratos Inteligentes está disponible en dos niveles:Billetera Principal
Ejecuta operaciones de contratos directamente desde tu billetera principal. Ideal para operaciones de tesorería y gestión centralizada de fondos.
Dirección Hija
Ejecuta operaciones de contratos desde direcciones hijas individuales. Perfecto para operaciones específicas de usuarios y gestión segregada de fondos.
Endpoints de Billetera Principal
| Operación | Endpoint | Descripción |
|---|---|---|
| Lectura | POST /v1/wallets/{walletId}/contracts/read | Recupera datos de contratos inteligentes |
| Escritura | POST /v1/wallets/{walletId}/contracts/write | Ejecuta funciones de contratos inteligentes |
| Tarifa de Red | POST /v1/wallets/{walletId}/contracts/network-fee | Estima costos de gas |
| Solo Firmar | POST /v1/wallets/{walletId}/contracts/write/sign | Firma sin transmitir |
Endpoints de Dirección Hija
| Operación | Endpoint | Descripción |
|---|---|---|
| Lectura | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/read | Recupera datos de contratos inteligentes |
| Escritura | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/write | Ejecuta funciones de contratos inteligentes |
| Tarifa de Red | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/network-fee | Estima costos de gas |
| Solo Firmar | POST /v1/wallets/{walletId}/addresses/{addressId}/contracts/write/sign | Firma sin transmitir |
Estructura de la Solicitud
Todas las solicitudes de contratos inteligentes requieren estos parámetros:| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
address | string | Sí | La dirección blockchain del contrato inteligente |
method | string | Sí | El nombre de la función a llamar |
parameters | array | Sí | Argumentos que coinciden con el orden del ABI de la función |
abi | array | Sí | La Interfaz Binaria de Aplicación del contrato |
reference | string | No | Tu ID de seguimiento interno para la transacción |
metadata | object | No | Pares clave-valor personalizados para detalles adicionales de la transacción |
Los campos
reference y metadata solo son aplicables para operaciones de escritura. Las operaciones de lectura no admiten estos campos.Entendiendo los ABIs
El ABI (Application Binary Interface) define cómo interactuar con un contrato inteligente. Puedes obtener ABIs de:- Exploradores de bloques: Etherscan, BscScan, PolygonScan (contratos verificados)
- Documentación de protocolos: Documentación oficial de protocolos DeFi
- Código fuente del contrato: Compilar desde código fuente Solidity
Lectura de Datos del Contrato
Usa el endpoint de lectura para consultar el estado del contrato sin modificar la blockchain.Ejemplo de Lectura con Billetera Principal
Ejemplo de Lectura con Dirección Hija
Respuesta de Lectura
Respuestas de Error de Lectura
Dirección de Contrato Inválida
Dirección de Contrato Inválida
Método No Encontrado
Método No Encontrado
Ejecución de Contrato Revertida
Ejecución de Contrato Revertida
Parámetros Inválidos
Parámetros Inválidos
Escritura en Contratos
Ejecuta funciones que cambian el estado en contratos inteligentes.Ejemplo de Escritura con Billetera Principal
Ejemplo de Escritura con Dirección Hija
Respuesta de Escritura
Respuestas de Error de Escritura
Gas Insuficiente
Gas Insuficiente
Saldo de Token Insuficiente
Saldo de Token Insuficiente
Transacción Revertida
Transacción Revertida
ABI Inválido
ABI Inválido
Billetera No Encontrada
Billetera No Encontrada
Estimación de Tarifas de Red
Siempre estima las tarifas antes de ejecutar operaciones de escritura para asegurar que tu billetera tenga suficiente moneda nativa.Estimación de Tarifas con Billetera Principal
Estimación de Tarifas con Dirección Hija
Respuesta de Tarifas
Ejemplo Práctico: Intercambio de Activos en Uniswap
Esta sección demuestra dos enfoques para ejecutar un intercambio de activos: sin operaciones por lote (llamadas secuenciales) y con operaciones por lote (una sola llamada de API).Ejemplo 1: Intercambio de Activos SIN Operaciones por Lote
Este enfoque hace llamadas de API individuales para cada paso. Úsalo cuando necesites control detallado sobre cada transacción o cuando las operaciones dependan de los resultados de llamadas anteriores.Paso 1: Verificar Saldo de Activos
Paso 2: Aprobar Gasto de Activos
Paso 3: Estimar Tarifas del Intercambio
Paso 4: Ejecutar Intercambio
Ejemplo 2: Intercambio de Activos CON Operaciones por Lote
Este enfoque combina aprobar + intercambiar en una sola llamada de API usando el arraycalls. Úsalo para eficiencia cuando quieras agrupar múltiples operaciones juntas.
Las operaciones por lote se ejecutan secuencialmente. Cada operación se envía como una transacción separada, pero solo necesitas una llamada de API.
Solicitud por Lote: Aprobar + Intercambiar en Una Llamada
Respuesta del Lote
Manejo de Fallos Parciales en Lotes
Reglas de Operaciones por Lote
| Regla | Valor |
|---|---|
| Tamaño máximo del lote | 20 operaciones |
| Orden de ejecución | Secuencial |
| Manejo de errores | Éxito parcial (los fallos no detienen las operaciones subsiguientes) |
Cuándo Usar Cada Enfoque
| Escenario | Enfoque Recomendado |
|---|---|
| Necesitas verificar resultados entre pasos | Sin Lote |
| Parámetros dinámicos basados en resultados anteriores | Sin Lote |
| Patrones simples de aprobar + acción | Con Lote |
| Múltiples operaciones independientes | Con Lote |
| Minimizar llamadas de API | Con Lote |
Eventos de Webhook
Las operaciones de contratos inteligentes disparan notificaciones de webhook:| Evento | Descripción |
|---|---|
custom-smart-contract.success | Operación de contrato completada exitosamente |
custom-smart-contract.failed | Operación de contrato falló |
Payload del Webhook
Mejores Prácticas
Seguridad
- Verifica direcciones de contratos: Siempre verifica las direcciones de contratos antes de interactuar
- Usa ABIs confiables: Obtén ABIs de fuentes verificadas como exploradores de bloques
- Establece límites razonables: Usa protección contra deslizamiento y límites de cantidad para operaciones DeFi
Gestión de Gas
- Estima antes de ejecutar: Siempre llama al endpoint de tarifa de red primero
- Monitorea el saldo nativo: Asegura suficiente ETH/BNB/MATIC para tarifas de gas
- Usa operaciones por lote: Reduce la sobrecarga agrupando operaciones relacionadas
Manejo de Errores
- Implementa escuchadores de webhooks: No dependas únicamente de las respuestas de la API
- Maneja fallos parciales: Verifica ambos arrays
successyerrorsen respuestas de lotes - Reintenta con retroceso: Implementa retroceso exponencial para fallos transitorios
Referencia de API
Endpoints de Billetera Principal
| Endpoint | Descripción |
|---|---|
| Leer Contrato | Lee el estado del contrato |
| Escribir Contrato | Ejecuta funciones del contrato |
| Tarifa de Red | Estima costos de gas |
| Solo Firmar | Firma sin transmitir |
Endpoints de Dirección Hija
| Endpoint | Descripción |
|---|---|
| Leer Contrato | Lee el estado del contrato |
| Escribir Contrato | Ejecuta funciones del contrato |
| Tarifa de Red | Estima costos de gas |
| Solo Firmar | Firma sin transmitir |
Soporte
- Email: [email protected]
- Documentación: Referencia de API
- Blog: Cómo Interactuar con Cualquier Contrato Inteligente
La API de Contratos Inteligentes te permite construir integraciones blockchain sofisticadas sin gestionar la complejidad de la infraestructura. Comienza con operaciones de lectura simples e incorpora gradualmente operaciones de escritura a medida que te familiarices con el sistema.

