🚀 Token Metrics Plugin for Virtuals Game

🎯 Supercharge your G.A.M.E agents with AI-powered cryptocurrency analysis!

The Token Metrics plugin seamlessly empowers G.A.M.E agents with comprehensive cryptocurrency analysis capabilities using the Token Metrics API, enabling the retrieval of AI-powered market data, trading signals, and investment insights without introducing any additional complexity.

✨ Features

📊 Comprehensive Token Data: Access to 21 Token Metrics API endpoints
🤖 AI-Powered Analysis: Get AI reports, sentiment analysis, and market insights
📈 Trading Intelligence: Retrieve trader grades, investor grades, and trading signals
📉 Market Analytics: Access quantmetrics, OHLCV data, and correlation analysis
📊 Crypto Indices: Track crypto indices, holdings, and performance data
⚡ Real-time Data: Current prices, market metrics, and resistance/support levels
💬 Interactive Chat Interface: Built-in chat system for testing and exploration
🛡️ Robust Error Handling: Built-in error handling and rate limiting

🔧 Available Functions

📋 Core Data Functions

Function	Description	🎯 Purpose
`getTokens`	Get supported cryptocurrencies and TOKEN_IDs	🪙 Token Discovery
`getTopMarketCapTokens`	Retrieve top cryptos by market cap	👑 Market Leaders
`getPriceData`	Get current market prices	💰 Price Tracking

📊 Trading & Investment Analysis

Function	Description	🎯 Purpose
`getTraderGrades`	AI-powered trader performance grades	🏆 Performance Analysis
`getInvestorGrades`	Investor performance analysis	🎯 Investment Insights
`getTradingSignals`	Buy/sell/hold recommendations	📡 Trading Signals
`getHourlyTradingSignals`	Hourly AI trading signals with confidence	⏰ Real-time Signals
`getMarketMetrics`	Comprehensive market analysis	📊 Market Overview

🔬 Advanced Analytics

Function	Description	🎯 Purpose
`getQuantmetrics`	Quantitative trading metrics	🧮 Quant Analysis
`getHourlyOhlcv`	Hourly OHLC data with volume	⏰ Short-term Data
`getDailyOhlcv`	Daily OHLC with technical indicators	📅 Long-term Data

🤖 AI & Research

Function	Description	🎯 Purpose
`getAiReports`	AI-generated market reports	📝 Research Reports
`getTokenMetricsAi`	Custom AI analysis queries	🧠 Custom Analysis
`getSentiments`	Market sentiment analysis	😊 Sentiment Tracking
`getCryptoInvestors`	Crypto investor performance	💼 Investor Data

📈 Technical Analysis

Function	Description	🎯 Purpose
`getResistanceSupport`	Resistance and support levels	🎯 Key Levels
`getScenarioAnalysis`	Scenario-based projections	🔮 Future Scenarios
`getCorrelation`	Crypto correlation analysis	🔗 Relationship Analysis

📊 Crypto Indices (NEW!)

Function	Description	🎯 Purpose
`getIndices`	Get crypto indices with performance data	📊 Index Overview
`getIndicesHoldings`	Get index portfolio composition and weights	🏦 Portfolio Analysis
`getIndicesPerformance`	Get historical index performance and ROI	📈 Performance Tracking

🚀 Quick Start

📦 Installation

# Using npm
npm install tokenmetrics-virtuals-plugin

# Using yarn
yarn add tokenmetrics-virtuals-plugin

🔑 Environment Setup

Set up your environment variables:

# Copy the example environment file
cp env.example .env

# Edit the .env file with your API keys
export TOKENMETRICS_API_KEY="your-tokenmetrics-api-key"
export GAME_API_KEY="your-game-api-key"

Required Environment Variables:

TOKENMETRICS_API_KEY: Your Token Metrics API key (get one from Token Metrics)
GAME_API_KEY: Your Virtuals Protocol GAME API key

💡 How to Get API Keys:

🔑 Token Metrics API Key:

Visit Token Metrics.com

Sign up for an account or log in

Navigate to API section in your dashboard

Generate your API key (starts with tm-)

🎮 GAME API Key:

Visit Virtuals Protocol

Create an account and access the developer portal

Generate your GAME framework API key

📧 Need Help? Contact Token Metrics support for API access assistance.

✅ Installation Verification

Verify your installation works correctly:

# Test the plugin setup
npm run test:setup

# Run a quick example
npm run example:tokens

💻 Basic Usage

import { config } from "dotenv";
config({ path: "./.env" });
import TokenMetricsPlugin from "tokenmetrics-virtuals-plugin";
import { GameAgent } from "@virtuals-protocol/game";

// 🔧 Initialize the plugin
const tokenMetricsPlugin = new TokenMetricsPlugin({
  apiClientConfig: {
    apiKey: process.env.TOKENMETRICS_API_KEY!,
  },
});

// 🤖 Create your crypto analysis agent
const agent = new GameAgent(process.env.GAME_API_KEY ?? "", {
  name: "🚀 Crypto Analysis Agent",
  goal: "Provide comprehensive cryptocurrency market analysis and trading insights",
  description: "You are an AI agent specialized in cryptocurrency analysis. Use Token Metrics API to help users make informed trading decisions! 📊",
  workers: [tokenMetricsPlugin.getWorker({})], // Include ALL 21 functions
});

// 🎯 Run your agent
(async () => {
  // 📝 Optional: Set up logging
  agent.setLogger((agent, message) => {
    console.log(`🤖 [${agent.name}] 📢`);
    console.log(message);
  });

  await agent.init();

  // 🚀 Example: Get token list
  const result = await agent.run("Show me the available tokens");
  console.log(result);
})();

⚙️ Custom Configuration

// 🎛️ Customize your worker
const customWorker = tokenMetricsPlugin.getWorker({
  functions: [
    tokenMetricsPlugin.getTokens,
    tokenMetricsPlugin.getPriceData,
    tokenMetricsPlugin.getTradingSignals,
    tokenMetricsPlugin.getIndices,
    tokenMetricsPlugin.getIndicesHoldings,
  ],
  getEnvironment: async () => ({
    customSetting: "value",
  }),
});

📋 Configuration Options

interface ITokenMetricsPluginOptions {
  id?: string;           // 🆔 Custom worker ID
  name?: string;         // 📛 Custom worker name  
  description?: string;  // 📝 Custom worker description
  apiClientConfig: {
    apiKey: string;      // 🔑 Token Metrics API key
    baseApiUrl?: string; // 🌐 Custom API endpoint (optional)
  };
}

🛠️ Development

🏗️ Setup

# 1️⃣ Clone the repository
git clone <repository-url>

# 2️⃣ Install dependencies
npm install

# 3️⃣ Set up environment variables
cp env.example .env
# Edit .env file with your API keys:
# TOKENMETRICS_API_KEY=tm-your-tokenmetrics-api-key-here
# GAME_API_KEY=your-game-api-key-here

# 4️⃣ Build the plugin
npm run build

# 5️⃣ Run the example
npm run example:full-agent
# or
npm run dev

💬 Interactive Chat Interface

Launch the interactive terminal for testing:

npm run chat

🎮 Example Chat Commands

💰 "What's the price of Bitcoin?"
📊 "Show me trading signals"
⏰ "Show me hourly trading signals" (NEW!)
🏆 "Get trader grades for top tokens"
😊 "Analyze market sentiment"
📝 "Show me AI reports"
🔗 "Get correlation analysis"
📊 "Show me crypto indices data" (NEW!)
🏦 "What are the holdings of crypto index 1?" (NEW!)
📈 "Show me performance data for crypto index 1" (NEW!)

🎯 Examples & Testing

📊 Basic Token Data

npm run example:tokens          # 🪙 Get token list
npm run example:price-data      # 💰 Get price data
npm run example:top-market-cap  # 👑 Get top market cap tokens

📈 Trading Analysis

npm run example:trader-grades         # 🏆 Get trader performance grades
npm run example:investor-grades       # 🎯 Get investor analysis
npm run example:trading-signals       # 📡 Get trading recommendations
npm run example:hourly-trading-signals # ⏰ Get hourly AI trading signals (NEW!)

📉 Market Analytics

npm run example:market-metrics   # 📊 Get market analysis
npm run example:quantmetrics     # 🧮 Get quantitative metrics
npm run example:hourly-ohlcv     # ⏰ Get hourly price data
npm run example:daily-ohlcv      # 📅 Get daily price data

🤖 AI & Research

npm run example:ai-reports       # 📝 Get AI-generated reports
npm run example:tokenmetrics-ai  # 🧠 Query Token Metrics AI
npm run example:sentiments       # 😊 Get sentiment analysis
npm run example:crypto-investors # 💼 Get crypto investor data

📈 Technical Analysis

npm run example:resistance-support  # 🎯 Get support/resistance levels
npm run example:scenario-analysis   # 🔮 Get scenario projections
npm run example:correlation         # 🔗 Get correlation analysis

📊 Crypto Indices (NEW!)

npm run example:indices             # 📊 Get crypto indices overview
npm run example:indices-holdings    # 🏦 Get index portfolio composition
npm run example:indices-performance # 📈 Get historical index performance

🧪 Testing Suite

npm run test:all                 # 🧪 Run all tests
npm run test:individual          # 🔍 Test individual functions
npm run test:integration         # 🔄 Test integration scenarios

🎮 Demo Scenarios

npm run demo:trading-bot         # 🤖 Trading bot simulation
npm run demo:research-agent      # 🔬 Research agent demo
npm run demo:new-endpoints       # ✨ New endpoints demonstration
npm run demo:indices             # 📊 Crypto indices demo (NEW!)

📚 API Reference

🔧 Core Functions

🪙 getTokens(args)

Get the list of supported cryptocurrencies.

Parameters:

limit (number): Number of items to return (default: 50)
page (number): Page number for pagination (default: 1)
token_name (string): Comma-separated crypto asset names
symbol (string): Comma-separated token symbols
category (string): Comma-separated category names

💰 getPriceData(args)

Get current market prices for specified tokens.

Parameters:

token_id (string): Comma-separated Token IDs (required)

📡 getTradingSignals(args)

Get AI-powered trading recommendations.

Parameters:

token_id (string): Comma-separated Token IDs
limit (number): Number of signals to return
page (number): Page number for pagination

🔬 Advanced Functions

🧮 getQuantmetrics(args)

Get comprehensive quantitative trading metrics.

Parameters:

token_id (string): Comma-separated Token IDs
limit (number): Number of results to return
page (number): Page number for pagination

📝 getAiReports(args)

Get AI-generated comprehensive market reports.

Parameters:

token_id (string): Comma-separated Token IDs
limit (number): Number of reports to return
page (number): Page number for pagination

📊 Crypto Indices Functions (NEW!)

📊 getIndices(args)

Get crypto indices with performance data.

Parameters:

limit (number): Number of indices to return (default: 50)
page (number): Page number for pagination (default: 1)

🏦 getIndicesHoldings(args)

Get current holdings of a given index with weights.

Parameters:

id (string): Index ID (required)
limit (number): Number of holdings to return (default: 50)
page (number): Page number for pagination (default: 1)

📈 getIndicesPerformance(args)

Get historical performance data for an index with ROI over time.

Parameters:

id (string): Index ID (required)
limit (number): Number of performance records to return (default: 50)
page (number): Page number for pagination (default: 1)

📖 Complete Documentation: Token Metrics API Documentation

🛡️ Error Handling

The plugin includes comprehensive error handling:

⏱️ Rate Limiting: Automatic rate limiting with configurable delays
🔄 Retry Logic: Exponential backoff for failed requests
✅ Validation: Input validation for all parameters
🎯 Graceful Degradation: Fallback responses for API failures

🔧 Troubleshooting

🚨 Common Issues & Solutions

1. API Key Issues

# ❌ Error: "Invalid API key" or "Unauthorized"
# ✅ Solution:
# 1. Verify your Token Metrics API key is correct
# 2. Check that your API key starts with 'tm-'
# 3. Ensure no extra spaces in your .env file
export TOKENMETRICS_API_KEY="tm-your-actual-key-here"

2. Environment Variables Not Loading

# ❌ Error: "API key is undefined"
# ✅ Solution:
# 1. Ensure .env file is in the correct location
# 2. Check that dotenv is properly configured
import { config } from "dotenv";
config({ path: "./.env" }); // Must be before other imports

3. Network/Connection Issues

# ❌ Error: "Network timeout" or "Connection refused"
# ✅ Solutions:
# 1. Check your internet connection
# 2. Verify Token Metrics API is accessible
curl -H "x-api-key: your-key" https://api.tokenmetrics.com/v2/tokens

# 3. Check for firewall/proxy issues
# 4. Try with a different network

4. Rate Limiting

# ❌ Error: "Rate limit exceeded" or "Too many requests"
# ✅ Solutions:
# 1. Reduce request frequency
# 2. Implement delays between calls
# 3. Use pagination with smaller limits
# 4. Contact Token Metrics for higher rate limits

5. Invalid Token IDs

# ❌ Error: "Token not found" or "Invalid token_id"
# ✅ Solution:
# 1. First get valid token IDs:
npm run example:tokens

# 2. Use the TOKEN_ID from the response (e.g., 3375 for BTC)
# 3. Ensure comma-separated format: "3375,3306"

6. Build/TypeScript Issues

# ❌ Error: TypeScript compilation errors
# ✅ Solutions:
# 1. Ensure TypeScript is installed
npm install -g typescript

# 2. Check Node.js version (requires 16+)
node --version

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

7. GAME Framework Integration Issues

# ❌ Error: "GameAgent not found" or GAME-related errors
# ✅ Solutions:
# 1. Verify GAME API key is set
export GAME_API_KEY="your-game-api-key"

# 2. Check @virtuals-protocol/game version
npm list @virtuals-protocol/game

# 3. Ensure proper initialization order
await agent.init(); // Must be called before agent.run()

🔍 Debug Mode

Enable detailed logging for troubleshooting:

// Enable debug logging
const agent = new GameAgent(process.env.GAME_API_KEY!, {
  // ... config
});

agent.setLogger((agent, message) => {
  console.log(`🐛 [DEBUG] ${agent.name}:`);
  console.log(message);
});

📊 Testing Your Setup

Run these commands to verify everything works:

# 1. Test environment setup
npm run test:setup

# 2. Test individual functions
npm run test:individual

# 3. Test integration
npm run test:integration

# 4. Interactive testing
npm run chat

🆘 Getting Help

If you're still having issues:

📋 Check Examples: Review our 22+ example files
🧪 Run Tests: Use our comprehensive test suite
💬 Interactive Mode: Try npm run chat for hands-on testing
📖 Documentation: Check Token Metrics API Docs
🐛 Report Issues: Create a GitHub issue with:
- Error message
- Your environment (Node.js version, OS)
- Steps to reproduce
- Relevant code snippets

⚡ Performance Tips

Batch Requests: Use comma-separated token IDs instead of multiple calls
Pagination: Use appropriate limit and page parameters
Caching: Cache responses for frequently requested data
Error Handling: Always wrap API calls in try-catch blocks

🧪 Dev Testing

📸 Screenshots & Visual Demonstrations

🚀 Plugin Installation & Setup

Visual demonstration of successful plugin installation and initial setup process

Initial Setup: Shows the plugin installation process, dependency setup, and environment configuration.

Setup Verification: Complete setup verification showing successful build, test execution, and plugin readiness confirmation.

💬 Interactive Chat Interface

Screenshots of the interactive terminal chat interface in action

Chat Interface: The main Token Metrics AI chat interface showing the welcome screen, available commands, and user interaction prompts.

AI Responses: Example of comprehensive AI responses with color-coded output, data visualization, and detailed analysis results from Token Metrics API.

📊 Crypto Market Sentiment Analysis

Visual examples of sentiment analysis output and market data visualization

Sentiment Dashboard: Real-time market sentiment analysis with color-coded indicators, sentiment scores, confidence levels, and comprehensive market mood visualization.

🏦 Quantitative Metrics Analysis

Advanced quantitative analysis visualization and performance metrics

Quant Analysis: Advanced quantitative metrics including Sharpe ratios, volatility analysis, drawdown calculations, risk-adjusted returns with visual progress bars, and color-coded performance indicators.

🧪 Testing Steps

1. Basic Setup Testing

npm install tokenmetrics-virtuals-plugin
npm run test:setup
# Expected: All checks pass ✅

2. Function Testing

npm run test:individual
# Expected: All 21 functions execute successfully

3. Integration Testing

npm run test:integration
# Expected: GAME framework integration works

4. Interactive Testing

npm run chat
# Test various queries and verify responses

📊 Performance Benchmarks

Function Performance (Average Response Time):
• getTokens(): ~245ms
• getPriceData(): ~180ms  
• getTradingSignals(): ~320ms
• getTokenMetricsAi(): ~850ms
• getIndices(): ~210ms

Memory Usage: ~45MB (typical)
Rate Limiting: 60 requests/minute (within limits)

🐛 Error Handling Examples

Invalid API Key

❌ Invalid API key provided
🔧 Solution: Verify API key format and permissions

Network Issues

❌ Network timeout
🔄 Automatic retry with exponential backoff
✅ Connection restored

🖥️ Cross-Platform Testing

✅ macOS (Intel & Apple Silicon)
✅ Linux (Ubuntu 20.04+)
✅ Windows (10/11)
✅ Node.js versions: 16.x, 18.x, 20.x

🤝 Contributing

We welcome contributions to the Token Metrics Virtuals Plugin! Here's how to contribute effectively:

🚀 Quick Start for Contributors

🍴 Fork & Clone

git clone https://github.com/your-username/tokenmetrics-virtuals-plugin.git
cd tokenmetrics-virtuals-plugin

📦 Install Dependencies
```
npm install
```

🔑 Setup Environment

cp env.example .env
# Add your API keys to .env file

✅ Verify Setup
```
npm run test:setup
npm run build
```

🎯 Contribution Types

🔧 Bug Fixes

Fix API integration issues
Resolve TypeScript compilation errors
Improve error handling
Fix documentation inconsistencies

✨ New Features

Add new Token Metrics API endpoints
Enhance response formatting
Improve chat interface functionality
Add new testing scenarios

📚 Documentation

Improve README sections
Add more usage examples
Enhance API documentation
Create tutorial content

🧪 Testing

Add test cases for new functions
Improve test coverage
Create integration test scenarios
Add performance benchmarks

📋 Development Guidelines

🏗️ Code Standards

TypeScript: All code must be properly typed
ESLint: Follow existing linting rules
Formatting: Use consistent code formatting
Comments: Document complex logic and API integrations

🎯 Plugin-Specific Requirements

GAME Integration: All new functions must use GameFunction pattern
Error Handling: Implement proper ExecutableGameFunctionResponse handling
API Consistency: Follow existing Token Metrics API patterns
Response Formatting: Use color-coded console output for user-friendly responses

🧪 Testing Requirements

Unit Tests: Test individual functions
Integration Tests: Test GAME framework integration
Example Files: Create example usage files
Documentation: Update README with new features

📝 Pull Request Process

Before Submitting:

🔍 Test Your Changes

npm run test:all
npm run build
npm run example:your-new-feature

📖 Update Documentation
- Update README.md if adding new features
- Add example files for new functions
- Update API reference section
- Update CHANGELOG.md

✅ Code Quality Checks

# Ensure TypeScript compiles
npm run build

# Run all tests
npm run test:all

# Test examples work
npm run example:tokens

PR Requirements:

📋 Clear Description: Explain what your PR adds/fixes
🧪 Testing Evidence: Include screenshots, logs, or test results
📚 Documentation: Update relevant documentation
🔗 Issue Reference: Link to related issues if applicable

🎯 Specific Areas for Contribution

🔥 High Priority

New API Endpoints: Add missing Token Metrics endpoints
Enhanced Error Handling: Improve error messages and recovery
Performance Optimization: Optimize API calls and response processing
Testing Coverage: Expand test scenarios

💡 Enhancement Ideas

Real-time Updates: WebSocket integration for live data
Data Visualization: Add chart/graph generation capabilities
Caching Layer: Implement intelligent response caching
Batch Processing: Optimize multiple token requests

📖 Documentation Needs

Video Tutorials: Create setup and usage videos
Advanced Examples: Complex trading bot scenarios
API Migration Guides: Help users migrate from other APIs
Best Practices: Performance and usage optimization guides

🛠️ Development Workflow

🌟 Create Feature Branch

git checkout -b feature/new-endpoint-integration

💻 Develop & Test

# Make your changes
# Test thoroughly
npm run test:individual
npm run example:your-feature

📝 Document Changes

# Update README.md
# Add example files
# Update CHANGELOG.md

🔄 Submit PR

git add .
git commit -m "feat: add new Token Metrics endpoint integration"
git push origin feature/new-endpoint-integration

🎖️ Recognition

Contributors will be:

📜 Listed in CHANGELOG.md
🌟 Credited in README.md
🏆 Recognized in release notes
💬 Mentioned in community channels

📞 Getting Help

Need help contributing?

💬 Discussions: Use GitHub Discussions for questions
🐛 Issues: Create issues for bugs or feature requests
📧 Direct Contact: Reach out to maintainers
📖 Documentation: Check our comprehensive guides

🔄 Review Process

🍴 Fork the repository
🌟 Create your feature branch (git checkout -b feature/amazing-feature)
💾 Commit your changes (git commit -m 'Add some amazing feature')
📤 Push to the branch (git push origin feature/amazing-feature)
🔁 Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

Need help? We've got you covered:

🐛 Bug Reports: Create an issue on GitHub
🔧 API Questions: Contact Token Metrics support
📚 Documentation: Check our comprehensive examples and tests
💬 Community: Join our discussions

📈 Changelog

🎉 v1.0.0

✨ Initial release with 21 Token Metrics API endpoints
🆕 NEW: Hourly Trading Signals - Real-time AI trading recommendations updated hourly
💬 Interactive chat interface
📚 Comprehensive examples and tests
🛡️ Built-in error handling and rate limiting
🔷 Full TypeScript support
📊 Crypto indices tracking with holdings and performance data

📋 Quick Reference

🚀 Essential Commands

# Installation
npm install tokenmetrics-virtuals-plugin

# Setup
cp env.example .env

# Test installation
npm run test:setup

# Interactive testing
npm run chat

# Build for production
npm run build

⚡ Quick Integration Template

import { config } from "dotenv";
config({ path: "./.env" });
import TokenMetricsPlugin from "tokenmetrics-virtuals-plugin";
import { GameAgent } from "@virtuals-protocol/game";

const plugin = new TokenMetricsPlugin({
  apiClientConfig: { apiKey: process.env.TOKENMETRICS_API_KEY! }
});

const agent = new GameAgent(process.env.GAME_API_KEY!, {
  name: "Crypto AI Agent",
  goal: "Provide crypto analysis",
  workers: [plugin.getWorker({})]
});

await agent.init();

🎯 Most Used Functions

getTokens() - Get all supported cryptocurrencies
getPriceData(token_id) - Get current prices
getTradingSignals() - Get buy/sell recommendations
getTokenMetricsAi(message) - Chat with Token Metrics AI
getMarketMetrics() - Get market overview
getIndices() - Get crypto indices data (NEW!)
getIndicesHoldings(id) - Get index portfolio composition (NEW!)

🚀 Ready to revolutionize your crypto analysis?

📖 Documentation

Made with ❤️ by the Token Metrics team

Name		Name	Last commit message	Last commit date
Latest commit History 14 Commits
dist		dist
screenshots		screenshots
src		src
tests		tests
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
COMPREHENSIVE_TEST_GUIDE.md		COMPREHENSIVE_TEST_GUIDE.md
DEVELOPER_INTEGRATION_GUIDE.md		DEVELOPER_INTEGRATION_GUIDE.md
LICENSE		LICENSE
README.md		README.md
env.example		env.example
manual-endpoint-tests.md		manual-endpoint-tests.md
package-lock.json		package-lock.json
package.json		package.json
plugin_metadata.yml		plugin_metadata.yml
test-all-endpoints-chat.js		test-all-endpoints-chat.js
test-routing-fixed.js		test-routing-fixed.js
tsconfig.json		tsconfig.json

License

token-metrics/tmai-virtual-game-repo

Folders and files

Latest commit

History

Repository files navigation

🚀 Token Metrics Plugin for Virtuals Game

✨ Features

🔧 Available Functions

📋 Core Data Functions

📊 Trading & Investment Analysis

🔬 Advanced Analytics

🤖 AI & Research

📈 Technical Analysis

📊 Crypto Indices (NEW!)

🚀 Quick Start

📦 Installation

🔑 Environment Setup

✅ Installation Verification

💻 Basic Usage

⚙️ Custom Configuration

📋 Configuration Options

🛠️ Development

🏗️ Setup

💬 Interactive Chat Interface

🎮 Example Chat Commands

🎯 Examples & Testing

📊 Basic Token Data

📈 Trading Analysis

📉 Market Analytics

🤖 AI & Research

📈 Technical Analysis

📊 Crypto Indices (NEW!)

🧪 Testing Suite

🎮 Demo Scenarios

📚 API Reference

🔧 Core Functions

🪙 getTokens(args)

💰 getPriceData(args)

📡 getTradingSignals(args)

🔬 Advanced Functions

🧮 getQuantmetrics(args)

📝 getAiReports(args)

📊 Crypto Indices Functions (NEW!)

📊 getIndices(args)

🏦 getIndicesHoldings(args)

📈 getIndicesPerformance(args)

🛡️ Error Handling

🔧 Troubleshooting

🚨 Common Issues & Solutions

1. API Key Issues

2. Environment Variables Not Loading

3. Network/Connection Issues

4. Rate Limiting

5. Invalid Token IDs

6. Build/TypeScript Issues

7. GAME Framework Integration Issues

🔍 Debug Mode

📊 Testing Your Setup

🆘 Getting Help

⚡ Performance Tips

🧪 Dev Testing

📸 Screenshots & Visual Demonstrations

🚀 Plugin Installation & Setup

💬 Interactive Chat Interface

📊 Crypto Market Sentiment Analysis

🏦 Quantitative Metrics Analysis

🧪 Testing Steps

1. Basic Setup Testing

2. Function Testing

3. Integration Testing

4. Interactive Testing

📊 Performance Benchmarks

🐛 Error Handling Examples

Invalid API Key

Network Issues

🖥️ Cross-Platform Testing

🤝 Contributing

🚀 Quick Start for Contributors

🎯 Contribution Types

Packages