​
Crypto Assets API

The Crypto Assets API provides access to curated crypto asset data, risk scores, exchange listings, and real-time market intelligence with 19 endpoints across four categories. Base URL: http://localhost:5001/api/v1/crypto-assets

​
Endpoint Categories

CategoryCountDescription
Database6Cached asset and exchange data (updated daily)
Market Intelligence4Real-time market data and trends
Nansen Analytics4On-chain flow intelligence and smart money tracking
Admin5Asset management and data updates

​
Database Endpoints

​
Query Assets

GET /crypto-assets/query Query approved assets with risk scores, optimized for frontend dropdowns. 
curl -H "Authorization: Bearer $TOKEN" \
  "http://localhost:5001/api/v1/crypto-assets/query?approved_only=true&min_score=70&limit=50"

​
List All Assets

GET /crypto-assets/all 
curl -H "Authorization: Bearer $TOKEN" \
  "http://localhost:5001/api/v1/crypto-assets/all?approved=true&min_score=70&limit=100"
Response: 
{
  "success": true,
  "count": 250,
  "assets": [
    {
      "symbol": "BTC",
      "name": "Bitcoin",
      "price_usd": 91282.00,
      "market_cap_usd": 1823027068010,
      "overall_risk_score": 81,
      "is_approved": true,
      "risk_scores": {
        "market_cap": 100,
        "liquidity": 85,
        "exchange": 100,
        "volatility": 65,
        "price_stability": 70,
        "supply_distribution": 100
      }
    }
  ]
}

​
Get Asset Details

GET /crypto-assets/symbols/{symbol}

​
List Approved Assets

GET /crypto-assets/symbols

​
List Exchanges

GET /crypto-assets/exchanges

​
Get Asset Exchanges

GET /crypto-assets/symbols/{symbol}/exchanges

​
Market Intelligence Endpoints

GET /crypto-assets/trending Top trending assets by 24h search volume.

​
Global Market Data

GET /crypto-assets/global-market Total market cap, BTC dominance, and 24h change.

​
Real-Time Market Data

GET /crypto-assets/market-data/{symbol}

​
OHLCV Data

GET /crypto-assets/ohlcv/{symbol} Historical candlestick data for technical analysis.

​
Nansen On-Chain Analytics

​
Token Holders Distribution

GET /crypto-assets/token-holders/{symbol}

​
Flow Intelligence

GET /crypto-assets/flow-intelligence/{symbol} Real-time capital flow analysis by wallet type. Query Parameters:
  • chain (default: ethereum)
  • timeframe: 5m, 1h, 6h, 12h, 1d, 7d

​
Smart Money Netflows

GET /crypto-assets/smart-money/netflows Market-wide accumulation/distribution patterns.

​
Smart Money Holdings

GET /crypto-assets/smart-money/holdings Current smart money positions.

​
Risk Scoring

Assets are scored across 6 factors (0-100, higher = lower risk):
FactorWeightDescription
Market Cap25%10B+=100,10B+ = 100, 1B-$10B = 80, …
Liquidity25%Volume and volume/market cap ratio
Exchange Quality20%Tier of listing exchanges
Volatility10%30-day annualized volatility
Price Stability10%Maximum drawdown in 30 days
Supply Distribution10%Holder concentration
Formula: 
Overall = (market_cap * 0.25) + (liquidity * 0.25) + (exchange * 0.20) +
          (volatility * 0.10) + (price_stability * 0.10) + (supply_distribution * 0.10)