polymarket-tracker

name	polymarket-tracker
description	Track top Polymarket markets by trading volume. Shows market name, Yes/No trading volumes, and current odds. Use when user asks about Polymarket trends, hot markets, or wants to find high-volume trading opportunities. Requires payment via skillpay.me (0.001 USDT per call).

Polymarket Volume Tracker

Tracks real-time trading activity on Polymarket to identify high-volume markets.

What It Does

Analyzes active Polymarket markets and returns:

• Market name
• Yes/No trading volumes
• Current odds (probability)
• Total volume ranking

Usage

Basic Usage

python scripts/track_volume.py --api-key YOUR_SKILLPAY_API_KEY --user-id YOUR_USER_ID

Check Balance

python scripts/track_volume.py --api-key YOUR_SKILLPAY_API_KEY --user-id YOUR_USER_ID --check-balance

Testing (Skip Payment)

python scripts/track_volume.py --api-key YOUR_KEY --skip-payment

Environment Variables

You can also set credentials via environment variables:

export SKILLPAY_API_KEY=your_api_key_here
export SKILLPAY_USER_ID=your_user_id_here
python scripts/track_volume.py --api-key $SKILLPAY_API_KEY --user-id $SKILLPAY_USER_ID

Payment Integration

This skill uses skillpay.me for payment:

• Cost: 0.001 USDT per call
• API Key: Get from skillpay.me Dashboard → Integration Config
• Skill ID: ae30e94b-6cf4-444a-b734-f0ad65a50565
• Payment Method: BNB Chain USDT
• User ID: Required for billing identification

Payment Flow

1. Check Balance: System checks user's USDT balance
2. Charge User: If balance ≥ 0.001 USDT, deduct payment
3. Insufficient Balance: If balance < 0.001 USDT, returns payment link
4. Top Up: User can add balance via BNB Chain USDT payment link

Output Format

Returns a formatted list of top 10 markets by volume:

============================================================
Top 10 Polymarket Markets (Last 10 Minutes)
============================================================

1. Market Name
   - Yes Volume: $X
   - No Volume: $Y
   - Yes Odds: Z%
   - No Odds: W%
   - Total Volume: $T

2. ...

Data Source

• API: Polymarket Gamma API (https://gamma-api.polymarket.com)
• Markets: Active, non-closed markets only
• Volume: Total trading volume (lifetime)
• Odds: Current market odds from outcome prices

Billing API Reference

This skill integrates with skillpay.me billing API:

Check Balance

balance = check_balance(user_id)
# Returns: float (USDT amount)

Charge User

result = charge_user(user_id, amount=0.001)
# Returns: {"success": bool, "balance": float, "payment_url": str (if failed)}

Generate Payment Link

url = get_payment_link(user_id, amount)
# Returns: str (BNB Chain USDT payment URL)

Notes

• Volume data represents total market volume, not time-windowed
• Markets are sorted by total volume in descending order
• Returns top 10 markets with highest trading volume
• Payment required for each use (unless using --skip-payment)
• Minimum balance required: 0.001 USDT