API Swap

L’API Swap vous permet d’échanger un stablecoin contre un autre directement depuis un portefeuille Blockradar. Les swaps peuvent être initiés depuis un portefeuille principal ou une adresse enfant.

Ce que vous pouvez faire

Obtenir un devis pour un swap avant de le confirmer
Obtenir un devis par montant source ou montant de destination avec amountSide
Exécuter un swap entre les actifs pris en charge
Effectuer des swaps depuis les portefeuilles principaux et les adresses enfants
Router les destinations Stellar USDC prises en charge avec le contrat générique recipientRouting

Points de terminaison

Méthode	Point de terminaison	Description
`POST`	`/v1/wallets/{walletId}/swaps/quote`	Obtenir un devis swap depuis le portefeuille principal
`POST`	`/v1/wallets/{walletId}/swaps/execute`	Exécuter un swap depuis le portefeuille principal
`POST`	`/v1/wallets/{walletId}/addresses/{addressId}/swaps/quote`	Obtenir un devis swap depuis une adresse enfant
`POST`	`/v1/wallets/{walletId}/addresses/{addressId}/swaps/execute`	Exécuter un swap depuis une adresse enfant

Paramètres du destinataire

Paramètre	Type	Requis	Description
`recipientAddress`	string	Non	Adresse externe du destinataire. Elle reste une chaîne de caractères, y compris pour les adresses Stellar `G...` et `M...`.
`recipientRouting`	object	Non	Routage uniquement pour Stellar : `{ type: "none" }` ou `{ type: "memo_id", value: "<numeric string>" }`. Ne l’envoyez pas vers des destinations EVM, Solana ou Tron.

Routage du destinataire Stellar

recipientRouting est pris en charge uniquement lorsque la chaîne de destination est Stellar. Les requêtes de swap existantes vers EVM, Solana et Tron restent inchangées et ne doivent pas envoyer recipientRouting ; les requêtes qui l’incluent sont rejetées. Il n’existe pas de paramètre de mémo de destinataire distinct. Pour les destinations Stellar USDC prises en charge :

Destinataire muxed M... : omettez recipientRouting. Son identifiant de routage est déjà intégré dans l’adresse ; l’envoi de données de routage est rejeté.
Destinataire de base G... avec identifiant de routage : envoyez recipientRouting: { type: "memo_id", value: "123" }. value doit être une chaîne numérique non vide comprise entre 0 et 18446744073709551615. Blockradar normalise la destination en adresse M... avant de demander le devis ou l’exécution.
Destinataire de base G... sans identifiant de routage : envoyez recipientRouting: { type: "none" } sans value. Un destinataire G... sans recipientRouting est rejeté. Le compte de base de destination doit déjà avoir une trustline Stellar USDC avant le devis et l’exécution.
Portefeuille Stellar Blockradar par défaut : les appelants doivent envoyer explicitement 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"
  }
}

Métadonnées de la réponse de devis

Les réponses de devis peuvent inclure data.recipientRouting pour expliquer le résultat du routage. Les réponses d’exécution n’incluent pas ces métadonnées.

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

Migration depuis les champs spécifiques à Stellar

Ancien champ	Utilisez à la place
`recipientMemoId`	`recipientRouting: { type: "memo_id", value: "<numeric string>" }`
`stellarMemoNotRequired: true`	`recipientRouting: { type: "none" }`

Référence API complète

Consultez tous les points de terminaison swap dans l’onglet Référence API.

Démarrage

Portefeuilles

Encaissements

Paiements

Convertir et Gérer

Conformité et Outils

Ce que vous pouvez faire

Points de terminaison

Paramètres du destinataire

Routage du destinataire Stellar

Métadonnées de la réponse de devis

Migration depuis les champs spécifiques à Stellar

Référence API complète

​Ce que vous pouvez faire

​Points de terminaison

​Paramètres du destinataire

​Routage du destinataire Stellar

​Métadonnées de la réponse de devis

​Migration depuis les champs spécifiques à Stellar

Référence API complète

Ce que vous pouvez faire

Points de terminaison

Paramètres du destinataire

Routage du destinataire Stellar

Métadonnées de la réponse de devis

Migration depuis les champs spécifiques à Stellar