API de Swap

La API de Swap te permite intercambiar una stablecoin por otra directamente desde una billetera Blockradar. Los swaps pueden iniciarse desde una billetera maestra o una dirección secundaria.

Qué puedes hacer

Obtener una cotización para un swap antes de confirmar
Cotizar por monto de origen o monto de destino con amountSide
Ejecutar un swap entre activos soportados
Realizar swaps tanto desde billeteras maestras como desde direcciones secundarias
Enrutar destinos Stellar USDC compatibles con el contrato genérico recipientRouting

Endpoints

Método	Endpoint	Descripción
`POST`	`/v1/wallets/{walletId}/swaps/quote`	Obtener cotización de swap desde billetera maestra
`POST`	`/v1/wallets/{walletId}/swaps/execute`	Ejecutar swap desde billetera maestra
`POST`	`/v1/wallets/{walletId}/addresses/{addressId}/swaps/quote`	Obtener cotización de swap desde dirección secundaria
`POST`	`/v1/wallets/{walletId}/addresses/{addressId}/swaps/execute`	Ejecutar swap desde dirección secundaria

Parámetros del destinatario

Parámetro	Tipo	Obligatorio	Descripción
`recipientAddress`	string	No	Dirección externa del destinatario. Sigue siendo una cadena, incluso para direcciones Stellar `G...` y `M...`.
`recipientRouting`	object	No	Enrutamiento solo para Stellar: `{ type: "none" }` o `{ type: "memo_id", value: "<numeric string>" }`. No lo envíe a destinos EVM, Solana o Tron.

Enrutamiento de destinatarios Stellar

recipientRouting solo se admite cuando la cadena de destino es Stellar. Las solicitudes de swap existentes para EVM, Solana y Tron no cambian y no deben enviar recipientRouting; las solicitudes que lo incluyen se rechazan. No existe un parámetro separado de memo del destinatario. Para destinos Stellar USDC compatibles:

Destinatario muxed M...: omita recipientRouting. Su ID de enrutamiento ya está incorporado en la dirección; enviar datos de enrutamiento se rechaza.
Destinatario base G... con ID de enrutamiento: envíe recipientRouting: { type: "memo_id", value: "123" }. El valor debe ser una cadena numérica no vacía entre 0 y 18446744073709551615. Blockradar normaliza el destino a una dirección M... antes de solicitar la cotización o la ejecución.
Destinatario base G... sin ID de enrutamiento: envíe recipientRouting: { type: "none" } sin value. Un destinatario G... sin recipientRouting se rechaza. La cuenta base de destino ya debe tener una trustline de Stellar USDC antes de la cotización y la ejecución.
Wallet Stellar predeterminada de Blockradar: quien llama debe enviar explícitamente recipientRouting: { type: "none" }.

Stellar base account with a routing ID

{
  "recipientAddress": "G...",
  "recipientRouting": {
    "type": "memo_id",
    "value": "123"
  }
}

Stellar base account without a routing ID

{
  "recipientAddress": "G...",
  "recipientRouting": {
    "type": "none"
  }
}

Metadatos de la respuesta de cotización

Las respuestas de cotización pueden incluir data.recipientRouting para explicar el resultado del enrutamiento. Las respuestas de ejecución no incluyen estos metadatos.

{
  "recipientRouting": {
    "status": "embedded",
    "message": "The recipient routing ID is embedded in the normalized destination address."
  }
}

Migración desde campos específicos de Stellar

Campo anterior	Use en su lugar
`recipientMemoId`	`recipientRouting: { type: "memo_id", value: "<numeric string>" }`
`stellarMemoNotRequired: true`	`recipientRouting: { type: "none" }`

Referencia completa de la API

Consulta todos los endpoints de swap en la pestaña de Referencia de la API.

Comenzar

Billeteras

Recibir Pagos

Enviar Pagos

Convertir y Gestionar

Cumplimiento y Recuperación

Integraciones

Qué puedes hacer

Endpoints

Parámetros del destinatario

Enrutamiento de destinatarios Stellar

Metadatos de la respuesta de cotización

Migración desde campos específicos de Stellar

Referencia completa de la API

​Qué puedes hacer

​Endpoints

​Parámetros del destinatario

​Enrutamiento de destinatarios Stellar

​Metadatos de la respuesta de cotización

​Migración desde campos específicos de Stellar

Referencia completa de la API

Qué puedes hacer

Endpoints

Parámetros del destinatario

Enrutamiento de destinatarios Stellar

Metadatos de la respuesta de cotización

Migración desde campos específicos de Stellar