🚀 TokenMetrics Plugin for ElizaOS

🎯 Comprehensive Cryptocurrency Analysis Plugin

Professional-grade crypto market data, AI insights, and trading signals for ElizaOS agents

🌟 Overview

The TokenMetrics plugin provides complete integration with the TokenMetrics API, offering 21 comprehensive endpoints for cryptocurrency analysis, trading signals, and AI-powered market insights. Built specifically for ElizaOS agents with natural language processing capabilities.

🎯 Perfect for: Trading bots, portfolio management agents, research assistants, and crypto analysis tools.

⚡ Quick Start

# 1️⃣ Install the plugin
npm install @elizaos/plugin-tokenmetrics

# 2️⃣ Get your TokenMetrics API key from https://app.tokenmetrics.com/en/api?tab=api

# 3️⃣ Set up environment variables
# Create a .env file in your project root:
echo "TOKENMETRICS_API_KEY=your_api_key_here" >> .env

# 4️⃣ Add to your ElizaOS character config
{
  "plugins": ["@elizaos/plugin-tokenmetrics"],
  "settings": {
    "secrets": {
      "TOKENMETRICS_API_KEY": process.env.TOKENMETRICS_API_KEY
    }
  }
}

# 5️⃣ Start asking questions!
"What's Bitcoin's price and trading signals?"
"Show me crypto indices data"
"What are the holdings of index 1?"

🏆 Key Benefits

Why Choose This Plugin?

Feature	Benefit	Icon
Most Comprehensive	21 endpoints vs typical 3-5 in other crypto plugins	🔥
AI-Powered	Natural language understanding + TokenMetrics AI integration	🧠
Professional Grade	Investment-grade analysis, not just raw data	📊
Zero Learning Curve	Natural language queries, no API knowledge needed	⚡
Context Aware	Remembers conversations and user preferences	🔄
Production Ready	Enterprise-level error handling and reliability	🛡️

✨ Features

🏆 Core Market Data

🪙 Token Discovery: Search and filter 5000+ cryptocurrencies
💰 Real-time Prices: Live cryptocurrency price data with 24h changes
👑 Market Cap Rankings: Top cryptocurrencies by market capitalization
📡 Trading Signals: AI-generated BUY/SELL/HOLD recommendations with confidence scores
📊 Market Metrics: Overall market sentiment, volume, and trend analysis
📉 Technical Analysis: Resistance/support levels, OHLCV data (hourly/daily)
🎯 Investment Grades: Long-term investment recommendations (percentage-based scoring)
⚠️ Risk Assessment: Quantitative risk metrics, volatility analysis, and risk scores
😊 Sentiment Analysis: Social media and news sentiment from Twitter, Reddit, News
🔗 Correlation Analysis: Portfolio diversification insights and correlation matrices
📉 Hourly Trading Signals: Frequent AI signals for active trading and scalping
🔢 Quantmetrics: Risk metrics (Sharpe ratio, volatility, max drawdown)
🌍 Market Metrics: Overall market sentiment and dominance data

📈 Advanced Analysis

📉 Technical Analysis: Resistance/support levels, OHLCV data (hourly/daily)
🎯 Investment Grades: Long-term investment recommendations (percentage-based scoring)
⚠️ Risk Assessment: Quantitative risk metrics, volatility analysis, and risk scores
😊 Sentiment Analysis: Social media and news sentiment from Twitter, Reddit, News
🔗 Correlation Analysis: Portfolio diversification insights and correlation matrices

🆕 NEW: Crypto Indices Features

📊 Crypto Indices: Access to active and passive crypto index funds
🏦 Index Holdings: Detailed composition and allocation weights for each index
📈 Index Performance: Historical performance data, returns, and volatility metrics

🤖 AI-Powered Features

📝 AI Reports: Comprehensive AI-generated market analysis and recommendations
🔮 Scenario Analysis: Price predictions under bullish/bearish/base scenarios

💬 Intelligent Conversation

🗣️ Natural Language Processing: Understands complex crypto queries in plain English
🧠 Context Memory: Remembers conversation history and user preferences
🔄 Multi-token Support: Handle queries about multiple cryptocurrencies simultaneously
💭 Follow-up Queries: Contextual conversations like "What about its trading signals?"

🔌 API Endpoints Coverage

📊 Complete TokenMetrics Integration (21 Endpoints)

Category	Endpoint	Action	Description
💰 Core Market Data	`/price`	`getPriceAction`	Real-time cryptocurrency prices
	`/tokens`	`getTokensAction`	Token database and search
	`/top-market-cap`	`getTopMarketCapAction`	Top cryptocurrencies by market cap
📈 Trading & Signals	`/trading-signals`	`getTradingSignalsAction`	AI-powered buy/sell/hold recommendations
	`/hourly-trading-signals`	`getHourlyTradingSignalsAction`	Frequent trading signals for active trading
	`/trader-grades`	`getTraderGradesAction`	Short-term trading grades (A-F scale)
🎯 Investment Analysis	`/investor-grades`	`getInvestorGradesAction`	Long-term investment grades
	`/quantmetrics`	`getQuantmetricsAction`	Risk metrics (Sharpe ratio, volatility, drawdown)
📊 Technical Analysis	`/daily-ohlcv`	`getDailyOhlcvAction`	Daily OHLCV price data
	`/hourly-ohlcv`	`getHourlyOhlcvAction`	Hourly OHLCV price data
	`/resistance-support`	`getResistanceSupportAction`	Technical support/resistance levels
🏦 Market & Indices	`/market-metrics`	`getMarketMetricsAction`	Overall market sentiment and metrics
	`/indices`	`getIndicesAction`	Crypto market indices
	`/indices-holdings`	`getIndicesHoldingsAction`	Index composition and holdings
	`/indices-performance`	`getIndicesPerformanceAction`	Historical index performance
🤖 AI & Analytics	`/ai-reports`	`getAiReportsAction`	AI-generated comprehensive reports
	`/tmai`	`getTmaiAction`	TokenMetrics AI assistant
	`/scenario-analysis`	`getScenarioAnalysisAction`	Price prediction scenarios
📰 Market Intelligence	`/sentiment`	`getSentimentAction`	Social media and news sentiment
	`/crypto-investors`	`getCryptoInvestorsAction`	Influential crypto investors data
🔗 Portfolio Analysis	`/correlation`	`getCorrelationAction`	Token correlation for diversification

🎯 Natural Language Query Examples

Each endpoint supports intelligent natural language processing:

// Price Queries
"What's Bitcoin's current price?"
"Show me ETH price with 24h change"

// Trading Signals
"Should I buy Solana? Show me trading signals"
"Get hourly signals for BTC"

// Investment Analysis
"What are the investment grades for top DeFi tokens?"
"Show me risk metrics for my portfolio tokens"

// Technical Analysis
"Show me Bitcoin's support and resistance levels"
"Get daily OHLCV data for Ethereum"

// Market Intelligence
"What's the overall crypto market sentiment?"
"Show me AI analysis for the current market"

📁 Project Structure

plugin-tokenmetrics/
├── 📄 README.md                    # Comprehensive documentation
├── 📄 LICENSE                      # MIT License
├── 📄 package.json                 # Package configuration & dependencies
├── 📄 tsconfig.json                # TypeScript configuration
├── 📄 .gitignore                   # Git ignore rules
├── 📄 ELIZAOS_INTEGRATION_GUIDE.md # ElizaOS integration guide
├── 📄 TOKENMETRICS_TEST_PROMPTS.md # Testing prompts and examples
├── 📄 manual-endpoint-tests.md     # Manual testing procedures
│
├── 📂 src/                         # Source code
│   ├── 📄 index.ts                 # Main plugin entry point
│   ├── 📄 types.ts                 # TypeScript type definitions
│   │
│   ├── 📂 actions/                 # Action implementations (21 endpoints)
│   │   ├── 📄 aiActionHelper.ts    # Shared AI helper functions
│   │   ├── 📄 getPriceAction.ts    # Real-time price data
│   │   ├── 📄 getTradingSignalsAction.ts      # Trading signals
│   │   ├── 📄 getTraderGradesAction.ts        # Short-term grades
│   │   ├── 📄 getInvestorGradesAction.ts      # Long-term grades
│   │   ├── 📄 getQuantmetricsAction.ts        # Risk metrics
│   │   ├── 📄 getMarketMetricsAction.ts       # Market overview
│   │   ├── 📄 getIndicesAction.ts             # Market indices
│   │   ├── 📄 getIndicesHoldingsAction.ts     # Index holdings
│   │   ├── 📄 getIndicesPerformanceAction.ts  # Index performance
│   │   ├── 📄 getAiReportsAction.ts           # AI-generated reports
│   │   ├── 📄 getSentimentAction.ts           # Sentiment analysis
│   │   ├── 📄 getCorrelationAction.ts         # Correlation analysis
│   │   ├── 📄 getDailyOhlcvAction.ts          # Daily OHLCV data
│   │   ├── 📄 getHourlyOhlcvAction.ts         # Hourly OHLCV data
│   │   ├── 📄 getHourlyTradingSignalsAction.ts # Hourly signals
│   │   ├── 📄 getResistanceSupportAction.ts   # Technical levels
│   │   ├── 📄 getScenarioAnalysisAction.ts    # Price scenarios
│   │   ├── 📄 getCryptoInvestorsAction.ts     # Investor data
│   │   ├── 📄 getTmaiAction.ts                # TokenMetrics AI
│   │   ├── 📄 getTokensAction.ts              # Token database
│   │   └── 📄 getTopMarketCapAction.ts        # Top tokens
│   │
│   ├── 📂 core/                    # Core functionality
│   │   ├── 📄 enhanced-action-handler.ts  # Advanced action handling
│   │   ├── 📄 memory-manager.ts           # Context & memory management
│   │   └── 📄 nlp-processor.ts            # Natural language processing
│   │
│   └── 📂 tests/                   # Test suites
│       ├── 📂 manual/              # Manual testing scripts
│       └── 📂 ui/                  # UI testing components
│
├── 📂 dist/                        # Compiled output (generated)
│   ├── 📄 index.js                 # Compiled JavaScript
│   └── 📄 index.d.ts               # TypeScript declarations
│
└── 📂 node_modules/                # Dependencies (generated)

🏗️ Architecture Overview

Core Components

src/index.ts: Main plugin export with all 21 actions
src/types.ts: Comprehensive TypeScript definitions
src/actions/: Individual action implementations for each TokenMetrics endpoint
src/core/: Advanced features like NLP processing and memory management

Action System

Each action follows a consistent pattern:

Natural Language Processing: Understands user queries in plain English
Smart Token Resolution: Resolves token names/symbols intelligently
API Integration: Calls TokenMetrics API with proper error handling
Response Formatting: Returns structured, user-friendly responses

Key Features

🧠 AI-Powered: Uses shared aiActionHelper.ts for intelligent request processing
🔄 Context Aware: Memory management system tracks conversation context
🛡️ Error Resilient: Comprehensive error handling with retry mechanisms
📊 Type Safe: Full TypeScript coverage with detailed type definitions

💰 Pricing & Requirements

TokenMetrics API Costs

🆓 Free Tier: Limited requests (check TokenMetrics for current limits)
💳 Paid Plans: Starting from $99.99/month for extended access
⚠️ Note: This plugin requires a TokenMetrics API key

System Requirements

🟢 Node.js: 16.0.0 or higher
🔧 ElizaOS: Compatible with v0.25.9+
💾 Memory: Minimum 512MB RAM for optimal performance
🌐 Network: Stable internet connection for API calls

📊 Performance Metrics

🚦 Rate Limits

TokenMetrics API: Varies by subscription tier
Plugin Handling: Automatic retry with exponential backoff

🔄 Data Freshness

Price Data: Real-time (updated every 5-10 minutes)
Trading Signals: Updated multiple times daily
AI Reports: Generated on-demand
Market Metrics: Updated every 15 minutes

🔧 Installation

1️⃣ Add to your project

npm install @elizaos/plugin-tokenmetrics

Or add to package.json:

{
  "dependencies": {
    "@elizaos/plugin-tokenmetrics": "latest"
  }
}

2️⃣ Get TokenMetrics API Key

📝 Sign up at TokenMetrics API Portal
💳 Choose a plan that fits your usage needs
🚀 Navigate to API section in your dashboard
🔑 Generate your API key
📋 Copy your API key for configuration

3️⃣ Configure Environment Variables

Option A: Using .env file (Recommended)

# Create .env file in your project root
TOKENMETRICS_API_KEY=your_tokenmetrics_api_key

Option B: Using system environment variables

# Linux/Mac
export TOKENMETRICS_API_KEY=your_tokenmetrics_api_key

# Windows
set TOKENMETRICS_API_KEY=your_tokenmetrics_api_key

4️⃣ Configure your ElizaOS character

Method 1: Using environment variables (Recommended)

// character.ts
import { Character, ModelProviderName } from "@elizaos/core";

export const character: Character = {
  name: "CryptoAnalyst",
  plugins: ["@elizaos/plugin-tokenmetrics"],
  modelProvider: ModelProviderName.OPENAI,
  settings: {
    secrets: {
      OPENAI_API_KEY: process.env.OPENAI_API_KEY,
      TOKENMETRICS_API_KEY: process.env.TOKENMETRICS_API_KEY, // 🔑 This loads from .env
    }
  },
  system: "You are a crypto analysis assistant with access to real-time TokenMetrics data.",
  // ... rest of your character config
};

Method 2: Direct configuration (Not recommended for production)

// character.ts - Only for development/testing
export const character: Character = {
  name: "CryptoAnalyst",
  plugins: ["@elizaos/plugin-tokenmetrics"],
  settings: {
    secrets: {
      TOKENMETRICS_API_KEY: "your_api_key_here", // ⚠️ Not secure for production
    }
  },
  // ... rest of your character config
};

Method 3: JSON character file

{
  "name": "CryptoAnalyst",
  "plugins": ["@elizaos/plugin-tokenmetrics"],
  "modelProvider": "openai",
  "settings": {
    "secrets": {
      "OPENAI_API_KEY": "your_openai_key",
      "TOKENMETRICS_API_KEY": "your_tokenmetrics_key"
    },
    "tokenmetrics": {
      "defaultAnalysisDepth": "detailed",
      "preferredTimeframe": "daily",
      "riskTolerance": "medium",
      "favoriteTokens": ["BTC", "ETH", "SOL"]
    }
  },
  "system": "You are a crypto analysis assistant with access to real-time TokenMetrics data."
}

5️⃣ Verify Installation

Create a simple test to verify the plugin is working:

// test-tokenmetrics.ts
import { createAgent } from "./src/index.ts";
import { character } from "./src/character.ts";

async function testTokenMetrics() {
  console.log("🧪 Testing TokenMetrics plugin...");
  
  // Check if API key is configured
  if (!character.settings?.secrets?.TOKENMETRICS_API_KEY) {
    console.error("❌ TOKENMETRICS_API_KEY not configured!");
    return;
  }
  
  console.log("✅ API key configured");
  console.log("🚀 Plugin should be ready to use!");
  console.log("💬 Try asking: 'What's the price of Bitcoin?'");
}

testTokenMetrics();

🔧 Developer Troubleshooting

❌ Common Setup Issues

Plugin not loading in ElizaOS:

// Check if plugin is properly exported
import { tokenmetricsPlugin } from "@elizaos/plugin-tokenmetrics";
console.log("Plugin:", tokenmetricsPlugin);
console.log("Actions:", Object.keys(tokenmetricsPlugin.actions || {}));

TypeScript compilation errors:

# Check TypeScript configuration
npx tsc --showConfig

# Verify ElizaOS types are installed
npm list @elizaos/core

API key not being recognized:

// Debug environment variables
console.log("API Key present:", !!process.env.TOKENMETRICS_API_KEY);
console.log("Character secrets:", character.settings?.secrets);

Build failures:

# Clear build cache and rebuild
rm -rf dist/ node_modules/
npm install
npm run build

3️⃣ Get TokenMetrics API Key

📝 Sign up at TokenMetrics API Portal
💳 Choose a plan that fits your usage needs
🚀 Navigate to API section in your dashboard
🔑 Generate your API key
⚙️ Add it to your environment variables or character settings

🎯 Usage Examples

💬 Natural Language Queries

Your ElizaOS agent can now understand and respond to queries like:

💰 "What's the current price of Bitcoin?"
📊 "Should I buy Ethereum? Show me the trading signals"
⏰ "Get hourly trading signals for Bitcoin"
⚠️ "How risky is Solana? Show me the volatility metrics"
😊 "What's the overall crypto market sentiment today?"
🔗 "Compare Bitcoin and Ethereum correlation"
📈 "Show me resistance and support levels for BTC"
📝 "Generate an AI report for Bitcoin analysis"
👑 "What are the top 10 cryptocurrencies by market cap?"
📉 "Analyze the hourly OHLCV data for Bitcoin"
🔮 "Show me scenario analysis for Ethereum price predictions"
💼 "Which crypto investors are buying Bitcoin?"
😊 "What's the sentiment around Dogecoin on social media?"
📊 "Show me available crypto indices"
🏦 "What are the holdings of crypto index 1?"
📈 "Show me the performance history of index 2"

🎯 Advanced Query Examples

🔗 "Compare the correlation between BTC, ETH, and SOL for portfolio diversification"
📈 "Show me the resistance and support levels for the top 5 cryptocurrencies"
📝 "Generate a comprehensive AI report for Layer 1 blockchain tokens"
🎯 "What are the trading signals for tokens with High Score?"
⏰ "Show me hourly buy signals for cryptocurrencies with High Score"
📉 "Analyze the hourly OHLCV data for Bitcoin over the last 7 days"
🔮 "Show me scenario analysis for Ethereum under different market conditions"
📊 "Compare active vs passive crypto indices performance"
🏦 "Show me the top holdings in the best performing crypto index"
📈 "Analyze the risk-adjusted returns of crypto index funds"

💻 Programmatic Usage

import { tokenmetricsPlugin } from "@elizaos/plugin-tokenmetrics";

// The plugin automatically handles:
// - Intent recognition from natural language
// - Parameter extraction and validation
// - API calls to TokenMetrics
// - Response formatting and analysis
// - Error handling and retries
// - Context management and memory

📋 Complete API Endpoints Coverage

#	Endpoint	Category	Description	Use Case	Icon
1	getTokens	Core	Token database search	Token discovery	🪙
2	getTopMarketCap	Core	Top cryptocurrencies	Market overview	👑
3	getPrice	Core	Real-time prices	Price tracking	💰
4	getTraderGrades	Core	Short-term grades	Day trading	🏆
5	getInvestorGrades	Investment	Long-term grades	Portfolio building	🎯
6	getTradingSignals	Core	BUY/SELL/HOLD signals	Trading decisions	📡
7	getHourlyTradingSignals	Core	Hourly AI signals	Active trading	⏰
8	getMarketMetrics	Core	Market sentiment	Market timing	📊
9	getQuantmetrics	Risk	Risk assessment	Risk management	⚠️
10	getHourlyOhlcv	Technical	Hourly price data	Technical analysis	⏰
11	getDailyOhlcv	Technical	Daily price data	Swing trading	📅
12	getAiReports	AI	AI-generated reports	Research	📝
13	getCryptoInvestors	Investment	Investor insights	Market intelligence	💼
14	getResistanceSupport	Technical	Key price levels	Technical trading	📈
15	getSentiment	AI	Social sentiment	Sentiment analysis	😊
16	getScenarioAnalysis	AI	Price predictions	Forecasting	🔮
17	getCorrelation	Investment	Token correlations	Portfolio optimization	🔗
18	getIndices	Indices	Crypto indices data	Index discovery	📊
19	getIndicesHoldings	Indices	Index composition	Portfolio analysis	🏦
20	getIndicesPerformance	Indices	Index performance	Performance tracking	📈
21	getTMAI	AI	TMAI AI insights	Advanced AI analysis	🤖

🎯 Total: 21 comprehensive endpoints covering every aspect of cryptocurrency analysis.

⚙️ Configuration

🔑 Required Environment Variables

# Required for TokenMetrics plugin
TOKENMETRICS_API_KEY=your_tokenmetrics_api_key

# Required for AI model (choose one)
OPENAI_API_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key

🛠️ Optional Plugin Settings

Configure through your character settings:

{
  "settings": {
    "secrets": {
      "TOKENMETRICS_API_KEY": process.env.TOKENMETRICS_API_KEY
    },
    "tokenmetrics": {
      "defaultAnalysisDepth": "detailed",     // "basic" | "detailed" | "comprehensive"
      "preferredTimeframe": "daily",          // "hourly" | "daily" | "weekly"
      "riskTolerance": "medium",              // "low" | "medium" | "high"
      "favoriteTokens": ["BTC", "ETH", "SOL"], // Array of preferred tokens
      "autoFollowUp": true,                   // Enable automatic follow-up suggestions
      "includeEducation": true,               // Include educational explanations
      "maxTokensPerQuery": 10,                // Limit tokens in multi-token queries
      "cacheResults": true,                   // Cache results for faster responses
      "cacheDuration": 300                    // Cache duration in seconds
    }
  }
}

🔧 Plugin Loading Logic

The plugin automatically loads when:

✅ API Key Present: TOKENMETRICS_API_KEY is configured in character settings
✅ Plugin Listed: Plugin is included in the character's plugins array
✅ Dependencies Met: All required dependencies are installed

// The plugin loading logic (handled automatically)
if (character.settings?.secrets?.TOKENMETRICS_API_KEY) {
  plugins.push(tokenmetricsPlugin);
  console.log("✅ TokenMetrics plugin loaded");
} else {
  console.log("⚠️ TokenMetrics plugin skipped (no API key)");
}

🚀 Advanced Features

🧠 Memory & Context Management

👤 User Preferences: Tracks favorite tokens, risk tolerance, and analysis preferences
💭 Conversation Context: Remembers recent queries and tokens discussed
🔄 Smart Follow-ups: Supports contextual questions without repeating token names
🎯 Personalized Responses: Adapts analysis depth and style to user preferences
💾 Session Persistence: Maintains context across conversation sessions

🛡️ Error Handling & Reliability

🚦 API Rate Limiting: Automatic retry with exponential backoff (2s, 4s, 8s delays)
🌐 Network Issues: Graceful degradation with informative error messages
❓ Invalid Queries: Helpful suggestions for malformed or unclear requests
❌ Missing Data: Clear explanations when specific data is unavailable
⏱️ Timeout Handling: 30-second timeout with retry mechanisms
🔄 Fallback Responses: Alternative data sources when primary endpoints fail

🎨 Response Formatting & UX

🎨 Color-coded Grades: 🟢 High Score (80-100%) 🟡 Medium Score (50-79%) 🔴 Low Score (0-49%)
📊 Structured Data: Clean tables, bullet points, and organized information
💡 Actionable Insights: Professional analysis with clear recommendations
📚 Educational Content: Explanations of metrics, grades, and market concepts
👀 Visual Indicators: Emojis and symbols for quick visual parsing
📖 Progressive Disclosure: Summary first, details on request

🧪 Testing & Quality Assurance

🔬 Build & Test Commands

# Install dependencies
npm install

# Build the plugin (required for development)
npm run build

# Verify build output
ls -la dist/
# Should show: index.js and index.d.ts

# Test plugin loading (create this test file)
node -e "
const plugin = require('./dist/index.js');
console.log('✅ Plugin loaded successfully');
console.log('📊 Available actions:', Object.keys(plugin.default?.actions || {}));
"

🔍 Development Workflow

# 1. Fork and clone the repository
git clone https://github.com/[your-username]/plugin-tokenmetrics
cd plugin-tokenmetrics

# 2. Install dependencies
npm install

# 3. Set up environment variables
cp .env.example .env
echo "TOKENMETRICS_API_KEY=your_api_key_here" >> .env

# 4. Build the plugin
npm run build

# 5. Test integration with ElizaOS
# Create a test ElizaOS project and add this plugin
mkdir test-eliza && cd test-eliza
npm init -y
npm install @elizaos/core @elizaos/agent
# Copy your built plugin: cp -r ../dist ./node_modules/@elizaos/plugin-tokenmetrics/

# 6. Create test character and verify plugin loads

🧪 Manual Testing Procedures

Follow the comprehensive testing guide in manual-endpoint-tests.md to verify all 21 endpoints:

# Test basic functionality
"What's Bitcoin's price?"
"Show me trading signals for Ethereum"
"Get market sentiment data"

# Test advanced features  
"Compare BTC and ETH correlation"
"Show me crypto indices performance"
"Generate AI report for Solana"

📊 Plugin Verification Checklist

✅ Build Success: npm run build completes without errors
✅ Plugin Loading: Plugin loads in ElizaOS without errors
✅ API Connectivity: Can make successful TokenMetrics API calls
✅ Natural Language: Understands and responds to crypto queries
✅ Error Handling: Gracefully handles invalid queries and API errors
✅ Memory Management: Maintains conversation context properly

🔧 Development Tips

# Watch mode for development (if you add this script to package.json)
npm run dev

# Check TypeScript types
npx tsc --noEmit

# Lint code (if you add ESLint)
npm run lint

# Format code (if you add Prettier)
npm run format

🎯 Use Cases & Target Users

📈 Day Traders

⏰ Hourly OHLCV data for technical analysis and chart patterns
📡 Real-time trading signals with confidence scores
⏰ Hourly trading signals for active trading and scalping strategies
📊 Resistance and support levels for entry/exit points
😊 Market sentiment tracking for timing decisions

💼 Portfolio Managers

🎯 Investment grades for long-term holdings assessment
🔗 Correlation analysis for diversification strategies
🏢 Market performance analysis for allocation decisions
⚠️ Risk assessment metrics for portfolio optimization

🔬 Research Analysts

📝 AI-generated comprehensive reports for market research
🔮 Scenario analysis and predictions for forecasting
💼 Crypto investor insights for market intelligence
📊 Market trend analysis for strategic planning

👨‍💼 Casual Investors

💰 Simple price queries in natural language
💡 Easy-to-understand recommendations with explanations
📊 Market overview and sentiment for general awareness
📚 Educational explanations for learning about crypto metrics

🤖 AI Agent Developers

🔌 Plug-and-play integration with zero configuration
💬 Natural language interface requiring no API knowledge
📚 Comprehensive documentation and examples
🛡️ Production-ready reliability for commercial applications

🔒 Security & Privacy

🛡️ Data Handling

🔑 API Keys: Securely stored in character settings or environment variables
🚫 No Data Storage: Plugin doesn't store user queries or API responses
🔐 HTTPS Only: All API communications use secure HTTPS
🚦 Rate Limiting: Prevents abuse and protects API quotas

🔐 Privacy Considerations

📋 TokenMetrics Privacy: Subject to TokenMetrics privacy policy
💻 Local Processing: NLP and context management happen locally
🚫 No Tracking: Plugin doesn't track user behavior or analytics
⚙️ Configurable: Users control what data is requested and how it's used

📚 API Documentation & Resources

📖 Official Documentation

TokenMetrics API Docs - Complete API reference
Plugin Integration Guide - Detailed setup instructions
Manual Testing Guide - Endpoint testing procedures

🎓 Learning Resources

TokenMetrics Academy - Learn about crypto metrics
ElizaOS Documentation - ElizaOS plugin development
Crypto Trading Basics - Understanding trading signals

🆘 Support & Troubleshooting

🤝 Getting Help

📖 Check the Integration Guide for setup issues
🔍 Review Manual Testing Guide for functionality verification
🔧 Run diagnostic tests: npm run verify to verify API connectivity
🌐 Check TokenMetrics status at their official status page
🐛 Open an issue on GitHub with detailed error information

🔧 Common Issues & Solutions

🔑 Invalid API Key

# Error: "Invalid API key"
# Solution: Verify your API key is correct and active.
npm run verify

🚦 Rate Limiting

# Error: "Rate limit exceeded"
# Solution: Plugin handles this automatically, but check your TokenMetrics plan limits

🌐 Network Connectivity

# Error: "Network timeout"
# Solution: Check internet connection and TokenMetrics API status
curl -I https://api.tokenmetrics.com/v2/health

📦 Plugin Loading Issues

# Error: "Plugin not found"
# Solution: Ensure plugin is properly installed and configured
npm list @elizaos/plugin-tokenmetrics

⚡ Performance Optimization

💾 Use caching for frequently requested data
📦 Batch queries when possible to reduce API calls
⏰ Configure appropriate timeframes for your use case
📊 Monitor API usage to stay within rate limits

🤝 Contributing

We welcome contributions! Here's how to get involved:

🛠️ Development Setup

# Clone the repository
git clone https://github.com/[your-username]/plugin-tokenmetrics
cd plugin-tokenmetrics

# Install dependencies
npm install

# Set up environment
cp .env.example .env
# Add your TOKENMETRICS_API_KEY to .env

# Run tests
npm run test:all

# Start development
npm run dev

📋 Contribution Guidelines

🍴 Fork the repository and create a feature branch
🧪 Write tests for new functionality
🔷 Follow TypeScript best practices and existing code style
📚 Update documentation for any new features
✅ Test thoroughly with real API calls
📤 Submit a pull request with clear description

🎯 Areas for Contribution

🔌 New endpoint integrations as TokenMetrics adds APIs
🧠 Enhanced NLP processing for better query understanding
📊 Additional analysis features and insights
⚡ Performance optimizations and caching improvements
📚 Documentation improvements and examples

📄 License

MIT License - see LICENSE file for details.

📋 Third-Party Licenses

TokenMetrics API: Subject to TokenMetrics Terms of Service
ElizaOS: MIT License
Dependencies: Various open-source licenses (see package.json)

🙏 Acknowledgments

🤖 ElizaOS Team for the excellent plugin architecture
💎 The crypto community for feedback, testing, and feature requests
🤝 Contributors who help improve and maintain this plugin

🔮 Roadmap

✨ Upcoming Features

💼 Portfolio tracking integration with multiple exchanges
🚨 Alert system for price targets and signal changes
📊 Advanced charting data for technical analysis
🌍 Multi-language support for international users
📱 Mobile optimization for mobile ElizaOS clients

📅 Version History

v1.0.0: Initial release with 21 TokenMetrics endpoints
v0.9.0: Beta release with core functionality
v0.8.0: Alpha release for testing

Built with ❤️ for the ElizaOS and crypto community

TokenMetrics • ElizaOS • Plugin Registry

⭐ Star this repo if it helps your crypto analysis! ⭐

Name		Name	Last commit message	Last commit date
Latest commit History 28 Commits
dist		dist
src		src
.env		.env
.env.example		.env.example
.gitignore		.gitignore
ELIZAOS_INTEGRATION_GUIDE.md		ELIZAOS_INTEGRATION_GUIDE.md
LICENSE		LICENSE
README.md		README.md
TOKENMETRICS_TEST_PROMPTS.md		TOKENMETRICS_TEST_PROMPTS.md
manual-endpoint-tests.md		manual-endpoint-tests.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

License

token-metrics/plugin-tokenmetrics

Folders and files

Latest commit

History

Repository files navigation