Vector AI API

Vector AI API Documentation

Comprehensive token analysis and security scanning API

API Key Configuration

Your API key is stored locally and used for testing endpoints. Get your key from our plans page or .

Getting Started

Overview Authentication Rate Limiting

Token Analysis

Full Analysis Security Analysis Vector Scores Security Only

Feature Endpoints

Security Market Analysis Holder Analysis Wash Trading Sniper Sellers Social Score

User Management

User Stats Recent Calls API Keys Create Key Wallet Stats

Monetization

Test Key Purchase Plan

System

Rate Limits Status Health Check

Overview

The Vector AI API provides comprehensive token analysis and security scanning capabilities. Our API uses advanced AI and multiple data sources to analyze cryptocurrency tokens across various blockchain networks.

Base URL

https://vapi.vector-ai.pro

Supported Networks

Ethereum (eth)
Main Ethereum network
Base (base)
Base Layer 2 network
BSC (bsc)
Binance Smart Chain

Authentication

All API requests require authentication using an API key. Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY

Getting an API Key

Test Key

10 scans, 7 days - Free

Paid Plans

Purchase through our buy page

Enterprise

Contact our team for access

Rate Limiting

Our API implements comprehensive rate limiting to ensure fair usage and prevent abuse:

Global Limits

  • Concurrent Requests: 50 maximum across all users
  • Per Minute: 300 requests maximum globally

External API Protection

  • EVA API: 4 RPS, 8 burst capacity
  • GoPlus API: 8 RPS, 16 burst capacity
  • DexScreener: 12 RPS, 24 burst capacity
  • Etherscan: 4 RPS, 8 burst capacity

Rate Limit Headers

X-RateLimit-Remaining: 45 X-RateLimit-Reset: 1640995200

Rate Limit Response

{ "error": "rate_limited", "provider": "eva", "reason": "eva rate limit exceeded (4 RPS)", "retry_after": 1 }

Token Analysis Endpoints

POST /api/v1/token/analyze Complete Token Analysis
Standard Rate Limit ▼
🔐 Authentication required - Include your API key in the Authorization header

Performs a comprehensive analysis of a token including security, market data, holder analysis, and more.

Request Parameters

contract_address string
The token contract address to analyze
chain string
Blockchain network (eth, base, bsc)

🧪 Test This Endpoint

{
  "contract_address": "0x1234567890123456789012345678901234567890",
  "chain": "eth"
}
{
  "success": true,
  "analysis_details": {
    "token_data": {
      "name": "Example Token",
      "symbol": "EXAMPLE",
      "decimals": 18,
      "description": "A utility token for DeFi",
      "description_confidence": 0.9
    },
    "security_analysis": {
      "security_score": 85,
      "overall_risk": "LOW",
      "eva_analysis": {
        "overall_eva_rating": "SAFE",
        "is_renounced": true,
        "token_name": "Example Token"
      },
      "goplus_analysis": {
        "is_honeypot": false,
        "buy_tax": "0.03",
        "sell_tax": "0.03"
      }
    },
    "market_analysis": {
      "price_usd": 1.25,
      "market_cap": 1250000,
      "volume_24h": 125000
    }
  },
  "vector_score": 82,
  "grade_summary": {
    "security_analysis": "A",
    "market_analysis": "B",
    "holder_analysis": "A"
  }
}

Response Codes

200 - Analysis completed successfully
400 - Invalid request parameters
401 - Invalid or missing API key
429 - Rate limit exceeded
500 - Internal server error
POST /api/v1/token/security-analysis Full Security Analysis
Standard Rate Limit ▼
🔐 Authentication required - Include your API key in the Authorization header

Provides detailed security analysis including EVA AI audit, GoPlus security checks, and comprehensive risk assessment.

Request Parameters

contract_address string
The token contract address to analyze
chain string
Blockchain network (eth, base, bsc)
{
  "success": true,
  "security_analysis": {
    "security_score": 85,
    "security_grade": "A",
    "overall_risk": "LOW",
    "eva_analysis": {
      "eva_available": true,
      "overall_eva_rating": "SAFE",
      "is_renounced": true,
      "has_owner": false,
      "ai_audit_findings": [
        {
          "severity": "LOW",
          "issue": "Standard ERC20 implementation",
          "description": "Token follows standard practices"
        }
      ]
    },
    "goplus_analysis": {
      "goplus_available": true,
      "is_honeypot": false,
      "is_mintable": false,
      "buy_tax": "0.03",
      "sell_tax": "0.03",
      "contract_verified": true
    },
    "key_findings": [
      "✅ Contract ownership renounced",
      "✅ Contract verified on blockchain explorer",
      "✅ Low transaction taxes (3%)"
    ]
  }
}
POST /api/v1/token/vector-scores Vector Scores Only
Standard Rate Limit ▼
🔐 Authentication required - Include your API key in the Authorization header

Returns only the Vector scores and grades without detailed analysis data. Faster and more lightweight.

{
  "success": true,
  "vector_score": 82,
  "grade_summary": {
    "security_analysis": "A",
    "market_analysis": "B",
    "holder_analysis": "A",
    "wash_trading_analysis": "B",
    "sniper_sellers_analysis": "A"
  },
  "component_scores": {
    "security_analysis": 85,
    "market_analysis": 78,
    "holder_analysis": 88,
    "wash_trading_analysis": 72,
    "sniper_sellers_analysis": 90
  },
  "token_data": {
    "name": "Example Token",
    "symbol": "EXAMPLE",
    "description": "A utility token for DeFi"
  }
}
POST /api/v1/token/security-only Security Analysis Only
Standard Rate Limit ▼
🔐 Authentication required - Include your API key in the Authorization header

Focuses exclusively on security analysis without market or holder data. Optimized for security-focused applications.

{
  "success": true,
  "security_score": 85,
  "security_grade": "A",
  "overall_risk": "LOW",
  "critical_issues": [],
  "critical_override_applied": false,
  "key_security_findings": [
    "✅ Contract ownership renounced",
    "✅ No honeypot detected",
    "✅ Contract verified"
  ],
  "token_info": {
    "name": "Example Token",
    "symbol": "EXAMPLE"
  }
}

Feature Endpoints

Direct access to individual analysis features for specialized use cases.

POST /api/v1/features/security Security Feature Direct
Standard Rate Limit ▼
🔐 Authentication required - Include your API key in the Authorization header

Direct access to the security analysis feature with detailed EVA and GoPlus integration.

POST /api/v1/features/market Market Analysis Feature
Standard Rate Limit ▼
🔐 Authentication required - Include your API key in the Authorization header

Provides market analysis including price data, volume, market cap, and trading metrics.

POST /api/v1/features/holders Holder Analysis Feature
Standard Rate Limit ▼
🔐 Authentication required - Include your API key in the Authorization header

Analyzes token holder distribution, concentration, and patterns.

POST /api/v1/features/wash-trading Wash Trading Detection
Standard Rate Limit ▼
🔐 Authentication required - Include your API key in the Authorization header

Detects potential wash trading patterns and artificial volume inflation.

POST /api/v1/features/sniper-sellers Sniper Sellers Analysis
Standard Rate Limit ▼
🔐 Authentication required - Include your API key in the Authorization header

Identifies sniper bot activity and early seller patterns that may indicate token manipulation.

POST /api/v1/features/social-score Social Score Analysis
Standard Rate Limit ▼
🔐 Authentication required - Include your API key in the Authorization header

Analyzes social media presence and community engagement metrics for the token.

Request Parameters

contract_address string
The token contract address to analyze
chain string
Blockchain network (eth, base, bsc)
databot_api_key string
Optional: Custom Databot API key for enhanced data

User Management Endpoints

GET /api/v1/user/stats User Statistics
Low Rate Limit ▼
🔐 Authentication required - Include your API key in the Authorization header

Get usage statistics for your API key including calls made, remaining quota, and usage patterns.

{
  "success": true,
  "stats": {
    "total_calls": 245,
    "calls_today": 12,
    "calls_this_month": 245,
    "remaining_quota": 755,
    "plan": "pro",
    "quota_reset_date": "2024-02-01T00:00:00Z"
  }
}
GET /api/v1/user/recent-calls Recent API Calls
Low Rate Limit ▼
🔐 Authentication required - Include your API key in the Authorization header

Get your recent API calls history with timestamps and endpoints accessed.

Query Parameters

limit integer
Number of recent calls to return (default: 10, max: 50)
GET /api/v1/user/keys Get API Keys
Low Rate Limit ▼

Get API keys associated with a wallet address.

Query Parameters

wallet string
Wallet address to get keys for
POST /api/v1/user/create-key Create API Key
Low Rate Limit ▼

Create a new API key for a wallet address.

Request Parameters

wallet string
Wallet address
plan string
Plan type (starter, pro, team)
GET /api/v1/user/wallet-stats Wallet Statistics
Low Rate Limit ▼

Get usage statistics for a specific wallet address.

Query Parameters

wallet string
Wallet address to get stats for

Monetization Endpoints

POST /api/v1/generate-test-key Generate Test Key
Low Rate Limit ▼

Generate a free test API key with limited usage (10 scans, 7 days expiry).

Request Parameters

wallet string
Wallet address for the test key
{
  "success": true,
  "api_key": "test_1234567890abcdef",
  "quota": 10,
  "expires_at": "2024-01-15T00:00:00Z",
  "plan": "test"
}
POST /api/v1/purchase-plan Purchase API Plan
Low Rate Limit ▼

Purchase an API plan and receive an API key.

Request Parameters

wallet string
Wallet address
plan string
Plan type (starter, pro, team)
transaction_hash string
Payment transaction hash

System Endpoints

GET /api/v1/system/rate-limits Rate Limits Status
No Rate Limit ▼

Get current rate limiting status for all APIs. Helps integrators avoid rate limits by monitoring system load.

{
  "status": "success",
  "rate_limits": {
    "global_stats": {
      "current_concurrent": 12,
      "requests_this_minute": 156,
      "max_concurrent_requests": 50
    },
    "api_usage": {
      "eva": {
        "requests_today": 1250,
        "daily_limit": 10000,
        "remaining_daily": 8750,
        "rate_limit_hits": 0,
        "status": "healthy"
      },
      "goplus": {
        "requests_today": 2100,
        "daily_limit": 50000,
        "remaining_daily": 47900,
        "rate_limit_hits": 2,
        "status": "healthy"
      }
    }
  },
  "recommendations": [],
  "integrator_guidelines": {
    "max_concurrent_requests": 10,
    "requests_per_minute": 60,
    "retry_delay_seconds": 5,
    "batch_size": 5
  }
}
GET /health Health Check
No Rate Limit ▼

Basic health check endpoint to verify API availability.

{
  "status": "healthy",
  "timestamp": "2024-01-08T12:00:00Z",
  "version": "1.0.0",
  "uptime": "5 days, 12:34:56",
  "services": {
    "database": "connected",
    "eva_api": "operational",
    "goplus_api": "operational",
    "dexscreener_api": "operational"
  }
}