Download Latest Version polymarket-leaderboard-standalone-1.0.0.zip (16.3 kB)
Home
Name Modified Size InfoDownloads / 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), marked rel="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

  1. Upload api/leaderboard.php to your site so it answers at https://your-site/api/leaderboard.php.
  2. Open https://your-site/api/leaderboard.php?health=1. You should see "ok": true, your PHP version, curl or fopen available and "cache_writable": true.
  3. Open https://your-site/api/leaderboard.php?category=OVERALL&period=MONTH: ten wallets in JSON.
  4. Upload leaderboard.css and leaderboard.js, then paste the widget block from index.html into your page. Set data-api to your proxy URL and data-locale to your language (e.g. fr-FR).
  5. 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 the fr or ru object from strings.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/vol may be null (unknown, never shown as 0).
  • 400 for any other value, 405 for 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.

Source: README.md, updated 2026-10-20