> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Gateway

> Aprende cómo gestionar USDC entre cadenas usando la función Gateway

<Note>
  En pocas palabras<br />
  Gateway permite la gestión unificada de USDC en múltiples blockchains—deposita desde cualquier cadena, retira a cualquier cadena, todo desde un único saldo abstraído de cadena. Sin puenteo manual ni fragmentación de liquidez.
</Note>

<iframe className="w-full h-[500px]" height="315" src="https://www.youtube.com/embed/2zlnvIArI_s?si=Q_jg2-xR4d783w3g" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

## Requisitos Previos

Antes de usar la API de Gateway, asegúrate de tener:

<Steps>
  <Step title="Clave API">
    Obtén tu clave API desde el [Panel de Blockradar](https://dashboard.blockradar.co). Navega a **Developers** para generar una.
  </Step>

  <Step title="Billetera Compatible">
    Crea una billetera principal en una cadena compatible con Gateway (Ethereum, Base, Polygon, Arbitrum, Optimism o Avalanche). Usa la [API de Crear Billetera](/es/api-reference/wallets/create-wallet) o el panel.
  </Step>

  <Step title="Saldo USDC">
    Asegúrate de que tu billetera tenga USDC para depositar en Gateway. Gateway solo admite USDC para operaciones entre cadenas.
  </Step>

  <Step title="Token Nativo para Gas">
    Financia tu billetera con tokens nativos (ETH, MATIC, AVAX) para cubrir las tarifas de red para operaciones de depósito y retiro.
  </Step>
</Steps>

<Warning>
  NO envíes USDC directamente al contrato de la Billetera de Gateway usando una transferencia de token estándar—esto resultará en pérdida permanente de fondos. Solo usa los métodos oficiales de la API para depósitos.
</Warning>

## Cómo Funciona

Gateway te permite gestionar USDC sin problemas en todas las blockchains compatibles. Elimina el puenteo manual, el reequilibrio y la fragmentación de liquidez—permitiéndote mover, depositar y retirar USDC instantáneamente, de cualquier cadena a cualquier cadena.

### Acciones admitidas:

* Depositar USDC desde cualquier blockchain compatible en tu saldo unificado de Gateway.

* Retirar (acuñar) instantáneamente USDC en cualquier otra blockchain compatible.

* Ver billeteras, transacciones y saldos a través de la API.

## Referencia de la API

### **Endpoints**

A continuación se muestran los endpoints principales de la API para operaciones de Gateway:

#### **Endpoints de Gateway de Billetera Principal**

* [POST /gateway/deposit](/es/api-reference/gateway/master-wallet-deposit) – Depositar USDC al saldo de Gateway

* [POST /gateway/withdraw](/es/api-reference/gateway/master-wallet-withdraw) – Retirar USDC del saldo de Gateway a cualquier cadena compatible

* [GET /gateway/wallets](/es/api-reference/gateway/get-supported-master-wallets) – Listar billeteras de Gateway

* [GET /gateway/transactions](/es/api-reference/gateway/master-wallet-transactions) – Revisar todas las transacciones relacionadas con Gateway

* [GET /gateway/balance](/es/api-reference/gateway/master-wallet-get-balance) – Consultar saldo unificado de USDC

* [POST /gateway/deposit-network-fee](/es/api-reference/gateway/master-wallet-deposit-network-fee) – Obtener estimación de tarifa de red de depósito

* [POST /gateway/withdraw-network-fee](/es/api-reference/gateway/master-wallet-withdraw-network-fee) – Obtener estimación de tarifa de red de retiro

#### **Endpoints de Gateway de Dirección Secundaria**

Puedes acceder a las funciones de Gateway directamente desde la página de dirección secundaria en el panel de control:

<img className="gateway-child-address" src="https://mintcdn.com/blockradar/Q4zdBTyprhDmz_Ni/images/child-address-gateway.png?fit=max&auto=format&n=Q4zdBTyprhDmz_Ni&q=85&s=e196861c718f20b6696f78ac6064eb17" alt="Child Address Gateway" width="3444" height="1908" data-path="images/child-address-gateway.png" />

* [POST /addresses/{addressId}/gateway/deposit/{walletId}](/es/api-reference/gateway/child-address-deposit) – Depositar USDC al saldo de Gateway para una dirección secundaria

* [POST /addresses/{addressId}/gateway/withdraw](/es/api-reference/gateway/child-address-withdraw) – Retirar USDC del saldo de Gateway para una dirección secundaria a cualquier cadena compatible

* [GET /addresses/{addressId}/gateway/transactions](/es/api-reference/gateway/child-address-transactions) – Revisar todas las transacciones relacionadas con Gateway para una dirección secundaria

* [GET /addresses/{addressId}/gateway/balance](/es/api-reference/gateway/child-address-get-balance) – Consultar saldo unificado de USDC para dirección secundaria

* [POST /addresses/{addressId}/gateway/deposit/{walletId} /network-fee](/es/api-reference/gateway/child-address-deposit-network-fee) – Obtener estimación de tarifa de red de depósito para dirección secundaria

* [POST /addresses/{addressId}/gateway/withdraw/network-fee](/es/api-reference/gateway/child-address-withdraw-network-fee) – Obtener estimación de tarifa de red de retiro para dirección secundaria

<Note>
  {" "}

  NO envíes USDC directamente al contrato de la Billetera de Gateway usando una transferencia de token estándar—esto
  resultará en pérdida permanente de fondos. Solo usa los métodos oficiales de la API para depósitos.{" "}
</Note>

<Note>
  {" "}

  * Gateway muestra las tarifas de red antes del depósito o retiro; las tarifas se deducen
    del saldo de tu billetera principal.{" "}
</Note>

***

## Descripción General del Panel de Control

El panel de control de Gateway proporciona una interfaz de usuario intuitiva para gestionar tu saldo unificado de USDC. Puedes crear reglas, monitorear saldos y configurar preferencias de liquidación sin tocar la API.

<img className="gateway-dashboard" src="https://mintcdn.com/blockradar/fWg7SGpNBqmitg8P/images/gateway-dashboard1.png?fit=max&auto=format&n=fWg7SGpNBqmitg8P&q=85&s=7532a0c2409bd1295d61b2fc33a436ac" alt="Gateway Dashboard" width="1440" height="1045" data-path="images/gateway-dashboard1.png" />

### Secciones clave del panel de control:

* **Billeteras** – Ver todas las billeteras vinculadas y sus saldos unificados
* **Transacciones** – Rastrear depósitos, retiros y actividad de liquidación.
* **Reglas de Gateway** – Configurar reglas de auto-liquidación para depósitos entrantes.

***

## Configuración de Auto Liquidación

Las reglas de Auto Liquidación permiten que los depósitos se conviertan automáticamente en un saldo unificado de USDC en tu cadena de destino elegida (por ejemplo, Base). Esto elimina la necesidad de intercambiar o puentear activos manualmente.
autosettlement-gateway1.png

<img className="gateway-autosettlement1" src="https://mintcdn.com/blockradar/fWg7SGpNBqmitg8P/images/autosettlement-gateway.png?fit=max&auto=format&n=fWg7SGpNBqmitg8P&q=85&s=182a6bb9fedd570c2bc5356ba2a595a3" alt="Autosettlement Config" width="1440" height="1045" data-path="images/autosettlement-gateway.png" />

### Por Qué Importa la Auto Liquidación

* **Reduce la fragmentación** – Todas las stablecoins entrantes se normalizan en USDC.
* **Ahorra tiempo** – No es necesario monitorear o convertir depósitos manualmente.
* **Gestión de riesgos** – Aplica tolerancia de deslizamiento y reglas para proteger contra malas ejecuciones.
* **Eficiencia operativa** – Asegura que tu tesorería siempre se encuentre en un único saldo abstraído de cadena.

***

## Creación de una Regla de Liquidación

Cada regla te permite definir cómo y cuándo se liquidan los depósitos entrantes:

<img className="gateway-autosettlement3" src="https://mintcdn.com/blockradar/fWg7SGpNBqmitg8P/images/autosettlement-gateway3.png?fit=max&auto=format&n=fWg7SGpNBqmitg8P&q=85&s=a00263fbcdc6276dc8f87bcbfa6fa452" alt="Autosettlement Config2" width="1440" height="1045" data-path="images/autosettlement-gateway3.png" />

* **Nombre de Regla** – Asigna a tu regla de liquidación un nombre descriptivo.
* **Cantidad Mín/Máx** – Controla el tamaño de los depósitos que activan la liquidación.
* **Tolerancia de Deslizamiento** – Protege contra alta volatilidad o mala ejecución.
* **Activo de Origen** – Elige qué activos auto-liquidar (por ejemplo, USDT, DAI).
* **Activo de Destino** – Típicamente USDC, unificado en Gateway.
* **Cadena de Destino** – Selecciona tu cadena objetivo (por ejemplo, Base).
* **Preferencia de Liquidación** – Optimiza para ejecución *Más Rápida*, *Más Barata* o *Más Segura*.

<img className="gateway-autosettlement5" src="https://mintcdn.com/blockradar/fWg7SGpNBqmitg8P/images/autosettlement-gateway5.png?fit=max&auto=format&n=fWg7SGpNBqmitg8P&q=85&s=cd8c46aad05819eee00312e580b3d2f2" alt="Autosettlement Config2" width="1440" height="1045" data-path="images/autosettlement-gateway5.png" />

Una vez guardadas, las reglas se aplican automáticamente a los depósitos que coincidan con tus criterios.

***

## Finalidad del Depósito

Al depositar en Gateway, los fondos se acreditan a tu saldo unificado solo después de que la transacción alcance la **finalidad** en la cadena de origen.
La finalidad depende de las reglas de consenso de cada cadena y las confirmaciones de bloque requeridas.

***

### Testnet

| Cadena               | Origen         | Destino        |
| -------------------- | -------------- | -------------- |
| **Avalanche Fuji**   | <span>✔</span> | <span>✔</span> |
| **Base Sepolia**     | <span>✔</span> | <span>✔</span> |
| **Ethereum Sepolia** | <span>✔</span> | <span>✔</span> |

<Note>
  Puedes obtener activos de prueba en los entornos de prueba listados
  [aquí](/es/essentials/wallets#entorno-de-prueba)
</Note>

### Mainnet

| Cadena        | Origen         | Destino        |
| ------------- | -------------- | -------------- |
| **Arbitrum**  | <span>✔</span> | <span>✔</span> |
| **Avalanche** | <span>✔</span> | <span>✔</span> |
| **Base**      | <span>✔</span> | <span>✔</span> |
| **Ethereum**  | <span>✔</span> | <span>✔</span> |
| **Optimism**  | <span>✔</span> | <span>✔</span> |
| **Polygon**   | <span>✔</span> | <span>✔</span> |

***

### Confirmaciones Requeridas y Tiempos de Finalidad

| Cadena        | Confirmaciones   | Tiempo Aproximado a Finalidad |
| ------------- | ---------------- | ----------------------------- |
| **Arbitrum**  | \~65 bloques ETH | \~13 a 19 minutos             |
| **Avalanche** | 1                | \~8 segundos                  |
| **Base**      | \~65 bloques ETH | \~13 a 19 minutos             |
| **Ethereum**  | \~65             | \~13–19 minutos               |
| **Optimism**  | \~65 bloques ETH | \~13 a 19 minutos             |
| **Polygon**   | \~2-3            | \~8 segundos                  |

***

<Note>
  Gateway solo acredita tu saldo **después de alcanzar la finalidad**. Asegúrate de
  tener en cuenta estos tiempos de confirmación al diseñar flujos orientados al usuario,
  especialmente si soportas tanto testnet como mainnet.
</Note>

<br /> ¡Feliz programación! ❤️