Hooks
useGetSwapQuote
Hook para obtener cotizaciones para un swap
Importar
Uso
Tipo de retorno: UseQueryResult<LifiSwapQuote>
El hook retorna todas las propiedades de UseQueryResult
de React Query con los datos de la cotización del swap. Aquí está la estructura detallada de swapQuote.
Propiedades
data
SwapQuote | undefined
El objeto de cotización de swap contiene:
currencyAddress
: Dirección de la moneda a intercambiarcurrencyBalance
: Balance de la moneda en el wallet del usuarioprice
: El precio actual para el swapmaxPrice
: Precio máximo permitido para el swap (incluye slippage)to
: La dirección del contrato de destino que gestiona el swaptransactionData
: Datos codificados de la transacción para ejecutar el swaptransactionValue
: El valor que se enviará con la transacción (para tokens nativos)approveData
: Datos codificados de la transacción de aprobación (si includeApprove es true y es necesario)amount
: La cantidad de moneda a recibiramountMin
: La cantidad mínima a recibir después del slippage
isLoading
boolean
Estado de carga para la obtención de datos.
isError
boolean
Estado de error que indica si la consulta falló.
error
Error | null
Cualquier error que ocurrió durante la obtención de datos.
Parámetros
El hook acepta dos parámetros:
args: GetLifiSwapQuoteArgs
Parámetro | Type | Description |
---|---|---|
params.chainId | number | El chain ID donde se realizará el swap |
params.walletAddress | string | La dirección del wallet del usuario |
params.fromTokenAddress | string | La dirección del token a vender |
params.toTokenAddress | string | La dirección del token a comprar |
params.fromTokenAmount | string | (Opcional) La cantidad de token a vender (en wei) |
params.toTokenAmount | string | (Opcional) La cantidad de token a comprar (en wei) |
params.includeApprove | boolean | Indica si se deben incluir los datos de la transacción de aprobación |
params.slippageBps | number | Slippage máximo permitido en puntos base (100 = 1%) |
Nota: Debe proporcionar fromTokenAmount
o toTokenAmount
, pero no ambos.
options: HooksOptions
Parámetro | Type | Description |
---|---|---|
disabled | boolean | (Opcional) Deshabilitar la consulta para que no se ejecute automáticamente |
retry | boolean | (Opcional) Indica si se deben reintentar las consultas fallidas (por defecto es true) |