[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-77720":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":16,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":43,"readmeContent":44,"aiSummary":45,"trendingCount":16,"starSnapshotCount":16,"syncStatus":46,"lastSyncTime":47,"discoverSource":48},77720,"solana-top-traders-wallets-and-tokens-api","vybenetwork\u002Fsolana-top-traders-wallets-and-tokens-api","vybenetwork","Solana Top Traders Wallets & Tokens API: Demonstrates Vybe Solana Top Traders and Trades APIs to fetch and rank wallets by token mint or wallet query, plus token metadata, trade context, and top holders. Use as a reference implementation or starter kit for trader discovery, wallet intelligence, and profit and loss (PnL) and flow analysis products.","https:\u002F\u002Fdocs.vybenetwork.com",null,"TypeScript",214,80,106,5,0,78,50.53,false,"main",true,[23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42],"api","gmgn","holders","kolscan","nansen","pnl","profit-and-loss","pumpfun","pumpswap","raydium","solana","solana-api","solscan","spl","token","token-2022","tokens","traders","trades","whales","2026-06-12 04:01:22","# Solana Top Traders Wallets & Tokens API\n\nThis repository demonstrates how to use the Vybe Solana Top Traders and Trades APIs to fetch, rank, and explore high-performing wallets by either token mint (**token mode**) or wallet query (**wallet mode**). It includes a production-ready Node.js backend and a modern frontend that show how to integrate Vybe’s top-trader leaderboard, token metadata, trade context, and holders data to build a practical trader discovery UI.\n\nTry the live demo: https:\u002F\u002Fsolana-top-traders-wallets-and-tokens-api.vybenetwork.com\n\nUse this project as a reference implementation or starter kit for building Solana trader discovery tools, wallet intelligence dashboards, and PnL\u002Fflow analysis products powered by Vybe’s high-performance Solana data APIs.\n\n![Solana Top Traders Wallets & Tokens API](screenshots\u002Fsolana-top-traders-wallets-and-token-api-vybe.png)\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"screenshots\u002Fapi-for-solana-top-token-traders-and-wallets.png\" alt=\"API for Solana Top Token Traders & Wallets\" width=\"330\" style=\"min-width:330px;max-width:330px;margin-right:10px\" \u002F>\n  \u003Cimg src=\"screenshots\u002Fapi-for-solana-top-traders-wallets-and-token.png\" alt=\"API for Solana Top Traders Wallets and Tokens\" width=\"320\" style=\"min-width:320px;max-width:320px\" \u002F>\n\n\u003C\u002Fp>\n\n---\n\n**[Try the LIVE demo →](https:\u002F\u002Fsolana-top-traders-wallets-and-tokens-api.vybenetwork.com)**\n\n**[Get your free Vybe API key →](https:\u002F\u002Fvybenetwork.com\u002Fpricing)**  \n\n**[Vybe Solana data docs →](https:\u002F\u002Fdocs.vybenetwork.com)**\n\n---\n\n## Prerequisites\n\n- **Node.js** ≥ 20 (LTS recommended)\n- **npm** ≥ 10 (or equivalent)\n\n## Quick Start\n\nGet from clone to running app in a few commands:\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fvybenetwork\u002Fsolana-top-traders-wallets-and-tokens-api.git\ncd solana-top-traders-wallets-and-tokens-api\nnpm install\ncp .env.example .env\n# Edit .env and set VYBE_API_KEY=your_api_key_here\nnpm start\n```\n\nThen open **http:\u002F\u002Flocalhost:3000**, choose **Token** or **Wallet** mode, and click **Load**.\n\n## Environment Variables\n\n| Variable         | Required | Description                                                     | Example                                |\n|------------------|----------|-----------------------------------------------------------------|----------------------------------------|\n| `VYBE_API_KEY`   | Yes      | Vybe API key used for all Vybe requests                         | `your_api_key_here`                    |\n| `SOLANA_RPC_URL` | No       | RPC endpoint for token-symbol fallbacks (optional)              | `https:\u002F\u002Fapi.mainnet-beta.solana.com` |\n| `PORT`           | No       | HTTP server port                                                | `3000`                                 |\n| `TUNNEL`         | No       | Set to `1` to run behind a Cloudflare Tunnel                     | `1`                                    |\n\nGet your API key at `https:\u002F\u002Fvybenetwork.com\u002Fpricing`.\n\n---\n\n## What This Repo Provides\n\n- **Top traders + trades endpoint proxy**\n  - Express server that proxies Vybe:\n    - `GET \u002Fv4\u002Fwallets\u002Ftop-traders` (top traders leaderboard)\n    - `GET \u002Fv4\u002Ftrades` (trades context)\n    - `GET \u002Fv4\u002Fprograms\u002Flabeled-program-accounts` (program labels)\n    - `GET \u002Fv4\u002Ftokens\u002F{mintAddress}` (token metadata)\n    - `GET \u002Fv4\u002Ftokens\u002F{mintAddress}\u002Ftop-holders` (holder context)\n- **Top traders web UI**\n  - Single-page GUI (no frameworks) built from `src\u002Ffrontend\u002Fapp.ts` into `public\u002Fapp.js`.\n  - Lets you search and rank wallets by token mint or wallet query, sort by key fields, and review supporting token + trade context.\n- **Two discovery modes**\n  - **Token mode** — leaderboard scoped to a token via `mintAddress`.\n  - **Wallet mode** — search via `ilikeFilter` for wallet address\u002Fname\u002Flabel matching.\n- **Context panels**\n  - Token metadata panel (symbol, name, mint, decimals, price, market cap, volumes when available).\n  - Trade context summaries (top programs \u002F markets \u002F quote mints) derived from the latest fetched data.\n  - Holders table (top holders by % of supply) for quick holder-side context.\n\nAll of this uses Vybe’s production Solana datasets across major DEX venues and aggregated trading activity.\n\n---\n\n### Solana API docs for these endpoints\n\n- **Top traders (`GET \u002Fv4\u002Fwallets\u002Ftop-traders`)**:\n  - [https:\u002F\u002Fdocs.vybenetwork.com](https:\u002F\u002Fdocs.vybenetwork.com)\n- **Historical trades (`GET \u002Fv4\u002Ftrades`)**:\n  - [https:\u002F\u002Fdocs.vybenetwork.com\u002Freference\u002Fget_trade_data_program_v4](https:\u002F\u002Fdocs.vybenetwork.com\u002Freference\u002Fget_trade_data_program_v4)\n- **Token details (`GET \u002Fv4\u002Ftokens\u002F{mintAddress}`)**:\n  - [https:\u002F\u002Fdocs.vybenetwork.com\u002Freference\u002Fget_token_details_v4](https:\u002F\u002Fdocs.vybenetwork.com\u002Freference\u002Fget_token_details_v4)\n- **Top holders (`GET \u002Fv4\u002Ftokens\u002F{mintAddress}\u002Ftop-holders`)**:\n  - [https:\u002F\u002Fdocs.vybenetwork.com](https:\u002F\u002Fdocs.vybenetwork.com)\n- **Labeled programs (`GET \u002Fv4\u002Fprograms\u002Flabeled-program-accounts`)**:\n  - [https:\u002F\u002Fdocs.vybenetwork.com\u002Freference\u002Fget_known_program_accounts_v4](https:\u002F\u002Fdocs.vybenetwork.com\u002Freference\u002Fget_known_program_accounts_v4)\n\n---\n\n## Why Top Traders Data Matters\n\nTop-trader leaderboards are useful for:\n\n- **Trader discovery and intelligence**: find wallets that are consistently profitable (by realized PnL), active, or high-volume.\n- **Wallet clustering and follow lists**: start from a wallet query and fan out to related wallets returned by the leaderboard.\n- **Token research**: quickly see who is driving PnL and flow for a given mint, and pair it with token metadata and holder context.\n- **Program\u002Fvenue analysis**: use trade context to understand which programs and markets dominate the activity behind the leaderboard.\n\nThis repo shows how to build a **practical top-traders explorer** on top of Vybe’s top-traders, trades, and token endpoints.\n\n---\n\n## Frontend Overview (Top Traders UI)\n\nThe UI is implemented in `src\u002Ffrontend\u002Fapp.ts` and compiled to `public\u002Fapp.js` via `npm start` (which runs `npm run build:frontend` first).\n\n### Sections\n\n- **Token stats & metadata**\n  - Shows mint, decimals, category, verified flag, price, market cap, historical price comparisons, current supply, and 24h volumes where available.\n  - Token header includes a “Last updated” chip (from token metadata).\n\n- **Top traders leaderboard**\n  - One ranked list for the current mode:\n    - **Token mode**: leaderboard scoped to `mintAddress`.\n    - **Wallet mode**: leaderboard scoped to `ilikeFilter`.\n  - Sort controls map to Vybe `sortByAsc` \u002F `sortByDesc` query params.\n\n- **Trades context**\n  - Context tables computed from the latest fetched trades (no extra calls required beyond the fetch):\n    - **Top programs** (with labels)\n    - **Top markets**\n    - **Top quote mints**\n\n- **Holders context**\n  - Top holders table (by % supply) for the selected mint (token mode).\n\n---\n\n## Server Proxy Routes\n\nThe Express server in `src\u002Fserver.ts` exposes:\n\n- **`GET \u002Fapi\u002Ftokens\u002F:mint`**\n  - Proxies to Vybe `GET \u002Fv4\u002Ftokens\u002F{mintAddress}` for token metadata (used by the UI header).\n- **`GET \u002Fapi\u002Ftokens\u002F:mint\u002Ftop-holders`**\n  - Proxies to Vybe `GET \u002Fv4\u002Ftokens\u002F{mintAddress}\u002Ftop-holders` (holder context table).\n- **`GET \u002Fapi\u002Fwallets\u002Ftop-traders`**\n  - Proxies to Vybe `GET \u002Fv4\u002Fwallets\u002Ftop-traders` (main leaderboard).\n- **`GET \u002Fapi\u002Ftrades`**\n  - Proxies to Vybe `GET \u002Fv4\u002Ftrades` (trade context; query params forwarded).\n- **`GET \u002Fapi\u002Fprograms\u002Flabeled-program-account?programAddress=…`**\n  - Proxies to Vybe `GET \u002Fv4\u002Fprograms\u002Flabeled-program-accounts?programAddress=…` with caching.\n- **`POST \u002Fapi\u002Fprograms\u002Flabeled-program-accounts`**\n  - Batch label lookup for multiple program addresses with caching.\n- **`GET \u002Fapi\u002Fhealth`**\n  - Health check.\n\n---\n\n## How to Run\n\n### 1. Clone the repository\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fvybenetwork\u002Fsolana-top-traders-wallets-and-tokens-api.git\ncd solana-top-traders-wallets-and-tokens-api\n```\n\n### 2. Install dependencies\n\n```bash\nnpm install\n```\n\n### 3. Set your API key\n\n```bash\ncp .env.example .env\n# Add your VYBE_API_KEY to .env\n```\n\n### 4. Run the server + web app\n\n```bash\nnpm start\n```\n\nThen open **http:\u002F\u002Flocalhost:3000** and fetch results in **Token** or **Wallet** mode.\n\n### 5. (Optional) Run with Cloudflare Tunnel\n\n```bash\nTUNNEL=1 npm start\n```\n\n---\n\n## Project Structure\n\n```text\nsolana-top-traders-wallets-and-tokens-api\u002F\n├── .env.example           # Copy to .env, fill in VYBE_API_KEY (and optional SOLANA_RPC_URL, PORT, TUNNEL)\n├── tsconfig.json          # TypeScript config for backend\n├── tsconfig.frontend.json # TypeScript config for frontend (builds public\u002Fapp.js)\n├── package.json           # Scripts and dependencies\n├── README.md\n├── screenshots\u002F           # Screenshots referenced in this README (you update these)\n├── public\u002F                # Web GUI (HTML, CSS, built JS)\n│   ├── index.html\n│   ├── app.js             # Generated by `npm run build:frontend` from src\u002Ffrontend\u002Fapp.ts\n│   └── app.css\n└── src\u002F\n    ├── server.ts          # Express server; proxies Vybe API and serves public\u002F\n    ├── config.ts          # Env loading, API base URL, timeouts, PUBLIC_DIR\n    ├── cache.ts           # On-disk caches (symbol, program-label) in data\u002F\n    ├── types\u002F\n    │   └── api.ts         # Interfaces matching Vybe API response shapes\n    ├── api\u002F\n    │   ├── index.ts       # createClient(apiKey) — wires all API methods\n    │   ├── client.ts      # HTTP wrapper, retries, human-readable errors\n    │   ├── wallets.ts     # GET \u002Fv4\u002Fwallets\u002Ftop-traders\n    │   ├── trades.ts      # GET \u002Fv4\u002Ftrades, \u002Fv4\u002Fprograms\u002Flabeled-program-accounts\n    │   ├── tokens.ts      # GET \u002Fv4\u002Ftokens\u002F{mintAddress}, \u002Fv4\u002Ftokens\u002F{mintAddress}\u002Ftop-holders\n    │   └── token-symbol.ts# Token symbol fallback helpers (optional)\n    └── frontend\u002F\n        └── app.ts         # Top traders UI → builds to public\u002Fapp.js\n```\n\n---\n\n## Troubleshooting\n\n| Issue                         | What to do |\n|-------------------------------|-----------|\n| **403 Forbidden**             | Verify `VYBE_API_KEY` in `.env` is correct and has access to these endpoints. |\n| **Slow responses \u002F timeouts** | Retry later; reduce `limit` \u002F time range; check Vybe status. |\n| **Missing env vars**          | Ensure you copied `.env.example` to `.env` and set `VYBE_API_KEY`. |\n\n---\n\n## Support\n\n- **Telegram:** [Vybe community](https:\u002F\u002Ft.me\u002Fvybenetwork)\n- **Support ticket:** [Submit a ticket](https:\u002F\u002Fvybenetwork.com)\n\n","该项目提供了一个用于查询和排名Solana链上顶级交易者钱包及代币的API。核心功能包括通过代币铸造或钱包查询来获取并展示高性能钱包，同时提供代币元数据、交易上下文以及主要持有者信息。采用TypeScript编写，具备生产级Node.js后端与现代前端界面，便于集成到实际应用中。适用于构建基于Solana的数据分析工具，如交易者发现平台、钱包智能仪表盘及盈亏\u002F资金流动分析产品。",2,"2026-06-11 03:55:58","CREATED_QUERY"]