polymarket-data-api_skill

Overview

This skill provides a lightweight Python interface to query Polymarket prediction market data via the public API (no authentication required). It exposes common read-only operations like listing top markets, searching markets, fetching market details, and listing events. The tool is designed for quick CLI queries and scripted data collection.

How this skill works

The skill calls Polymarket's public endpoints and parses responses into readable CLI output or JSON. It supports commands for top markets by 24h volume, text search, fetching a market by slug, and enumerating current events. Results can be printed in a human-friendly format or emitted as raw JSON for integration.

When to use it

• Quickly check trending prediction markets or recent market activity.
• Automate collection of market snapshots for analysis or reporting.
• Search for markets by keyword from scripts or the terminal.
• Fetch full market metadata for a specific market slug.
• Enumerate Polymarket events to discover related markets.

Best practices

• Use the --json flag when piping output into downstream tools or analysis scripts.
• Cache responses for short periods to avoid repeated identical requests during analysis runs.
• Rate-limit repeated queries in scripts to respect the public API and avoid throttling.
• Validate slugs returned by search before using them to fetch detailed market data.
• Combine --top with JSON output to programmatically monitor volume changes over time.

Example use cases

• Ad-hoc CLI check: list top markets by 24h volume to spot emerging activity.
• Data collection pipeline: schedule nightly snapshots of top market summaries in JSON.
• Research: search for markets containing a candidate or event name to gather related questions.
• Integration: fetch a market by slug to display details inside a dashboard or report.
• Discovery: list events to drive a workflow that generates alerts when new markets appear.