What is Lunarcrush Adapter

The lunarcrush-adapter is an API adapter designed for the INTUE ecosystem of Model Context Protocols (MCPs), enabling seamless integration with the LunarCrush platform to access cryptocurrency social intelligence data.

Use cases

Use cases include fetching coin data, retrieving social metrics for cryptocurrencies, analyzing sentiment scores, and identifying top coins within specific ecosystems such as AI.

How to use

To use the lunarcrush-adapter, install it via npm with ‘npm install @intue/lunarcrush-adapter’, initialize it with your LunarCrush API key, and call its methods to fetch various cryptocurrency data and metrics.

Key features

Key features include complete API coverage for all LunarCrush endpoints, smart authentication management, intelligent caching to reduce API calls, robust error handling, development-friendly mock data, and intelligent ecosystem categorization.

Where to use

The lunarcrush-adapter can be used in cryptocurrency applications, trading platforms, data analytics tools, and any project that requires social metrics and insights from the LunarCrush API.

INTUE LunarCrush Adapter

A comprehensive adapter for the LunarCrush API, providing seamless integration with the INTUE ecosystem.

Overview

The LunarCrush Adapter allows INTUE’s Model Context Protocols (MCPs) to leverage LunarCrush’s powerful crypto social intelligence. This adapter handles authentication, data fetching, caching, and error handling, providing a consistent interface for all LunarCrush API endpoints.

Installation

npm install @intue/lunarcrush-adapter

Features

• Complete API Coverage: Access to all LunarCrush endpoints
• Authentication Management: Smart handling of API keys and rate limits
• Intelligent Caching: Optimized data caching to minimize API calls
• Error Handling: Robust error handling with fallback strategies
• Mock Data: Development-friendly mock data for testing
• Category Mapping: Intelligent ecosystem categorization

Usage

Basic Usage

const { LunarCrushAdapter } = require('@intue/lunarcrush-adapter');

// Initialize with your API key
const lunarcrush = new LunarCrushAdapter({
  apiKey: 'YOUR_LUNARCRUSH_API_KEY'
});

// Get coin data
async function getCoinData() {
  const bitcoinData = await lunarcrush.getCoinData('bitcoin');
  console.log('Bitcoin data:', bitcoinData);
}

getCoinData();

Fetching Sentiment Data

// Get social metrics for Bitcoin
const metrics = await lunarcrush.getSocialMetrics('bitcoin', 7); // 7 days

console.log('Sentiment score:', metrics.sentiment);
console.log('Social volume:', metrics.socialVolume);
console.log('Engagement:', metrics.engagement);

Working with Ecosystems

// Get top coins in the AI ecosystem
const aiCoins = await lunarcrush.getEcosystemCoins('ai-agents', 10);
console.log('Top AI tokens:', aiCoins);

API Reference

Constructor Options

• apiKey: Your LunarCrush API key
• cache: Optional custom cache instance (defaults to internal cache)
• ttl: Optional cache TTL in milliseconds (defaults to 5 minutes)

Methods

• getCoinsList(limit): Get list of top coins
• getCoinData(coin): Get detailed data for a specific coin
• getTimeSeries(coin, interval, limit): Get historical data
• getTopicSentiment(topic, days): Get sentiment for a specific topic
• getEcosystemCoins(ecosystem, limit): Get coins in a specific ecosystem
• getSocialMetrics(coin, days): Get comprehensive social metrics

Related Packages

• @intue/core - Core utilities for the INTUE ecosystem
• @intue/sentiment-analysis-mcp - Sentiment analysis MCP

License

MIT