Title: Bounmee Wallet Leaderboard
Author: Boun Mee
Published: <strong>April 3, 2026</strong>
Last modified: May 21, 2026

---

Search plugins

![](https://ps.w.org/bounmee-wallet-leaderboard/assets/icon-256x256.png?rev=3497988)

# Bounmee Wallet Leaderboard

 By [Boun Mee](https://profiles.wordpress.org/bounmee/)

[Download](https://downloads.wordpress.org/plugin/bounmee-wallet-leaderboard.3.7.0.zip)

 * [Details](https://wordpress.org/plugins/bounmee-wallet-leaderboard/#description)
 * [Reviews](https://wordpress.org/plugins/bounmee-wallet-leaderboard/#reviews)
 *  [Installation](https://wordpress.org/plugins/bounmee-wallet-leaderboard/#installation)
 * [Development](https://wordpress.org/plugins/bounmee-wallet-leaderboard/#developers)

 [Support](https://wordpress.org/support/plugin/bounmee-wallet-leaderboard/)

## Description

**Bounmee Wallet Leaderboard** fetches the top 10 Polymarket traders from the official
Polymarket Data API and renders them in a clean, responsive widget using a single
shortcode.

All API requests are proxied through WordPress (admin-ajax.php), so there are no
CORS issues regardless of your server environment. Data is always fetched fresh —
no caching — so visitors always see current rankings.

**Features:**

 * Live top-10 leaderboard ranked by PNL
 * **30D / 7D period toggle** — switch between 30-day and 7-day best wallets on 
   the widget, no page reload
 * **Two themes** — White (default, clean light design) and Navy Blue (dark gradient
   background, full contrast adaptation)
 * Category filters: All, Politics, Crypto, Sports, Culture, Tech, Finance, Macro
 * Wallet of the Day spotlight card with auto-generated performance analysis _(optional)_
 * Side-by-side wallet compare tool with PNL, volume, and efficiency bars _(optional)_
 * Optional CopyTrade button per row linking to an external copy-trading service_(
   opt-in, off by default)_
 * Server-side AJAX proxy — no CORS issues on any host
 * No caching — every request fetches live data from the Polymarket API
 * Zero first-paint spinner — data seeded server-side on page load
 * Mobile responsive: card layout on small screens, table on desktop
 * Fully theme-isolated CSS — scoped under a unique ID, immune to theme interference
   in both directions
 * No external JavaScript dependencies — pure vanilla JS, no jQuery required

**Shortcode:**

    ```
    [polymarket_leaderboard]
    ```

Optional default category:

    ```
    [polymarket_leaderboard category="CRYPTO"]
    ```

Valid values: `OVERALL` `POLITICS` `SPORTS` `CRYPTO` `CULTURE` `ECONOMICS` `TECH``
FINANCE`

### External Services

This plugin connects to the **Polymarket Data API** to retrieve public leaderboard
data.

 * **Service:** Polymarket Data API
 * **Endpoint:** `https://data-api.polymarket.com/v1/leaderboard`
 * **When it is called:** On every page load where `[polymarket_leaderboard]` is
   placed (server-side seed), and on every category filter click, period toggle,
   or Refresh button click (client-side via AJAX proxy)
 * **Data sent:** Query parameters only — leaderboard category, time period (MONTH
   or WEEK), result limit, and sort order. No user data of any kind is transmitted.
 * **Data received:** Public on-chain wallet rankings including rank, wallet address,
   username (if set), PNL, volume, profile image URL, and X username (if set). All
   data is public on-chain information.
 * **Polymarket Terms of Service:** https://polymarket.com/tos
 * **Polymarket Privacy Policy:** https://polymarket.com/privacy-policy

This plugin also loads fonts from **Google Fonts** on pages that use the shortcode:

 * **Service:** Google Fonts CDN
 * **URL:** `https://fonts.googleapis.com`
 * **Google Privacy Policy:** https://policies.google.com/privacy

### Privacy Policy

This plugin does not collect, store, or transmit any personal data about site visitors.

On page load and on user interactions (filter changes, period toggle, refresh), 
the plugin makes requests to the public Polymarket Data API. These requests contain
only query parameters (category, time period, limit) — no user information is included.

No analytics, tracking pixels, or third-party beacons are included.

## Screenshots

[[

[[

## Installation

 1. Upload the `bounmee-wallet-leaderboard` folder to `/wp-content/plugins/`, or install
    via **Plugins  Add New  Upload Plugin**.
 2. Activate the plugin via **Plugins  Installed Plugins**.
 3. Add `[polymarket_leaderboard]` to any page or post.
 4. Visit **Settings  Polymarket LB** to choose your theme, enable optional features.

## FAQ

### Does this plugin slow down my site?

No. Scripts and API calls only run on pages where `[polymarket_leaderboard]` is 
placed. Nothing is injected globally.

### What happens if the Polymarket API is down?

The widget falls back to anonymised demo data automatically. Clicking Refresh or
switching a filter will retry the live API.

### Can I set a default category?

Yes. Use `[polymarket_leaderboard category="POLITICS"]` to pre-select a category
on load. Valid values: OVERALL, POLITICS, SPORTS, CRYPTO, CULTURE, ECONOMICS, TECH,
FINANCE.

### Does it work with page caching plugins?

Yes. The initial seed data is rendered server-side and AJAX calls happen client-
side after page load, so full-page caching is fully compatible. The Refresh button
and period toggle always hit the live API.

### Will the widget break my theme’s styles?

No. All widget CSS is scoped under a unique ID with high specificity. It cannot 
affect your theme, and your theme cannot override the widget styles.

### What is the CopyTrade button?

An optional button that appears on each leaderboard row when enabled in Settings.
It links to an external copy-trading service of your choice. Disabled by default—
you must consciously enable it and set your URL in Settings. This is an affiliate/
referral feature — full disclosure is shown in the setup panel per WP.org guideline
10.

### What is the 30D / 7D toggle?

A pill toggle in the widget controls bar that switches the leaderboard between 30-
day (MONTH) and 7-day (WEEK) best wallets by calling the Polymarket API with the
corresponding `timePeriod` parameter. The leaderboard, mobile cards, Wallet of the
Day, and compare tool all update accordingly.

### How do I change the theme?

Go to **Settings  Polymarket LB** and choose White or Navy Blue under Widget Theme.
Save — the change applies immediately to all shortcode instances.

### What data does this plugin collect?

None. The plugin only fetches public data from the Polymarket API. No visitor data
is collected or transmitted.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Bounmee Wallet Leaderboard” is open source software. The following people have 
contributed to this plugin.

Contributors

 *   [ Boun Mee ](https://profiles.wordpress.org/bounmee/)

[Translate “Bounmee Wallet Leaderboard” into your language.](https://translate.wordpress.org/projects/wp-plugins/bounmee-wallet-leaderboard)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/bounmee-wallet-leaderboard/),
check out the [SVN repository](https://plugins.svn.wordpress.org/bounmee-wallet-leaderboard/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/bounmee-wallet-leaderboard/)
by [RSS](https://plugins.trac.wordpress.org/log/bounmee-wallet-leaderboard/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 3.6.4

 * New: 24H period toggle — adds a “🔥 24H” button alongside 30D and 7D, fetching`
   timePeriod=DAY` from the Polymarket API to surface wallets that are hot right
   now rather than long-term PNL leaders
 * New: Period-aware badge copy — the #1 wallet why-badge shows “🔥 Hottest wallet
   right now” in 24H mode instead of the standard monthly/weekly label
 * New: Subtitle label updates to “last 24-hour PNL” when 24H is active, consistent
   with 30D/7D behaviour
 * Fix: PHP period whitelist now includes `DAY` so AJAX proxy correctly passes the
   new period to the Polymarket API

#### 3.6.3

 * Fix: `shortcode_atts` filter tag was `bounwale_leaderboard` instead of `polymarket_leaderboard`—
   caused `[polymarket_leaderboard]` shortcode to not work correctly on sites using
   shortcode attribute filters
 * Fix: `wp_register_script/style` called with `false` as src (invalid) — changed
   to empty string `''`, the correct WordPress approach for inline-only asset handles
 * Fix: Table loading row used `colspan="6"` on a 5-column table — corrected to `
   colspan="5"` (affected both the PHP seed markup and the JS loading state)
 * Fix: `bounwale_maybe_redirect_setup` on `admin_init` now guards with `is_admin()`
   to prevent redirect loops on non-admin requests
 * Fix: `admin_enqueue_scripts` hook check now uses exact match `settings_page_bounwale-
   leaderboard` instead of `strpos` — prevents accidental asset loading on unrelated
   admin pages; also fixes the `false`-src registers for admin handles
 * Fix: `uninstall.php` was deleting `ttg_options` / `ttg_setup_redirect` (legacy
   keys from an old version) instead of `bounwale_options` / `bounwale_setup_redirect`—
   plugin options were never cleaned up on deletion
 * Fix: readme.txt 3.6.1 changelog entry was self-contradictory (listed two conflicting
   rename targets); corrected to reflect final slug `bounmee-wallet-leaderboard`
 * Fix: README.md Plugin URI pointed to old slug `prediction-market-wallet-leaderboard`;
   updated to `bounmee-wallet-leaderboard`

#### 3.6.2

 * Plugin officially renamed to “Bounmee Wallet Leaderboard”; slug `bounmee-wallet-
   leaderboard`
 * Fix: Layout never scrolls horizontally — root container enforces `overflow-x:
   hidden`; table uses `table-layout:fixed` instead of fixed `min-width`
 * Fix: Responsive breakpoints extended — new 900px, 360px breakpoints ensure widget
   fills its container cleanly at all screen sizes without breaking or overflowing
 * Fix: Mobile card actions stack to single column on phones ≤480px for better tap
   targets
 * Fix: Filter buttons, WOTD stats, and card padding tightened on very small screens(
   ≤360px)

#### 3.6.1

 * Fix: Wallet of the Day “Share on X” button on mobile now correctly populated 
   with wallet stats (was always `href="#"`)
 * Fix: PHP category whitelist trimmed to match UI — removed unused `MENTIONS` and`
   WEATHER` values
 * Plugin renamed to “Bounmee Wallet Leaderboard”; slug updated to `bounmee-wallet-
   leaderboard`

#### 3.6.0

 * Fix: All inline `<script>` and `<style>` tags replaced with proper WordPress 
   enqueue API (`wp_register_script/style`, `wp_add_inline_script/style`) — required
   for WP.org compliance
 * Fix: Admin JS registered under its own handle; admin assets hooked via `admin_enqueue_scripts`
   with page-scoped check

#### 3.5.0 — 3.5.1

 * Fix: Controls row (live dot + 30D/7D + Refresh) centred on both themes, desktop
   and mobile
 * Fix: “Compare Any Two Wallets” heading centred on both themes

#### 3.4.1 — 3.4.9

 * Fix: Table row colour bleed eliminated; text sizes increased for readability
 * Fix: 7D volume fallback chain (`vol → volume → tradedAmount → notional`)
 * Fix: Share on X split into desktop and mobile copies, both updated by JS
 * Fix: Navy Blue theme rendered as rounded card with padding and shadow
 * Fix: Compare accordion alignment and text stacking on all themes

#### 3.3.0

 * New: White / Navy Blue theme selector in Settings
 * New: 30D / 7D period toggle — switches `timePeriod` on the Polymarket API; all
   UI elements reflect the selected period
 * Removed all transient and sessionStorage caching — always-live data
 * Fixed: WCAG AA contrast on PNL green, rank badges, and wallet addresses in both
   themes

#### 3.2.0 — 3.2.3

 * Added first-run setup wizard and Settings page with opt-in feature controls
 * All external links off by default (WP.org guideline 10)
 * Full CSS isolation scoped under `#ttg-lb-root-wp`

#### 3.0.0 — 3.1.0

 * Initial release: server-side AJAX proxy, category filters, Wallet of the Day,
   compare tool, mobile card layout, demo data fallback
 * Google Fonts loaded via `wp_enqueue_style`; `uninstall.php` added

## Meta

 *  Version **3.7.0**
 *  Last updated **2 months ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 5.5 or higher **
 *  Tested up to **7.0.2**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [leaderboard](https://wordpress.org/plugins/tags/leaderboard/)[prediction markets](https://wordpress.org/plugins/tags/prediction-markets/)
   [trading](https://wordpress.org/plugins/tags/trading/)[wallets](https://wordpress.org/plugins/tags/wallets/)
 *  [Advanced View](https://wordpress.org/plugins/bounmee-wallet-leaderboard/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/bounmee-wallet-leaderboard/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/bounmee-wallet-leaderboard/reviews/)

## Contributors

 *   [ Boun Mee ](https://profiles.wordpress.org/bounmee/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/bounmee-wallet-leaderboard/)