nephyr-wallets

Nephyr Wallets

Smart money tracking for prediction markets. Discover, score, and analyze top Polymarket wallets.

Install

pip install nephyr-wallets
# With all extras:
pip install "nephyr-wallets[all]"

Quick Start

import asyncio
from nephyr_wallets import get_top_wallets, analyze_wallet, compare_wallets

async def main():
    # Get top 50 wallets
    wallets = await get_top_wallets(limit=50, window="all")

    # Deep analysis of a specific wallet
    analysis = await analyze_wallet("0x...")
    print(analysis.score.total_score)
    print(analysis.category_performance)
    print(analysis.monthly_returns)

    # Compare multiple wallets
    comparison = await compare_wallets(["0x...", "0x..."])

asyncio.run(main())

Scoring Formula

S(w) = α·log10(1 + PnL/1000) + β·(1 - CoV) + γ·(1 - entropy/log2(6)) − δ·max_drawdown

Default weights: α=0.4 (PnL), β=0.3 (consistency), γ=0.2 (specialization), δ=0.1 (drawdown penalty)

REST API

uvicorn api.app:app --reload

Endpoints:

• GET /v1/leaderboard — top wallets
• GET /v1/wallet/{address}/score — wallet score
• GET /v1/wallet/{address}/analysis — deep analysis
• GET /v1/wallet/{address}/trades — trade history
• POST /v1/compare — compare multiple wallets
• GET /v1/health — health check

MCP Server

nephyr-wallets-mcp

Tools: get_top_wallets, score_wallet, analyze_wallet, get_wallet_trades, compare_wallets

Pricing

Tier	Details
Free	Top 10 wallets, delayed 1 hour, 50 calls/day
Paid	$29/month — real-time, 50 wallets, unlimited calls
Agent-to-agent	$0.01/query