Transactions

En bref
Chaque dépôt, retrait, échange ou balayage qui transite par Blockradar crée un enregistrement de transaction. L’API Transactions est votre journal d’activité — utilisez-la pour consulter l’historique, enquêter sur des paiements spécifiques, rejouer des webhooks manqués, annuler des transactions en attente ou réessayer celles qui ont échoué.

Prérequis

Clé API

Obtenez votre clé API depuis le Tableau de bord Blockradar. Rendez-vous dans Developers pour en générer une.

Portefeuille Créé

Vous aurez besoin d’un walletId pour interroger les transactions. Créez-en un dans le tableau de bord (voir Créer un Portefeuille Principal).

Comment Ça Fonctionne

Lorsqu’un événement on-chain se produit sur un portefeuille Blockradar (un dépôt qui arrive, un retrait soumis, un balayage déclenché), Blockradar crée un enregistrement de transaction et envoie un webhook. L’API Transactions vous donne un accès programmatique à tous ces enregistrements.

Consulter l'historique

Récupérez toutes les transactions d’un portefeuille ou filtrez par adresse, actif, statut ou plage de dates.

Enquêter sur les paiements

Recherchez une transaction spécifique par ID pour vérifier son statut, son hash et ses métadonnées.

Rejouer les webhooks

Renvoyez un webhook pour une transaction que votre système a manquée ou échoué à traiter.

Annuler ou réessayer

Annulez une transaction en attente bloquée ou réessayez une transaction échouée sans tout soumettre à nouveau.

États des Transactions

Statut	Description
`PENDING`	Transaction soumise à la blockchain, en attente de confirmation
`SUCCESS`	Transaction confirmée et réglée
`FAILED`	Transaction échouée on-chain ou rejetée
`CANCELLED`	Transaction annulée avant d’être diffusée

Récupérer des Transactions

Obtenir toutes les transactions du portefeuille

GET /v1/wallets/{walletId}/transactions

Vous pouvez filtrer par adresse, actif, type, statut et plage de dates à l’aide des paramètres de requête.

Obtenir une seule transaction

GET /v1/wallets/{walletId}/transactions/{transactionId}

Exemple

const transactions = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/transactions?status=SUCCESS&limit=50`,
  {
    headers: { 'x-api-key': apiKey }
  }
).then(r => r.json());

console.log(transactions.data);

Rejouer un Webhook Manqué

Si votre système a manqué ou n’a pas réussi à traiter un webhook, vous pouvez déclencher un renvoi sans attendre un autre événement on-chain.

POST /v1/wallets/{walletId}/transactions/{transactionId}/resend-webhook

C’est utile pour les flux de rapprochement et pour récupérer après une indisponibilité.

Annuler une Transaction en Attente

Si une transaction est bloquée en PENDING et n’a pas encore été diffusée, vous pouvez l’annuler.

POST /v1/wallets/{walletId}/transactions/{transactionId}/cancel

L’annulation n’est possible qu’avant que la transaction soit diffusée sur la blockchain. Une fois on-chain, elle ne peut plus être annulée.

Réessayer une Transaction Échouée

Si une transaction a échoué à cause d’un gas insuffisant ou d’un problème temporaire de nœud, vous pouvez la réessayer.

POST /v1/wallets/{walletId}/transactions/{transactionId}/retry

Bonnes Pratiques

Utilisez les webhooks comme signal principal — ne sondez pas l’API Transactions pour les mises à jour en temps réel. Utilisez-la pour le rapprochement, les enquêtes et l’historique.
Stockez les IDs de transaction — enregistrez l’ID de transaction Blockradar avec vos enregistrements internes afin de pouvoir consulter le statut à tout moment.
Rejouez les webhooks après une indisponibilité — si votre endpoint de webhook était indisponible, utilisez l’endpoint de renvoi pour récupérer les événements manqués plutôt que de les retraiter manuellement.

Référence API

Endpoint	Description
Obtenir les transactions	Récupérer toutes les transactions d’un portefeuille
Obtenir une transaction	Récupérer une transaction par ID
Renvoyer un webhook	Rejouer un webhook pour une transaction
Déclencher un balayage	Déclencher manuellement un balayage
Annuler	Annuler une transaction en attente
Réessayer	Réessayer une transaction échouée

Démarrage

Portefeuilles

Encaissements

Paiements

Convertir et Gérer

Conformité et Outils

Prérequis

Comment Ça Fonctionne

Consulter l'historique

Enquêter sur les paiements

Rejouer les webhooks

Annuler ou réessayer

États des Transactions

Récupérer des Transactions

Obtenir toutes les transactions du portefeuille

Obtenir une seule transaction

Exemple

Rejouer un Webhook Manqué

Annuler une Transaction en Attente

Réessayer une Transaction Échouée

Bonnes Pratiques

Référence API

​Prérequis

​Comment Ça Fonctionne

Consulter l'historique

Enquêter sur les paiements

Rejouer les webhooks

Annuler ou réessayer

​États des Transactions

​Récupérer des Transactions

​Obtenir toutes les transactions du portefeuille

​Obtenir une seule transaction

​Exemple

​Rejouer un Webhook Manqué

​Annuler une Transaction en Attente

​Réessayer une Transaction Échouée

​Bonnes Pratiques

​Référence API

Prérequis

Comment Ça Fonctionne

États des Transactions

Récupérer des Transactions

Obtenir toutes les transactions du portefeuille

Obtenir une seule transaction

Exemple

Rejouer un Webhook Manqué

Annuler une Transaction en Attente

Réessayer une Transaction Échouée

Bonnes Pratiques

Référence API