| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| polymarket-leaderboard-standalone-1.0.0.zip | 2026-10-20 | 16.3 kB | |
| README.md | 2026-10-20 | 4.6 kB | |
| Totals: 2 Items | 20.9 kB | 1 |
Polymarket Wallet Leaderboard: standalone widget (any website)
The non-WordPress version of the Bounmee Wallet Leaderboard plugin: the same live Polymarket top-10 wallet ranking for any site that runs PHP 7.4+, as one PHP file and one JavaScript module. It is the code running on telegramtrading.net/best-polymarket-smart-wallets-copytrading/.
Version 1.0.0 · GPL-2.0-or-later · by TelegramTrading.net
Source and issues: GitLab, mirrored on Codeberg.
What it shows
- Top 10 Polymarket wallets by PNL for 30 days, 7 days or 24 hours, in 8 categories (All, Politics, Macro, Crypto, Sports, Culture, Tech, Finance), from the official Polymarket Data API.
- The top wallet in numbers (PNL, volume, PNL to volume ratio), copy address, Polymarket profile, share on X.
- A two-wallet comparison. The ratio is profit divided by volume, not a win rate.
- Optional copy-trading link per row (
data-copy-url), markedrel="sponsored nofollow noopener". - English, French and Russian strings (
strings.json), local number formats, keyboard and screen-reader friendly, mobile cards under 680 px.
How it stays reliable
- The browser only calls your
api/leaderboard.php, never Polymarket directly. - The PHP proxy caches each category and period for 5 minutes (at most 24 upstream calls per 5 minutes whatever the traffic) and serves the last good copy, up to 24 hours old, if Polymarket is down. The widget then says the data is stale and shows its real time.
- No demo or invented wallets, ever: if there is no data, it says so.
- No database, no API key, no cookies, no third-party scripts or fonts.
Files
| File | Goes to |
|---|---|
api/leaderboard.php |
<web root>/api/leaderboard.php |
api/leaderboard.config.example.php |
optional: copy to api/leaderboard.config.php and set cache_dir to a folder outside the web root |
leaderboard.js, leaderboard.css |
anywhere public, e.g. /assets/ |
index.html |
working example: copy the block between the two comments into your page |
strings.json |
EN/FR/RU texts: paste the language you need into the data-lb-strings script |
Install in 5 steps
- Upload
api/leaderboard.phpto your site so it answers athttps://your-site/api/leaderboard.php. - Open
https://your-site/api/leaderboard.php?health=1. You should see"ok": true, your PHP version,curlorfopenavailable and"cache_writable": true. - Open
https://your-site/api/leaderboard.php?category=OVERALL&period=MONTH: ten wallets in JSON. - Upload
leaderboard.cssandleaderboard.js, then paste the widget block fromindex.htmlinto your page. Setdata-apito your proxy URL anddata-localeto your language (e.g.fr-FR). - Optional: put your copy-trading link in
data-copy-url(leave it empty to hide the button) and disclose it as an affiliate link on the page.
Customise
- Colours and fonts: the CSS variables at the top of
leaderboard.css(--tt-blue,--tt-gold,--tt-head…). - Language: replace the JSON inside
<script type="application/json" data-lb-strings>with thefrorruobject fromstrings.json, and translate the few labels in the markup. - Server snapshot (optional, best for SEO): render the table rows and a
<script type="application/json" data-lb-seed>with the API response at build or request time; the widget then skips the first fetch.
API contract
GET /api/leaderboard.php?category=OVERALL|POLITICS|ECONOMICS|CRYPTO|SPORTS|CULTURE|TECH|FINANCE&period=MONTH|WEEK|DAY
200 {ok:true, category, period, source, fetched_at, stale, items:[{rank, proxyWallet, userName, pnl, vol, profileImage, xUsername, verifiedBadge}]};pnl/volmay benull(unknown, never shown as 0).400for any other value,405for other methods,503 {ok:false, error:"upstream_unavailable"}when Polymarket fails and no copy younger than 24 h exists.
Changelog
1.0.0
- First standalone release, from the telegramtrading.net production code (port of WordPress plugin 3.7.1 with the 3.8.0 fixes: cache, no demo data, factual labels, sponsored links, no Google Fonts).
License
GPL-2.0-or-later, like the WordPress plugin.