API de Swap

A API de Swap permite trocar uma stablecoin por outra diretamente a partir de uma carteira Blockradar. Swaps podem ser iniciados a partir de uma carteira principal ou de um endereço filho.

O que você pode fazer

Obter uma cotação para um swap antes de confirmar
Cotar por valor de origem ou valor de destino com amountSide
Executar um swap entre ativos suportados
Realizar swaps a partir de carteiras principais e endereços filhos
Rotear destinos Stellar USDC compatíveis com o contrato genérico recipientRouting

Endpoints

Método	Endpoint	Descrição
`POST`	`/v1/wallets/{walletId}/swaps/quote`	Obter cotação de swap da carteira principal
`POST`	`/v1/wallets/{walletId}/swaps/execute`	Executar swap da carteira principal
`POST`	`/v1/wallets/{walletId}/addresses/{addressId}/swaps/quote`	Obter cotação de swap do endereço filho
`POST`	`/v1/wallets/{walletId}/addresses/{addressId}/swaps/execute`	Executar swap do endereço filho

Parâmetros do destinatário

Parâmetro	Tipo	Obrigatório	Descrição
`recipientAddress`	string	Não	Endereço externo do destinatário. Continua sendo uma string, inclusive para endereços Stellar `G...` e `M...`.
`recipientRouting`	object	Não	Roteamento somente para Stellar: `{ type: "none" }` ou `{ type: "memo_id", value: "<numeric string>" }`. Não o envie para destinos EVM, Solana ou Tron.

Roteamento de destinatário Stellar

recipientRouting só é compatível quando a blockchain de destino é Stellar. As solicitações de swap existentes para EVM, Solana e Tron não mudam e não devem enviar recipientRouting; solicitações que o incluírem são rejeitadas. Não existe um parâmetro separado de memo do destinatário. Para destinos Stellar USDC compatíveis:

Destinatário muxed M...: omita recipientRouting. O ID de roteamento já está incorporado no endereço; enviar dados de roteamento é rejeitado.
Destinatário base G... com ID de roteamento: envie recipientRouting: { type: "memo_id", value: "123" }. O valor deve ser uma string numérica não vazia entre 0 e 18446744073709551615. A Blockradar normaliza o destino para um endereço M... antes de solicitar a cotação ou a execução.
Destinatário base G... sem ID de roteamento: envie recipientRouting: { type: "none" } sem value. Um destinatário G... sem recipientRouting é rejeitado. A conta base de destino já precisa ter uma trustline de Stellar USDC antes da cotação e da execução.
Carteira Stellar padrão da Blockradar: é preciso enviar explicitamente 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"
  }
}

Metadados da resposta de cotação

As respostas de cotação podem incluir data.recipientRouting para explicar o resultado do roteamento. As respostas de execução não incluem esses metadados.

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

Migração de campos específicos de Stellar

Campo anterior	Use em vez disso
`recipientMemoId`	`recipientRouting: { type: "memo_id", value: "<numeric string>" }`
`stellarMemoNotRequired: true`	`recipientRouting: { type: "none" }`

Referência Completa da API

Veja todos os endpoints de swap na aba Referência da API.

Começar

Carteiras

Receber Pagamentos

Enviar Pagamentos

Converter e Gerenciar

Conformidade e Recuperação

Integrações

O que você pode fazer

Endpoints

Parâmetros do destinatário

Roteamento de destinatário Stellar

Metadados da resposta de cotação

Migração de campos específicos de Stellar

Referência Completa da API

​O que você pode fazer

​Endpoints

​Parâmetros do destinatário

​Roteamento de destinatário Stellar

​Metadados da resposta de cotação

​Migração de campos específicos de Stellar

Referência Completa da API

O que você pode fazer

Endpoints

Parâmetros do destinatário

Roteamento de destinatário Stellar

Metadados da resposta de cotação

Migração de campos específicos de Stellar