Agent skill

Polymarket

Trending and top markets on Polymarket — volume, new markets, biggest movers

Stars 152
Forks 17

Install this agent skill to your Project

npx add-skill https://github.com/aaronjmars/aeon/tree/main/skills/polymarket

SKILL.md

${var} — Market category or search term to focus on (e.g. "crypto", "elections", "AI", "sports"). If empty, shows top markets across all categories.

Read memory/MEMORY.md for context. Read the last 2 days of memory/logs/ to avoid repeating data.

Steps

  1. Fetch active markets from Polymarket's public API:

    bash
    # Top markets by volume (24h) — primary data source
    curl -s "https://gamma-api.polymarket.com/markets?closed=false&order=volume24hr&ascending=false&limit=20"
    
    # Recently created markets (new & trending)
    curl -s "https://gamma-api.polymarket.com/markets?closed=false&order=startDate&ascending=false&limit=20"
    

    Note: Do NOT use order=liquidity — this endpoint returns unreliable data (sub-$10k garbage values). Instead, extract liquidity from the volume response (markets with high volume inherently have liquidity) or use the CLOB API:

    bash
    # If you need liquidity data, use the CLOB API for specific markets
    # (get the condition_id from the volume response first)
    curl -s "https://clob.polymarket.com/book?token_id=CONDITION_ID"
    
  2. Analyze and surface. If ${var} is set, filter markets to those related to that topic:

    • Top 10 markets by 24h volume — question, current odds (yes/no %), 24h volume
    • Biggest price movers — markets where yes/no price shifted most in 24h (compare with recent logs if available)
    • New & notable — recently created markets that are gaining traction (decent volume for a new market)
    • Validate data: discard any market with volume < $1,000 or nonsensical odds (e.g. both YES and NO at 0%). These are API artifacts.
  3. For any especially interesting market, use WebSearch or WebFetch to grab context on why it's moving.

  4. Send via ./notify (under 4000 chars):

    *Polymarket — ${today}*
    
    *Top by Volume (24h)*
    1. "Question?" — YES X% / NO Y% ($Xm vol)
    2. ...
    
    *Biggest Movers*
    ↑ "Question?" — YES X% → Y% (+Z%)
    ↓ "Question?" — YES X% → Y% (-Z%)
    
    *New & Notable*
    - "Question?" — $Xk vol, launched Xd ago
    
    *Liquidity Leaders*
    1. "Question?" — $Xm liquidity
    
  5. Log to memory/logs/${today}.md. If the API returns empty or errors, log "POLYMARKET_OK" and end.

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results