# AlphaClone

> Audited copytrading analytics, whale/insider alerts and non-custodial copy for
> Hyperliquid (perps) and Polymarket (prediction markets). We answer the one
> question that matters: can YOU actually copy this wallet with your bankroll?
> The platform is 100% free (voluntary donations). Every metric is computed from
> the official, real-time data of each venue (no reconstructed numbers).

AlphaClone is a non-custodial signals/analytics tool. It does not manage
capital and never holds user funds — copy execution signs from the user's own
wallet, and copy agents cannot withdraw. Two venues: **Hyperliquid** (Hyperliquid)
and **Polymarket** (Polymarket).

What it does:
- Audits any wallet/trader on demand (paste a 0x address; resolved live).
- Scores copyability ★1-5 on TIMING (can you mirror entry→exit with real latency?).
- Skeleton check: separates real edge from reward-farming / one-lucky-bet / dormant.
- Whale alerts and "new wallet, concentrated" alerts via Telegram.
- Auto-portfolio: give a bankroll, get the 5 best wallets you can genuinely copy.
- Realistic backtest that enforces venue minimum notional ($10 HL / $5 PM).

## For AI agents

AlphaClone exposes public, read-only REST endpoints AND a Model Context Protocol
(MCP) server. No auth is required for discovery, leaderboards, on-demand wallet
audits, auto-portfolio, and donation. Base URL: https://alphaclone.app (proxies
/api/* to the backend). Full machine spec: /llms-full.txt and
/.well-known/ai-plugin.json (capability manifest).

Start here (self-describing JSON): GET /api/ai — one manifest with every
endpoint, the meaning + units of each field, the copyability rubric, the MCP
endpoint and links. Per-wallet structured record (schema.org/Dataset JSON-LD):
GET /api/ai/wallet/{venue}/{address}.

### MCP (Model Context Protocol) — connect and use us as a native tool

- Endpoint (streamable-http): https://alphaclone.app/mcp
- Tools: `find_copyable_wallets(venue, min_copyability, limit, sort_by)`,
  `audit_wallet(venue, address)`, `auto_portfolio(venue, bankroll_usd)`,
  `wallet_pnl_curve(venue, address)`, `explain_copyability()`.
- Read-only, no auth, no keys. venue = `hl` (Hyperliquid) | `pm` (Polymarket).
- This is the fastest way for an agent to rank genuinely-copyable wallets and
  audit any address without scraping HTML.

### REST endpoints

- Self-describing manifest (JSON): GET /api/ai
- Copyability rubric (JSON): GET /api/ai/copyability
- Per-wallet JSON-LD (schema.org/Dataset): GET /api/ai/wallet/{venue}/{address}
- Capability manifest (JSON): /.well-known/ai-plugin.json
- Polymarket leaderboard: GET /api/pm/wallets?min_copy=4&sort_by=copy_score&limit=50
- Hyperliquid leaderboard: GET /api/wallets?min_copy=4&per_page=50
- Wallet/trader audit (PM): GET /api/pm/wallets/{address}
- Wallet/trader audit (HL): GET /api/wallets/{address}
- Official PnL curve (PM): GET /api/pm/wallets/{address}/equity
- Official PnL curve (HL): GET /api/wallets/{address}/equity
- Auto-portfolio by bankroll (PM): GET /api/pm/auto-portfolio?bankroll=1000
- Auto-portfolio by bankroll (HL): GET /api/wallets/auto-portfolio?bankroll=1000
- Donation address: GET /api/donation

## Pages

- [Leaderboard](https://alphaclone.app/leaderboard): rank the universe with cohort filters and a copyability slider.
- [Portfolio Builder](https://alphaclone.app/portfolio): pick N wallets, weight them, see a realistic backtested PnL curve.
- [Compare](https://alphaclone.app/compare): up to 3 wallets side by side (metrics, cohorts, copyability).
- [Docs / Help](https://alphaclone.app/docs): metric formulas, how-to guides, FAQ, glossary.

## Optional

- [Terms](https://alphaclone.app/legal/terms)
- [Privacy](https://alphaclone.app/legal/privacy)