> ## 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

> Aprenda a gestionar USDC entre cadenas usando la función Gateway

<Note>
  En resumen<br />
  Gateway permite la gestión unificada de USDC en múltiples blockchains: deposite desde cualquier cadena, retire a cualquier cadena, todo desde un único saldo abstraído de la cadena. Sin puentes manuales 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 utilizar la API de Gateway, asegúrese de contar con:

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

  <Step title="Wallet compatible">
    Cree un master wallet en una cadena compatible con Gateway (Ethereum, Base, Polygon, Arbitrum, Optimism o Avalanche). Utilice la [API Crear Wallet](/en/api-reference/wallets/create-wallet) o el panel.
  </Step>

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

  <Step title="Token nativo para gas">
    Financie su wallet con tokens nativos (ETH, MATIC, AVAX) para cubrir las tarifas de red de las operaciones de depósito y retiro.
  </Step>
</Steps>

<Warning>
  NO envíe USDC directamente al contrato de Gateway Wallet utilizando una transferencia de token estándar; esto resultará en la pérdida permanente de fondos. Utilice únicamente los métodos oficiales de la API para los depósitos.
</Warning>

## Cómo funciona

Gateway le permite gestionar USDC sin problemas en todas las blockchains compatibles. Elimina la necesidad de puentes manuales, rebalanceo y fragmentación de liquidez, permitiéndole mover, depositar y retirar USDC al instante, desde cualquier cadena a cualquier cadena.

### Acciones admitidas:

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

* Retirar (acuñar) USDC al instante en cualquier otra blockchain compatible.

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

## Referencia de la API

### **Endpoints**

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

#### **Endpoints de Gateway para Master Wallet**

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

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

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

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

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

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

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

#### **Endpoints de Gateway para Direcciones Hijas**

Puede acceder a las funciones de Gateway directamente desde la página de la dirección hija en el panel:

<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="Gateway de dirección hija" width="3444" height="1908" data-path="images/child-address-gateway.png" />

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

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

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

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

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

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

<Note>
  {" "}

  NO envíe USDC directamente al contrato de Gateway Wallet utilizando una transferencia de token estándar;
  esto resultará en la pérdida permanente de fondos. Utilice únicamente los métodos oficiales de la API para los depósitos.{" "}
</Note>

<Note>
  {" "}

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

***

## Resumen del panel

El panel de Gateway proporciona una interfaz intuitiva para gestionar su saldo unificado de USDC. Puede crear reglas, monitorear saldos y configurar preferencias de liquidación sin necesidad de utilizar 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="Panel de Gateway" width="1440" height="1045" data-path="images/gateway-dashboard1.png" />

### Secciones clave del panel:

* **Wallets** – Visualice todas las wallets vinculadas y sus saldos unificados
* **Transacciones** – Realice un seguimiento de los depósitos, retiros y la actividad de liquidación.
* **Reglas de Gateway** – Configure reglas de liquidación automática para los depósitos entrantes.

***

## Configuración de liquidación automática

Las reglas de liquidación automática permiten que los depósitos se conviertan automáticamente en un saldo unificado de USDC en la cadena de destino que elija (por ejemplo, Base). Esto elimina la necesidad de intercambiar o crear puentes manualmente para los activos.
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="Configuración de liquidación automática" width="1440" height="1045" data-path="images/autosettlement-gateway.png" />

### Por qué es importante la liquidación automática

* **Reduce la fragmentación** – Todas las stablecoins entrantes se normalizan a USDC.
* **Ahorra tiempo** – No hay necesidad de monitorear o convertir manualmente los depósitos.
* **Gestión de riesgos** – Aplique tolerancia al deslizamiento y reglas para protegerse contra ejecuciones desfavorables.
* **Eficiencia operativa** – Garantiza que su tesorería siempre se encuentre en un único saldo abstraído de la cadena.

***

## Crear una regla de liquidación

Cada regla le 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="Configuración de liquidación automática 2" width="1440" height="1045" data-path="images/autosettlement-gateway3.png" />

* **Nombre de la regla** – Asigne un nombre descriptivo a su regla de liquidación.
* **Monto mínimo/máximo** – Controle el tamaño de los depósitos que activan la liquidación.
* **Tolerancia al deslizamiento** – Protege contra alta volatilidad o ejecución deficiente.
* **Activo de origen** – Elija qué activos liquidar automáticamente (por ejemplo, USDT, DAI).
* **Activo de destino** – Normalmente USDC, unificado en Gateway.
* **Cadena de destino** – Seleccione su cadena objetivo (por ejemplo, Base).
* **Preferencia de liquidación** – Optimice para una ejecución *Más rápida*, *Más económica* 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="Configuración de liquidación automática 2" width="1440" height="1045" data-path="images/autosettlement-gateway5.png" />

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

***

## Finalidad del depósito

Al depositar en Gateway, los fondos se acreditan a su 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 del número de 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>
  Puede obtener activos de prueba en los entornos de prueba listados
  [aquí](/en/essentials/wallets#test-environment)
</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 aprox. hasta la finalidad |
| ------------- | ------------------- | -------------------------------- |
| **Arbitrum**  | \~65 bloques de ETH | \~13 a 19 minutos                |
| **Avalanche** | 1                   | \~8 segundos                     |
| **Base**      | \~65 bloques de ETH | \~13 a 19 minutos                |
| **Ethereum**  | \~65                | \~13–19 minutos                  |
| **Optimism**  | \~65 bloques de ETH | \~13 a 19 minutos                |
| **Polygon**   | \~2-3               | \~8 segundos                     |

***

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

<br /> ¡Feliz desarrollo! ❤️