Skip to main content
En resumen
La API de Smart Contracts de Blockradar le permite interactuar con cualquier smart contract directamente desde su billetera, sin necesidad de gestionar endpoints RPC, flujos de firma o despliegues de contratos por su cuenta.
Smart Contracts

Requisitos previos

Antes de utilizar la API de Smart Contracts, asegúrese de contar con:
1

Clave de API

Obtenga su clave de API desde el Dashboard de Blockradar. Vaya a Developers para generar una.
2

Billetera creada

Cree una billetera mediante la API Create Wallet o el dashboard. Necesitará el walletId para todas las operaciones de smart contracts.
3

Saldo en moneda nativa

Financie su billetera con la moneda nativa (ETH, BNB, MATIC, etc.) para cubrir las tarifas de gas. Utilice el endpoint de Network Fee para estimar los costos antes de ejecutar.

Blockchains compatibles

La API de Smart Contracts admite todas las blockchains compatibles con EVM y Tron disponibles en Blockradar. Consulte Integrations para ver la lista completa de redes admitidas y enlaces a faucets.
Solana no es compatible para interacciones con smart contracts. La API de Smart Contracts solo funciona con cadenas compatibles con EVM y Tron.
Comience con testnets durante el desarrollo para evitar gastar fondos reales.

Introducción

La API de Smart Contracts transforma a Blockradar de una infraestructura de billeteras a una capa de ejecución programable. Puede leer el estado de un contrato, ejecutar funciones de contratos, estimar tarifas de gas y firmar transacciones, todo a través de una superficie API unificada.

Operaciones de lectura

Recupere datos de cualquier smart contract en las blockchains compatibles.

Operaciones de escritura

Ejecute funciones de smart contracts con gestión completa de transacciones.

Estimación de tarifas

Calcule los costos de gas antes de ejecutar para asegurar fondos suficientes.

Operaciones por lotes

Ejecute múltiples llamadas a contratos en una sola solicitud API.

Casos de uso

La API de Smart Contracts habilita capacidades poderosas para los desarrolladores fintech:
  • Integración con DeFi: Conéctese a protocolos como Uniswap, Aave o Compound para gestión de rendimiento y liquidez
  • Operaciones de tesorería: Automatice la gestión de tesorería dentro de su plataforma fintech
  • Activos tokenizados: Integre activos del mundo real en sus flujos de producto
  • Liquidaciones programables: Ejecute verificaciones de cumplimiento y liquidaciones automatizadas
  • Activos personalizados: Gestione activos personalizados, sistemas de recompensas y programas de lealtad

Master Wallet vs Child Address

La API de Smart Contracts está disponible en dos niveles:

Master Wallet

Ejecute operaciones de contratos directamente desde su master wallet. Ideal para operaciones de tesorería y gestión centralizada de fondos.

Child Address

Ejecute operaciones de contratos desde child addresses individuales. Perfecto para operaciones específicas de usuario y gestión segregada de fondos.

Endpoints de Master Wallet

Endpoints de Child Address

Estructura de la solicitud

Todas las solicitudes de smart contracts requieren estos parámetros:
Los campos reference y metadata solo se aplican a operaciones de escritura. Las operaciones de lectura no admiten estos campos.

Comprensión de los ABIs

El ABI (Application Binary Interface) define cómo interactuar con un smart contract. Puede obtener ABIs desde:
  • Exploradores de bloques: Etherscan, BscScan, PolygonScan (contratos verificados)
  • Documentación de protocolos: Documentación oficial de los protocolos DeFi
  • Código fuente del contrato: Compile a partir del código fuente Solidity

Lectura de datos del contrato

Utilice el endpoint de lectura para consultar el estado del contrato sin modificar la blockchain.

Ejemplo de lectura con Master Wallet

Ejemplo de lectura con Child Address

Respuesta de lectura

Respuestas de error de lectura

Escritura en contratos

Ejecute funciones que modifican el estado de los smart contracts.

Ejemplo de escritura con Master Wallet

Ejemplo de escritura con Child Address

Respuesta de escritura

Las operaciones de escritura son asíncronas. La respuesta inicial muestra el estado PENDING. Escuche el webhook custom-smart-contract.success para confirmar la finalización de la transacción.

Respuestas de error de escritura

Estimación de tarifas de red

Estime siempre las tarifas antes de ejecutar operaciones de escritura para asegurar que su billetera disponga de suficiente moneda nativa.

Estimación de tarifas con Master Wallet

Estimación de tarifas con Child Address

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 lotes (llamadas secuenciales) y con operaciones por lotes (una sola llamada API).

Ejemplo 1: intercambio de activos SIN operaciones por lotes

Este enfoque realiza llamadas API individuales para cada paso. Úselo cuando necesite control detallado sobre cada transacción o cuando las operaciones dependan de los resultados de llamadas anteriores.

Paso 1: verificar el saldo del activo

Paso 2: aprobar el gasto del activo

Espere siempre el webhook custom-smart-contract.success que confirme que la transacción de aprobación fue minada antes de ejecutar el swap.

Paso 3: estimar las tarifas del swap

Paso 4: ejecutar el swap


Ejemplo 2: intercambio de activos CON operaciones por lotes

Este enfoque combina approve + swap en una sola llamada API utilizando el array calls. Úselo para mayor eficiencia cuando desee encolar múltiples operaciones juntas.
Las operaciones por lotes se ejecutan secuencialmente. Cada operación se envía como una transacción independiente, pero solo necesita una llamada API.

Solicitud por lotes: approve + swap en una sola llamada

Respuesta del lote

Manejo de fallos parciales en lotes

Reglas de operaciones por lotes

Cuándo usar cada enfoque


Eventos de Webhook

Las operaciones de smart contracts disparan notificaciones webhook:

Payload del Webhook

Mejores prácticas

Seguridad

  • Verifique las direcciones de los contratos: Verifique siempre dos veces las direcciones de los contratos antes de interactuar
  • Use ABIs confiables: Obtenga los ABIs de fuentes verificadas como exploradores de bloques
  • Establezca límites razonables: Use protección de slippage y topes de monto para operaciones DeFi

Gestión de gas

  • Estime antes de ejecutar: Llame siempre primero al endpoint network-fee
  • Monitoree el saldo nativo: Asegúrese de tener suficiente ETH/BNB/MATIC para las tarifas de gas
  • Use operaciones por lotes: Reduzca la sobrecarga agrupando operaciones relacionadas

Manejo de errores

  • Implemente listeners de webhook: No dependa solo de las respuestas de la API
  • Maneje fallos parciales: Verifique tanto los arrays success como errors en respuestas por lotes
  • Reintente con backoff: Implemente backoff exponencial para fallos transitorios

Referencia API

Endpoints de Master Wallet

Endpoints de Child Address

Soporte

La API de Smart Contracts le permite construir integraciones blockchain sofisticadas sin gestionar la complejidad de la infraestructura. Comience con operaciones simples de lectura e incorpore progresivamente operaciones de escritura a medida que se familiarice con el sistema.