@cryptodevops/n8n-nodes-defillama/README.md

Custom n8n node for DefiLlama API - Access DeFi protocols data, TVL, yields, and chain analytics

# n8n-nodes-defillama

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

Un nœud n8n personnalisé pour accéder aux données DeFi via l'API DefiLlama. Ce nœud permet d'obtenir des informations sur les protocoles DeFi, la TVL (Total Value Locked), les rendements, et les analyses de chaînes blockchain.

## 🚀 Fonctionnalités

### Ressources disponibles

#### 📊 Protocoles
- **Lister tous les protocoles** : Obtenez la liste de tous les protocoles DeFi avec leurs données TVL
- **Détails d'un protocole** : Informations détaillées sur un protocole spécifique
- **TVL d'un protocole** : Valeur totale verrouillée actuelle d'un protocole

#### ⛓️ Chaînes blockchain
- **Lister toutes les chaînes** : Obtenez toutes les chaînes blockchain avec leurs données TVL
- **TVL historique d'une chaîne** : Données TVL historiques pour une chaîne spécifique

#### 💰 TVL Global
- **TVL historique global** : Données TVL historiques pour toutes les chaînes combinées

#### 🌾 Rendements (Yield)
- **Pools de rendement** : Opportunités de yield farming à travers les protocoles

### 🤖 Mode Agent IA

Le nœud inclut un mode spécialement optimisé pour les agents IA qui :
- Simplifie les données de sortie
- Génère des résumés lisibles par l'humain
- Structure les données pour une meilleure compréhension par l'IA
- Inclut des métadonnées utiles

### 🔧 Filtres et options

- **Filtrage par TVL minimum** : Pour les protocoles
- **Filtrage par APY minimum** : Pour les pools de rendement
- **Filtrage par chaîne** : Pour les pools de rendement
- **Pools stablecoins uniquement** : Option pour ne récupérer que les pools de stablecoins
- **Limitation des résultats** : Contrôlez le nombre de résultats retournés

## 📦 Installation

```bash
npm install @cryptodevops/n8n-nodes-defillama
```

## 🧪 Testing

Before deploying to your n8n instance, you can test the DefiLlama APIs locally:

### Quick API Test
```bash
# Test a specific endpoint
node quick-test.js protocols
node quick-test.js yields
node quick-test.js protocol/uniswap
```

### Full API Testing
```bash
# Run all tests
node test-defillama.js

# Run specific test category
node test-defillama.js protocols
node test-defillama.js yield
```

### n8n Simulation
```bash
# Simulate n8n node behavior
node test-n8n-simulation.js
```

### n8n Connection Test
```bash
# Test connectivity to your n8n instance
node test-n8n-connection.js http://your-ec2-instance:5678
```

See [TEST-README.md](TEST-README.md) for detailed testing documentation.

## 🔑 Configuration

### Credentials (Optionnel)

L'API DefiLlama fonctionne sans authentification pour la plupart des endpoints. Cependant, pour accéder à certaines fonctionnalités premium, vous pouvez configurer une clé API :

1. Allez dans n8n → Credentials
2. Créez une nouvelle credential "DefiLlama API"
3. Entrez votre clé API DefiLlama (optionnel)

## 🎯 Exemples d'utilisation

### Obtenir les top 10 protocoles DeFi

```json
{
  "resource": "protocol",
  "operation": "listProtocols",
  "additionalFields": {
    "maxResults": 10,
    "minTvl": 1000000
  }
}
```

### Obtenir les détails d'Aave

```json
{
  "resource": "protocol",
  "operation": "getProtocol",
  "protocolSlug": "aave"
}
```

### Trouver les meilleurs rendements sur Ethereum

```json
{
  "resource": "yield",
  "operation": "getYieldPools",
  "additionalFields": {
    "chainFilter": "ethereum",
    "minApy": 5,
    "maxResults": 20
  }
}
```

### Mode Agent IA activé

```json
{
  "resource": "protocol",
  "operation": "listProtocols",
  "additionalFields": {
    "aiMode": true,
    "includeSummary": true,
    "maxResults": 5
  }
}
```

## 📊 Format des données

### Protocoles
```json
{
  "name": "Aave",
  "tvl": 12500000000,
  "tvl_formatted": "$12.50B",
  "category": "Lending",
  "chains": ["Ethereum", "Polygon", "Arbitrum"],
  "_metadata": {
    "resource": "protocol",
    "operation": "listProtocols",
    "fetched_at": "2024-01-15T10:30:00.000Z"
  }
}
```

### Pools de rendement
```json
{
  "project": "Aave",
  "symbol": "USDC",
  "apy": 8.5,
  "apy_formatted": "8.50%",
  "tvl": 50000000,
  "tvl_formatted": "$50.00M",
  "chain": "Ethereum",
  "stablecoin": true,
  "_metadata": {
    "resource": "yield",
    "operation": "getYieldPools",
    "fetched_at": "2024-01-15T10:30:00.000Z"
  }
}
```

## 🔗 Endpoints API utilisés

- **Protocoles** : `https://api.llama.fi/protocols`
- **Détails protocole** : `https://api.llama.fi/protocol/{slug}`
- **TVL protocole** : `https://api.llama.fi/tvl/{slug}`
- **Chaînes** : `https://api.llama.fi/chains`
- **TVL chaîne** : `https://api.llama.fi/v2/historicalChainTvl/{chain}`
- **TVL historique** : `https://api.llama.fi/v2/historicalChainTvl`
- **Rendements** : `https://yields.llama.fi/pools`

## 🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

1. Fork le projet
2. Créer une branche pour votre fonctionnalité
3. Commiter vos changements
4. Pousser vers la branche
5. Ouvrir une Pull Request

## 📄 Licence

MIT

## 🔗 Liens utiles

- [Documentation DefiLlama API](https://defillama.com/docs/api) <mcreference link="https://defillama.com/docs/api" index="1">1</mcreference>
- [Site web DefiLlama](https://defillama.com/) <mcreference link="https://defillama.com/" index="5">5</mcreference>
- [Documentation n8n](https://docs.n8n.io/)

## 🆘 Support

Pour toute question ou problème :

1. Vérifiez la [documentation DefiLlama](https://defillama.com/docs/api) <mcreference link="https://defillama.com/docs/api" index="1">1</mcreference>
2. Consultez les issues GitHub
3. Contactez-nous à contact@cryptodevops.com

---

**Note** : Ce nœud n8n est un projet communautaire et n'est pas officiellement affilié à DefiLlama ou n8n.io.