Skip to content

A clean, modern web dashboard to inspect the trading activity and portfolio of any Polymarket user.

Notifications You must be signed in to change notification settings

dorukanc/polymarket-inspector

Repository files navigation

Polymarket User Inspector 🕵️‍♂️

A clean, modern web dashboard to inspect the trading activity and portfolio of any Polymarket user. Built with Next.js, Tailwind CSS, and the Polymarket Data & CLOB APIs.

Polymarket Inspector Screenshot

✨ Features

  • 🔍 Wallet Inspection: View positions and history for any Polygon wallet address.
  • 💰 Live Portfolio Value: Real-time calculation of current holdings based on live CLOB market prices.
  • 📊 Profit/Loss Analysis: See your average entry price vs. current market price with P/L percentages.
  • 📜 Transaction History: Full paginated history of trades, redemptions, and transfers.
  • 🤖 AI-Ready Exports: One-click "Copy for AI" to paste data directly into ChatGPT/Claude for analysis.
  • Tb CSV Export: Download your data for spreadsheet analysis.

🛠 Tech Stack

🚀 Getting Started

Prerequisites

  • Node.js 18+ installed
  • npm or yarn

Installation

  1. Clone the repository:

    git clone https://github.com/dorukanc/polymarket-inspector.git
    cd polymarket-inspector
  2. Install dependencies:

    npm install
  3. Run the development server:

    npm run dev
  4. Open your browser: Navigate to http://localhost:3000

📖 How to Use

  1. Enter Address: Paste a Polygon wallet address (starts with 0x...) into the search bar.
  2. Inspect: Click the "Inspect" button.
  3. Analyze:
    • Summary Cards: Top-level view of value, volume, and activity.
    • Positions Table: See what the user is currently holding and their P/L.
    • History Table: Review past trades.
  4. Export: Use the "Copy for AI" or "Export CSV" buttons to take your data elsewhere.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Built by dorukanc

About

A clean, modern web dashboard to inspect the trading activity and portfolio of any Polymarket user.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published