Wallet Scores API

# Get the score for a specific wallet
curl "https://api.stratiumsol.com/v1/wallets/7xKXLkq...9bPq/score" \
  -H "X-API-Key: sk_live_your_key"

# List top scored wallets
curl "https://api.stratiumsol.com/v1/wallets/scored?min_score=0.7&limit=20" \
  -H "X-API-Key: sk_live_your_key"

const API_KEY = process.env.STRATIUM_API_KEY!;
const BASE = "https://api.stratiumsol.com/v1";

// Single wallet score
const score = await fetch(`${BASE}/wallets/${walletAddress}/score`, {
  headers: { "X-API-Key": API_KEY },
}).then((r) => r.json());

console.log(score.data.enriched_score); // 0.847

// Top scored wallets
const top = await fetch(`${BASE}/wallets/scored?min_score=0.7&limit=20`, {
  headers: { "X-API-Key": API_KEY },
}).then((r) => r.json());

for (const wallet of top.data) {
  console.log(`${wallet.wallet_address}: ${wallet.enriched_score}`);
}

import os
import requests

API_KEY = os.environ["STRATIUM_API_KEY"]
BASE = "https://api.stratiumsol.com/v1"
HEADERS = {"X-API-Key": API_KEY}

# Single wallet score
score = requests.get(f"{BASE}/wallets/{wallet_address}/score", headers=HEADERS).json()
print(score["data"]["enriched_score"])  # 0.847

# Top scored wallets
top = requests.get(f"{BASE}/wallets/scored", params={"min_score": 0.7, "limit": 20}, headers=HEADERS).json()
for wallet in top["data"]:
    print(f"{wallet['wallet_address']}: {wallet['enriched_score']}")

interface WalletScore {
  wallet_address: string;         // Solana wallet address
  enriched_score: number;          // Composite quality score (0-1)
  win_rate: number;                // % of SELL trades profitable
  total_pnl_sol: number;           // Total realized PnL in SOL
  sell_count: number;              // Total SELL trades analyzed
  win_count: number;               // Profitable SELL trades
  avg_pnl_percent: number;         // Average PnL per trade (%)
  avg_holding_time_sec: number;    // Average holding time in seconds
  best_trade_pnl_sol: number;      // Largest single-trade PnL
  profit_factor: number;           // Gross profit / gross loss
  max_drawdown_pct: number;        // Worst peak-to-trough decline (%)
  consistency_score: number;       // Performance consistency (0-1)
  sharpe_per_trade: number;        // Risk-adjusted return per trade
  concentration_top_token_pct: number; // % PnL from top token
  concentration_top_token: string; // Mint of top PnL token
  median_hold_time_sec: number;    // Median holding time
  sizing_cv: number;               // Trade size coefficient of variation
  noise_flags: string[];           // Quality flags: high_frequency,
                                   // single_token, small_trades,
                                   // round_trip, young_wallet
  discovery_source: string;        // How wallet was discovered
  review_status: string;           // scored | promoted
  updated_at: string;              // ISO 8601 timestamp
}

{
  "success": true,
  "data": {
    "wallet_address": "7xKXLkqR2gNJmV4wHs7s3N9bPq",
    "enriched_score": 0.847,
    "win_rate": 72.4,
    "total_pnl_sol": 142.8,
    "sell_count": 156,
    "win_count": 113,
    "avg_pnl_percent": 18.4,
    "avg_holding_time_sec": 3240,
    "best_trade_pnl_sol": 28.6,
    "profit_factor": 3.21,
    "max_drawdown_pct": 12.5,
    "consistency_score": 0.89,
    "sharpe_per_trade": 0.42,
    "concentration_top_token_pct": 15.2,
    "concentration_top_token": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "median_hold_time_sec": 2100,
    "sizing_cv": 0.34,
    "noise_flags": [],
    "discovery_source": "program_observer",
    "review_status": "scored",
    "updated_at": "2026-04-14T08:30:00Z"
  },
  "timestamp": "2026-04-14T12:00:00Z"
}