Saltearse al contenido

Portal para desarrolladores de Chaingateway

El portal para desarrolladores de Chaingateway documenta una API REST para crear direcciones, enviar transacciones, leer saldos y recibir webhooks en Ethereum, TRON, BNB Smart Chain, Bitcoin, Polygon, Arbitrum y Solana. Empiece por el inicio rápido: cree una clave de API, envíe una solicitud y cambie entre mainnet y testnet con una sola cabecera.

¿Qué puedo hacer con la API de Chaingateway?

Sección titulada «¿Qué puedo hacer con la API de Chaingateway?»

Con una sola interfaz REST puede gestionar wallets, enviar monedas nativas y tokens, leer datos de la blockchain y suscribirse a notificaciones de pago. El archivo OpenAPI lista más de 200 operaciones. Están agrupadas por blockchain, y el mismo patrón se repite en las cadenas EVM.

TareaEndpoint típicoBlockchains
Crear una dirección de walletPOST /api/v2/{chain}/addressesEthereum, BSC, Polygon, Arbitrum, TRON, Solana
Crear un wallet de Bitcoin y sus direccionesPOST /api/v2/bitcoin/walletsBitcoin
Enviar monedas nativasPOST /api/v2/{chain}/transactionslas siete
Enviar tokensPOST /api/v2/{chain}/transactions/erc20, /bep20, /trc20, /SPLtodas salvo Bitcoin
Leer saldos y bloquesGET /api/v2/{chain}/balances/{address}las siete
Recibir avisos de pagosPOST /api/v2/{chain}/webhookstodas salvo Solana
Consultar un precio de mercadoGET /api/v2/market/price/{crypto}/{fiat}independiente de la blockchain

Solana no tiene endpoints de webhook, así que los ingresos en Solana se detectan leyendo saldos o transacciones. Los wallets son no custodiales: usted elige una contraseña que protege la clave almacenada, o recibe la clave privada en la respuesta y la conserva por su cuenta. Gestión de wallets explica ambos modos.

Ruta de integración en cuatro pasos: crear una clave de API, crear una dirección, enviar o leer transacciones y recibir webhooks 1. Crear una clave de API Panel, tokens de API 2. Crear una dirección POST /api/v2/{chain}/addresses 3. Enviar y leer transacciones POST y GET /api/v2/{chain}/transactions 4. Recibir webhooks POST /api/v2/{chain}/webhooks, su servidorresponde 200
El orden habitual de una integración. Los pasos 3 y 4 pueden ejecutarse en paralelo.

Cree una clave de API en el panel y envíela como token Bearer en la cabecera Authorization. Una cuenta nueva empieza con una prueba gratuita de 7 días, y para comenzar no hacen falta tarjeta ni verificación de identidad. La solicitud siguiente lee el número del último bloque de Ethereum.

Ventana de terminal
curl --request GET \
--url https://app.chaingateway.io/api/v2/ethereum/blocks/number \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

Una solicitud sin un token válido devuelve HTTP 401 con el cuerpo {"message":"Unauthenticated."}. Para ejecutar la misma llamada en la red de pruebas, añada la cabecera X-Network: testnet. Omita la cabecera, o use mainnet, para trabajar en la red principal. El inicio rápido explica la creación de la cuenta, las cabeceras y una solicitud POST en cuatro lenguajes.

Hay siete blockchains disponibles, cada una con mainnet y testnet. Las testnets son Sepolia para Ethereum, Nile para TRON, la testnet de BNB Smart Chain, Bitcoin testnet3, Amoy para Polygon, Arbitrum Sepolia y devnet de Solana. Redes compatibles lista todas las redes con el valor X-Network correspondiente y explica los dos valores de la cabecera.

¿Dónde encuentro la referencia completa de la API?

Sección titulada «¿Dónde encuentro la referencia completa de la API?»

La referencia interactiva está en chaingateway.io/docs. Se genera a partir del mismo archivo openapi.yaml que puede importar en Postman, Insomnia o un generador de código. Cada operación indica sus parámetros, las reglas de validación de las direcciones y las respuestas de ejemplo, incluidos los cuerpos de error.

Todas las respuestas comparten un mismo envoltorio JSON con los campos status, ok y message. Las llamadas correctas añaden data, y una validación fallida añade un objeto errors. Las preguntas frecuentes muestran ejemplos de ambos casos.

Todos los endpoints responden con JSON. Una llamada correcta devuelve ok: true junto con el estado HTTP y un campo data. El ejemplo siguiente es la respuesta de GET /api/v2/ethereum/gasprice.

{
"ok": true,
"status": 200,
"message": "Successfully parsed",
"data": { "gasPrice": "12.28" }
}

Una validación fallida devuelve el estado 422 y nombra cada campo rechazado. El mismo envoltorio transporta los errores de la blockchain, por ejemplo fondos insuficientes para el gas. Una contraseña de wallet incorrecta devuelve 401 con el mensaje Wrong password provided. Escriba su cliente de modo que compruebe primero ok y registre message y errors cuando sea false.

{
"status": 422,
"ok": false,
"message": "Data validation failed",
"errors": { "password": ["The password field is required."] }
}

Elija la página que corresponda a la tarea que tiene entre manos:

Las convenciones de HTTP y de tokens que usan estas páginas están definidas por estándares públicos: