Obtenga la especificación
API de Chaingateway
La especificación OpenAPI de Chaingateway es una descripción legible por máquina de la API REST en formato OpenAPI 3.0.3. Lista los endpoints de las siete cadenas, la forma de sus solicitudes y respuestas y la autenticación con token Bearer. Chaingateway es una API REST, así que no hay ninguna aplicación que instalar.
¿Qué contiene la especificación OpenAPI?
Describe 202 operaciones en 164 rutas: un endpoint de cuenta, uno de precio, y endpoints de direcciones, transacciones, saldos, bloques y webhooks para siete cadenas. De ellas, 116 operaciones son GET, 68 POST, 12 DELETE y 6 PUT.
| Cadena | Operaciones | Estándares de tokens | Operaciones de webhook |
|---|---|---|---|
| Bitcoin | 21 | Ninguna | 8 |
| Ethereum | 31 | ERC-20, ERC-721 | 8 |
| BNB Smart Chain | 31 | BEP-20, BEP-721 | 8 |
| TRON | 40 | TRC-10, TRC-20, TRC-721 | 8 |
| Solana | 15 | SPL | Ninguna |
| Polygon | 31 | ERC-20, ERC-721 | 8 |
| Arbitrum | 31 | ERC-20, ERC-721 | 8 |
El archivo es YAML, de aproximadamente 1 MB, con la versión de especificación 2.1.0. El servidor es https://app.chaingateway.io. Todos los endpoints usan autenticación HTTP bearer, y usted crea el token en API tokens en su dashboard. Estos recuentos son a 5 de noviembre de 2026 y cambian cuando se añaden endpoints.
¿Cómo genero un cliente a partir de la especificación?
Apunte un generador de código OpenAPI al archivo. El comando de abajo crea un cliente TypeScript con OpenAPI Generator, y la opción -g selecciona el lenguaje.
npx @openapitools/openapi-generator-cli generate \
-i https://chaingateway.io/openapi.yaml \
-g typescript-fetch \
-o ./chaingateway-client Sustituya typescript-fetch por el generador de su lenguaje, por ejemplo python o php. Ejecute una llamada contra testnet antes de fiarse del código generado. OpenAPI Generator: lista de generadores
¿Cómo importo la especificación en Postman o Insomnia?
Ambas herramientas importan un archivo OpenAPI directamente. Elija la opción de importar y pegue la URL https://chaingateway.io/openapi.yaml o seleccione el archivo descargado. Defina la cabecera Authorization con su token Bearer y añada X-Network: testnet mientras prueba.
¿Cómo llamo a la API sin un cliente generado?
Envíe su token Bearer en la cabecera Authorization a https://app.chaingateway.io. Añada X-Network: testnet para usar testnet. Omita la cabecera, o póngala en mainnet, para usar mainnet.
curl https://app.chaingateway.io/api/account \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-Network: testnet" GET /api/account es una comprobación rápida de que un token funciona.
¿Cómo se ven las respuestas y los errores en la especificación?
Las operaciones correctas devuelven HTTP 200 o 201, y los ejemplos envuelven el resultado en un sobre con los campos status, ok, message y data. En las 202 operaciones, la especificación documenta 401 (no autenticado) 50 veces, 422 (por ejemplo, validación de datos fallida o fondos insuficientes) 70 veces, 404 cinco veces y 400 una vez.
Un ejemplo de 401 dice "Unauthenticated." en el campo message. Lea primero el código de estado y después el mensaje.
¿Existe una versión legible de la especificación?
Sí. La referencia interactiva de la API muestra el mismo archivo, así que puede leer endpoints, probar solicitudes y copiar ejemplos antes de generar código. Abrir la referencia de la API
¿Qué partes de la especificación están obsoletas?
Las operaciones Paymaster de Tron siguen en el archivo, cinco en total. Paymaster está obsoleto y lo sustituye TronFuel, así que déjelas fuera de las integraciones nuevas. Solana no tiene ningún endpoint de webhook.
¿Listo para empezar a construir?
Cada integración funciona sobre la misma API REST de Chaingateway — prueba gratuita de 7 días, sin tarjeta de crédito, sin KYC. Los planes comienzan en 49 €/mes y cubren las siete cadenas compatibles.