# n8n-nodes-bitquery-api

![n8n.io - Workflow Automation](https://raw.githubusercontent.com/n8n-io/n8n/master/assets/n8n-logo.png)

Nœud n8n pour l'API Bitquery - Accès aux données blockchain multi-chaînes (Bitcoin, Ethereum, etc.)

[n8n](https://n8n.io/) est un outil d'automatisation de workflow libre et open-source. Ce package fournit un nœud personnalisé pour intégrer l'API Bitquery dans vos workflows n8n.

## Installation

### Installation via l'interface n8n

1. Allez dans **Settings** > **Community Nodes**
2. Cliquez sur **Install**
3. Entrez `n8n-nodes-bitquery-api`
4. Cliquez sur **Install**

### Installation manuelle

```bash
npm install n8n-nodes-bitquery-api
```

## Configuration

### Clé API

Ce nœud nécessite une clé API Bitquery pour fonctionner :

1. Créez un compte sur [Bitquery](https://bitquery.io/)
2. Obtenez votre clé API depuis votre tableau de bord
3. Configurez la clé API dans le nœud

## Opérations

Le nœud Mempool.space API prend en charge les opérations suivantes :

### Mempool Live
- **Get Mempool Live** : Récupère les statistiques en temps réel du mempool
- **Get Recommended Fees** : Récupère les frais recommandés pour les transactions
- **Get Difficulty Adjustment** : Récupère les informations sur l'ajustement de difficulté

### Prix Bitcoin
- **Get Bitcoin Price** : Récupère le prix actuel du Bitcoin dans plusieurs devises
- **Get Historical Price** : Récupère le prix historique du Bitcoin pour une devise et un timestamp spécifiques

### Détails des Blocs & Transactions
- **Get Transaction** : Récupère les détails d'une transaction spécifique
- **Get Transaction Status** : Récupère le statut de confirmation d'une transaction
- **Get Address Info** : Récupère les informations d'une adresse Bitcoin
- **Get Address Transactions** : Récupère l'historique des transactions d'une adresse
- **Get Address UTXO** : Récupère les UTXO (Unspent Transaction Outputs) d'une adresse
- **Get Block Info** : Récupère les informations d'un bloc par hash ou hauteur
- **Get Latest Blocks** : Récupère les derniers blocs minés
- **Broadcast Transaction** : Diffuse une transaction brute sur le réseau Bitcoin

## Configuration

Aucune clé API n'est nécessaire pour utiliser les endpoints publics de Mempool.space.

## Documentation API

Pour plus d'informations sur l'API Mempool.space, consultez la [documentation officielle](https://mempool.space/docs/api/rest).

## Compatibilité

Ce nœud est compatible avec n8n version 0.87.0 et ultérieures.

## Licence

[MIT](https://github.com/GitCryptoDevOps/n8n-nodes-mempool-api/blob/main/LICENSE.md)

## Utilisation

1. Ajoutez le nœud "Blockstream API (Esplora)" à votre workflow n8n
2. Sélectionnez le réseau souhaité (Mainnet, Testnet, Liquid, etc.)
3. Choisissez l'opération à effectuer
4. Remplissez les paramètres requis (ID de transaction, adresse, hash de bloc, etc.)
5. Exécutez le workflow

## API Blockstream (Esplora)

Ce nœud utilise l'API publique Blockstream basée sur Esplora :

- **Bitcoin Mainnet** : `https://blockstream.info/api/`
- **Bitcoin Testnet** : `https://blockstream.info/testnet/api/`
- **Liquid** : `https://blockstream.info/liquid/api/`
- **Liquid Testnet** : `https://blockstream.info/liquidtestnet/api/`

### Avantages

- ✅ Aucune clé API requise
- ✅ Accès gratuit aux données Bitcoin
- ✅ API REST simple et fiable
- ✅ Support de plusieurs réseaux
- ✅ Données en temps réel

## Documentation API

Pour plus d'informations sur l'API Blockstream (Esplora), consultez la documentation officielle :
https://github.com/Blockstream/esplora/blob/master/API.md

## Exemples d'utilisation

### Récupérer une transaction
- Opération : "Get Transaction"
- Transaction ID : `f4184fc596403b9d638783cf57adfe4c75c605f6356fbc91338530e9831e9e16`

### Vérifier les UTXO d'une adresse
- Opération : "Get Address UTXO"
- Adresse : `1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa`

### Obtenir les statistiques du mempool
- Opération : "Get Mempool Stats"

### Surveiller une adresse Bitcoin
```
Blockstream API (Get Address Info) → Condition (si nouveau solde) → Notification
```

### Vérifier le statut d'une transaction
```
Blockstream API (Get Transaction Status) → Condition (si confirmée) → Action
```

### Analyser les UTXO
```
Blockstream API (Get Address UTXO) → Traitement → Rapport
```

## Configuration

Aucune configuration ou clé API n'est requise. Le nœud utilise directement l'API publique Blockstream.

## Gestion d'erreurs

- Continuation en cas d'erreur (configurable)
- Messages d'erreur détaillés avec codes de statut HTTP
- Validation automatique des paramètres d'entrée

## Licence

MIT

## Support

Pour signaler des bugs ou demander des fonctionnalités, veuillez utiliser le système d'issues GitHub.

## Tests

Exécutez les tests pour vérifier la connectivité :

```bash
# Test du nœud Binance
node test-binance-node.js

# Test de validation des credentials
node test-credential-validation.js

# Test de compatibilité n8n
node test-n8n-compatibility.js
```

## Dépannage

Consultez le fichier [TROUBLESHOOTING.md](./TROUBLESHOOTING.md) pour les problèmes courants et leurs solutions.

## Développement

### Structure du projet
```
├── credentials/           # Définitions des credentials
├── nodes/                # Nœuds n8n
│   └── Binance/         # Nœud Binance
├── test-*.js            # Scripts de test
└── dist/                # Fichiers compilés
```

### Build
```bash
npm run build
```

### Développement
```bash
npm run dev
```

## Support

Pour le support et les questions, veuillez ouvrir une issue sur le [repository GitHub](https://github.com/GitCryptoDevOps/n8n-nodes-binance).

## Licence

MIT

## Changelog

### v0.3.0
- 🎯 Package dédié exclusivement à Binance
- ✨ 84 opérations Binance disponibles
- 📊 Support complet des données de marché
- 💼 Gestion complète de compte
- 📈 Trading spot avancé
- 🔄 Ordres OCO, OTO, OTOCO
- 💰 Trading sur marge
- 💎 Simple Earn (épargne)
- 🔄 Conversion de cryptomonnaies
- 👥 Gestion des sous-comptes
- 💳 Portefeuille et capital

### v0.2.0
- ✨ Ajout du nœud Binance avec 7 opérations
- 🔧 Enrichissement automatique des données
- 📚 Documentation complète

### v0.1.0
- 🎉 Version initiale