API REFERENCE

The XHUNT AI API provides programmatic access to our token discovery engine. This reference outlines the core endpoints and functionality available to developers.

Authentication

All API requests must include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

To obtain an API key, visit the API Settings page in your dashboard.

BASE ENDPOINTS

https://xhunt.ai/v2

TOKENS ENDPOINT

Retrieve information about tokens tracked by XHUNT AI.

WALLET INTEGRATION

XHUNT AI supports seamless integration with major Solana wallets, providing enhanced functionality and personalized alerts.

SUPPORTED WALLETS

The platform currently supports the following wallet providers:

• Phantom
• Solflare
• Sollet
• Slope
• Coinbase Wallet
• Backpack

WALLET CONNECTION PROCEDURE

// Example using Phantom wallet
const connectWallet = async () => {
  try {
    const { solana } = window;
    
    if (!solana) {
      throw new Error("Phantom wallet not found!");
    }
    
    const response = await solana.connect();
    console.log('Connected with Public Key:', response.publicKey.toString());
    
    // Call XHUNT API to register the wallet
    await registerWallet(response.publicKey.toString());
    
    return response.publicKey.toString();
  } catch (error) {
    console.error("Error connecting wallet:", error);
    throw error;
  }
};

ALERT CONFIGURATION

XHUNT AI allows users to configure personalized alerts based on their specific investment criteria and risk tolerance.

ALERT TYPES

ALERT PRIORITY LEVELS

Users can configure the priority level for each alert type:

• Critical: Immediate notification regardless of time
• High: Prompt notification during active hours
• Medium: Batched notifications at intervals
• Low: Daily digest of low-priority alerts

TRACKING SETTINGS

XHUNT AI offers granular control over which tokens and market activities you want to monitor. This section covers configuration options for optimizing your token tracking experience.

TOKEN WATCHLISTS

Create and manage custom watchlists to organize tokens by category, strategy, or any custom classification:

• Create up to 10 watchlists (50 for premium users)
• Add tokens to multiple watchlists
• Configure watchlist-specific alerts
• Set performance benchmarks for each watchlist
• Share watchlists with team members (premium only)

FILTER CRITERIA

Customize tracking parameters based on token metrics:

{
  "minMarketCap": 100000,
  "maxMarketCap": 5000000,
  "minLiquidity": 50000,
  "minHolders": 100,
  "maxTaxRate": 5,
  "minConfidenceScore": 75,
  "categories": ["gaming", "ai", "defi"],
  "excludeCategories": ["meme"],
  "excludeTokens": ["list", "of", "addresses", "to", "ignore"]
}

SOCIAL TRACKING

Configure which social platforms and influencers to monitor for token mentions:

• Twitter/X accounts and hashtags
• Discord servers
• Telegram groups
• Reddit communities
• Custom keyword monitoring

CONFIDENCE SCORES

The XHUNT AI confidence scoring system is the heart of our token evaluation model. Understanding how these scores are calculated will help you make better investment decisions.

SCORING METHODOLOGY

Our confidence scores are calculated using a proprietary algorithm that evaluates over 40 distinct factors across five primary categories:

SCORE INTERPRETATION

Confidence scores range from 0-100 and are categorized as follows:

• 90-100: Exceptional - Highest quality opportunities
• 80-89: Very High - Strong indicators across all categories
• 70-79: High - Solid performance with minor concerns
• 60-69: Medium - Promising but with notable risks
• 50-59: Moderate - Mixed signals requiring caution
• 0-49: Low - Significant red flags present

TOKEN INSIGHTS

XHUNT AI provides deep analytical insights for each tracked token. This section explains how to interpret and leverage these insights for your investment strategy.

TOKEN PROFILE

Each token profile includes comprehensive data points:

• General Information: Name, symbol, contract address, creation date
• Market Metrics: Price, market cap, 24h volume, liquidity depth
• Holder Analysis: Distribution patterns, concentration metrics
• Social Metrics: Mention frequency, sentiment trends, growth rate
• Technical Indicators: RSI, MACD, support/resistance levels
• Historical Performance: Price charts, volume trends, key events

COMPARATIVE ANALYSIS

The platform allows you to compare tokens against:

• Similar tokens in the same category
• Historical patterns of successful tokens
• Market-wide averages and benchmarks
• Custom benchmark tokens of your choice

// Example: Compare a token against category peers
const response = await fetch(
  `https://xhunt.ai/v2/tokens/${tokenAddress}/compare?category=true&limit=5`,
  {
    method: 'GET',
    headers: {
      'Authorization': `Bearer ${YOUR_API_KEY}`,
      'Content-Type': 'application/json'
    }
  }
);

PREDICTIVE INSIGHTS

For premium users, XHUNT AI offers predictive analytics:

• Price movement projections with confidence intervals
• Volatility forecasts
• Liquidity trend predictions
• Social momentum projections
• Holder behavior pattern analysis

ADVANCED ANALYTICS

XHUNT AI provides sophisticated analytical tools for advanced users who want to perform deeper market analysis and develop custom strategies.

MARKET CORRELATION HEATMAPS

Visualize how different tokens and market sectors move in relation to each other:

• Pearson correlation coefficients for price movements
• Social sentiment correlation analysis
• Volume pattern correlations
• Whale movement correlation vectors

NETWORK ANALYSIS

Explore the relationships between tokens, wallets, and liquidity pools:

• Wallet connection graphs
• Liquidity flow visualizations
• Token relationship networks
• Influencer impact diagrams

// Get wallet connections for a specific token
const response = await fetch(
  `https://xhunt.ai/v2/analytics/network/token/${tokenAddress}?depth=2&min_holdings=1000`,
  {
    method: 'GET',
    headers: {
      'Authorization': `Bearer ${YOUR_API_KEY}`,
      'Content-Type': 'application/json'
    }
  }
);

CUSTOM BACKTESTING

Test your investment strategies against historical data:

• Configure entry and exit conditions
• Set risk management parameters
• Analyze performance metrics
• Compare against benchmark strategies
• Optimize parameters based on results

WEBHOOKS

XHUNT AI offers webhook integrations that allow you to receive real-time data updates and alerts in your own applications and systems.

WEBHOOK SETUP

To create a webhook endpoint:

1. Navigate to the API Settings page in your dashboard
2. Click "Create New Webhook"
3. Provide your endpoint URL and select event types
4. Configure security settings and rate limits
5. Test the webhook connection
6. Enable the webhook for production use

SUPPORTED EVENTS

{
  "event": "token.discovered",
  "timestamp": "2025-03-10T20:35:42Z",
  "data": {
    "token_address": "6XU5nCp8Y5RhwVqPHXXi7uJ4FWsaB7rHypAsujeqH82k",
    "name": "Example Token",
    "symbol": "EXT",
    "creation_time": "2025-03-10T20:12:18Z",
    "initial_liquidity": 75340,
    "initial_price_usd": 0.00032,
    "confidence_score": 82,
    "category": "gaming",
    "social_mentions": 28,
    "smart_money_interest": "medium"
  },
  "signature": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

FREQUENTLY ASKED QUESTIONS

GENERAL QUESTIONS

Q: What makes XHUNT AI different from other token discovery tools?

A: XHUNT AI uses a proprietary multi-dimensional analysis system that combines on-chain data, social signals, technical patterns, and AI-driven predictive models. Unlike most tools that focus on a single dimension, our platform integrates data from over 40 distinct sources to provide a comprehensive evaluation system with documented accuracy rates.

Q: How often is the data updated?

A: The platform operates on multiple update cycles: price and liquidity data is near real-time (15-second intervals), social data is updated every 2-5 minutes, and full analytical reports are refreshed every 30 minutes. Premium users get priority access to more frequent updates.

Q: Does XHUNT AI guarantee returns on investment?

A: No. XHUNT AI provides analytical tools and insights to help inform your investment decisions, but all cryptocurrency investments carry significant risk. Even tokens with high confidence scores can experience volatility and losses. Always conduct your own research and invest only what you can afford to lose.

TECHNICAL QUESTIONS

Q: What are the API rate limits?

A: Free accounts have access to 100 requests per day and up to 5 requests per minute. Premium accounts get 5,000 requests per day with up to 30 requests per minute. Enterprise accounts have customizable limits based on needs.

Q: Can I export data to external tools?

A: Yes. XHUNT AI supports data export in JSON, CSV, and Excel formats. Premium users can also set up automated exports on a schedule or trigger exports based on specific events.

Q: Is my wallet data kept private?

A: Absolutely. We never store your private keys or seed phrases. We only track the public address information that you explicitly authorize. All user data is encrypted at rest and in transit, and we maintain strict access controls.

ACCOUNT & BILLING

Q: What happens when I connect my wallet?

A: Connecting your wallet allows XHUNT AI to analyze your token holdings and provide personalized insights. We request read-only permissions, which means we can never initiate transactions or access your private keys.

Q: Can I upgrade or downgrade my subscription?

A: Yes, you can change your subscription tier at any time. Upgrades take effect immediately, while downgrades will be applied at the end of your current billing cycle.

Q: How do I cancel my subscription?

A: You can cancel your subscription from the Account Settings page. After cancellation, you'll maintain access to premium features until the end of your current billing period.