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.
📝 Primeros pasos
Aprenda los conceptos básicos de Chaingateway y descubra cómo empezar a usarla
💻 Documentación de la API
Explore la documentación de nuestra API Blockchain Gateway, fácil de usar
🔔 Webhooks
Descubra cómo nuestro sistema Instant Payment Notification puede avisarle de eventos en la blockchain
🎓 Tutoriales
Encuentre tutoriales útiles sobre cómo implementar la API de Chaingateway en casos de uso de ejemplo
¿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.
| Tarea | Endpoint típico | Blockchains |
|---|---|---|
| Crear una dirección de wallet | POST /api/v2/{chain}/addresses | Ethereum, BSC, Polygon, Arbitrum, TRON, Solana |
| Crear un wallet de Bitcoin y sus direcciones | POST /api/v2/bitcoin/wallets | Bitcoin |
| Enviar monedas nativas | POST /api/v2/{chain}/transactions | las siete |
| Enviar tokens | POST /api/v2/{chain}/transactions/erc20, /bep20, /trc20, /SPL | todas salvo Bitcoin |
| Leer saldos y bloques | GET /api/v2/{chain}/balances/{address} | las siete |
| Recibir avisos de pagos | POST /api/v2/{chain}/webhooks | todas salvo Solana |
| Consultar un precio de mercado | GET /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.
¿Cómo hago mi primera solicitud?
Sección titulada «¿Cómo hago mi primera solicitud?»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.
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.
¿Qué redes admite la API?
Sección titulada «¿Qué redes admite la API?»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.
¿Cómo es una respuesta?
Sección titulada «¿Cómo es una respuesta?»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."] }}¿Qué guía debo leer a continuación?
Sección titulada «¿Qué guía debo leer a continuación?»Elija la página que corresponda a la tarea que tiene entre manos:
- Para guardar las claves de forma segura, lea Gestión de wallets.
- Para detectar pagos entrantes, lea Webhooks y después Seguridad de webhooks.
- Para enviar monedas, siga Crear transacciones y Crear transacciones de tokens.
- Para pagar comisiones de TRON sin tener TRX, lea Patrocinar comisiones TRC20.
Fuentes
Sección titulada «Fuentes»Las convenciones de HTTP y de tokens que usan estas páginas están definidas por estándares públicos:
- RFC 9110, HTTP Semantics para métodos, códigos de estado y cabeceras.
- RFC 6750, Bearer Token Usage para la cabecera
Authorization: Bearer. - RFC 8259, The JSON Data Interchange Format para los cuerpos de solicitud y respuesta.
- Documentación para desarrolladores de Ethereum y documentación para desarrolladores de TRON para las blockchains que hay detrás de los endpoints.