n8n-nodes-santiment

Custom n8n node for Santiment API integration. This package includes a node for the Santiment API, allowing you to access cryptocurrency market data, on-chain metrics, and social analytics.

Features

• Get Price Data: Get historical price data for cryptocurrencies
• Get Development Activity: Track GitHub development activity metrics
• Get Social Volume: Access social media mentions and sentiment data
• Get On-Chain Data: Get blockchain metrics like active addresses
• Get Project List: Access details about cryptocurrency projects
• Execute Custom Query: Execute custom GraphQL queries for advanced use cases
• Flexible Date Formats: Support for multiple date formats (YYYY-MM-DD, DD-MM-YYYY, YYYY/MM/DD, relative dates)

Installation

npm install @cryptodevops/n8n-nodes-santiment

Configuration

Santiment API

1. Get your Santiment API Key from Santiment Account Page
2. In n8n, create new credentials for "Santiment API"
3. Enter your API Key in the API Key field

Santiment Free Tier

• Limited historical data (typically 30-90 days)
• Limited number of API calls
• Restricted access to certain metrics

Available Operations

Santiment Operations

• Get Price Data (getPriceData): Get price data for a cryptocurrency
• Get Development Activity (getDevActivity): Get development activity metrics
• Get Social Volume (getSocialVolume): Get social media mentions and volume
• Get On-Chain Data (getOnChainData): Get on-chain metrics like active addresses
• Get Project List (getProjectList): Get list of available projects
• Execute Custom Query (executeCustomQuery): Run custom GraphQL queries

Supported Date Formats

The node supports multiple date formats for the fromDate and toDate parameters:

• ISO Format: 2023-01-01T00:00:00Z (standard format accepted by Santiment API)
• YYYY-MM-DD: 2023-01-01 (automatically converted to ISO format)
• DD-MM-YYYY: 01-01-2023 (automatically converted to ISO format)
• YYYY/MM/DD: 2023/01/01 (automatically converted to ISO format)
• Relative Dates: utc_now-30d, utc_now (directly supported by Santiment API)

Usage Examples

Get Price Data for Bitcoin

{
  "operation": "getPriceData",
  "slug": "bitcoin",
  "fromDate": "utc_now-30d",
  "toDate": "utc_now",
  "interval": "1d"
}

Get Development Activity for Ethereum

{
  "operation": "getDevActivity",
  "slug": "ethereum",
  "fromDate": "utc_now-30d",
  "toDate": "utc_now",
  "interval": "1d"
}

Get Social Volume for Bitcoin

{
  "operation": "getSocialVolume",
  "slug": "bitcoin",
  "fromDate": "utc_now-30d",
  "toDate": "utc_now-23d",
  "interval": "1d"
}

Get On-Chain Data (Daily Active Addresses)

{
  "operation": "getOnChainData",
  "slug": "bitcoin",
  "fromDate": "utc_now-30d",
  "toDate": "utc_now-23d",
  "interval": "1d"
}

Get Project List

{
  "operation": "getProjectList",
  "page": 1,
  "pageSize": 20
}

Execute Custom GraphQL Query

{
  "operation": "executeCustomQuery",
  "query": "{ allProjects(page: 1, pageSize: 5) { slug name ticker } }"
}

API Documentation

For more information about the Santiment API, visit:

• Santiment API Documentation
• Santiment GraphQL Explorer
• Santiment Metrics List

Tests

Des tests complets ont été réalisés pour valider l'authentification et les fonctionnalités de l'API Santiment. Pour plus d'informations sur les tests disponibles et comment les exécuter, consultez les fichiers suivants :

• README-SANTIMENT-TESTS.md - Tests des fonctionnalités de l'API Santiment
• README-SANTIMENT.md - Documentation détaillée du nœud Santiment et scripts de test

License

MIT

Support

For issues and feature requests, please visit our GitHub repository.