Перейти до основного вмісту

Crypto Intelligence API

Overview​

Endpoints for crypto project risk scoring, market data, and whale alerts. Base path: /api/crypto

🔎 Search & Projects​

Search Projects​

GET /api/crypto/search

Returns both local DB results and active CoinGecko listings.

Parameters:

  • q: Search query (min 1 char)
  • limit: Max results (default 10)

Get Project Details​

GET /api/crypto/project/{slug}

Returns the cached project snapshot first. When no snapshot exists, the service performs one materialization attempt. A cached hit does not call CoinGecko metadata enrichment or wait for a live-market request.

Parameters:

  • slug: Project identifier (e.g., ethereum, solana)
  • refresh: Optional explicit fresh-data request. true may call upstream harvesters and may overlay live-market fields.

Response:

{
  "project": {
    "name": "Ethereum",
    "price_usd": 2500.5,
    "trust_score": 92,
    "risk_level": "low",
    "data_completeness": {
      "available_pillars": 5,
      "total_pillars": 6,
      "coverage_pct": 83.3,
      "is_insufficient": false,
      "missing_pillars": ["community"]
    }
  },
  "source": "full_service",
  "harvesters": ["coingecko", "github", "defillama"]
}

The response keeps the project, source, and harvesters fields on the full-service path. A cache miss is materialized at most once within the request.

Get Live Market Snapshot​

GET /api/crypto/live/{slug}

Loads the separate live-market snapshot. Use this endpoint when current market fields are required instead of treating the default project response as a live price contract.

🛡️ Risk Scoring​

Trust Score Breakdown​

The Trust Score (0-100) is calculated based on 6 pillars:

  1. Treasury (20%): Market Cap + TVL
  2. Dev Activity (20%): GitHub commits + Active Devs
  3. Financials (15%): MCap/FDV Ratio (Dilution risk)
  4. Security (20%): CertiK Audit Score
  5. Tokenomics (15%): Backer Quality + Unlock Progress
  6. Community (10%): Social Score

Runtime scoring notes:

  • OG assets (bitcoin, ethereum, bnb aliases) are exempt from no-audit Security penalty.
  • The scoring engine computes stage-aware data_completeness metadata for internal decision quality (available_pillars, coverage_pct, missing_pillars).

📊 Market Data​

Top Projects​

GET /api/crypto/top

Returns top projects by Market Cap.

Price Charts​

GET /api/crypto/chart/{slug}

Returns historical OHLCV data for charts.

Parameters:

  • days: History length (default 30)

🚨 Alerts & Reports​

Whale Alerts​

GET /api/crypto/whales/alerts

Returns large transaction alerts (> $100k).

Generate PDF Report​

GET /api/crypto/report/{slug}

Generates and downloads a detailed PDF investment memo. Note: Takes 10-20 seconds to generate (includes AI analysis).