/polymarket/events
GET /polymarket/events is an endpoint of the Polymarket API by Struct API, listed on Proxygate by Struct. Get events AI agents call it per request through a transparent proxy and pay $0.0010 per request in USDC on Solana, with no subscription and no API key to manage.
$0.0010 / request
GET
USDC on Solana
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ai | boolean | No | Return truncated response optimized for AI consumers (default: false) |
| id | string | No | Filter by event ID(s) - comma-separated (max 50). Cannot be used with 'event_slugs'. Example: id=99600,99601,99583 |
| tags | string | No | Filter by tag slug(s) - comma-separated (max 50). Example: tags=sports,football,crypto |
| limit | integer | No | Results limit (default: 10, max: 100) |
| search | string | No | Search in title and description (3-100 characters). Example: search=trump |
| status | string | No | Filter by status: open, closed, or all (default: all) |
| sort_by | string | No | Sort: volume, txns, unique_traders, title, creation_date, start_date, end_date, relevance (relevance only works in search mode) (default: volume) |
| max_txns | integer | No | Maximum transactions in selected timeframe |
| min_txns | integer | No | Minimum transactions in selected timeframe |
| sort_dir | string | No | Sort direction: asc, desc (default: desc) |
| timeframe | string | No | Metrics timeframe: 1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d (default: 24h) |
| categories | string | No | Comma-separated category filters |
| max_volume | number | No | Maximum volume in selected timeframe |
| min_volume | number | No | Minimum volume in selected timeframe |
| event_slugs | string | No | Filter by event slug(s) - comma-separated (max 50). Cannot be used with 'id'. Example: event_slugs=will-trump-win,bitcoin-100k |
| exclude_tags | string | No | Comma-separated tag slugs to exclude |
| include_tags | boolean | No | Include tags array (default: true) |
| pagination_key | string | No | Cursor-based pagination key |
| include_markets | boolean | No | Include markets array with outcomes (default: true) |
| include_metrics | boolean | No | Include metrics object with all timeframes (default: true) |
| exclude_categories | string | No | Comma-separated categories to exclude |
| max_unique_traders | integer | No | Maximum unique traders in selected timeframe |
| min_unique_traders | integer | No | Minimum unique traders in selected timeframe |
Call /polymarket/events with an AI agent
# Call this endpoint with the Proxygate CLI
proxygate proxy polymarket-api-by-struct /polymarket/events -X GET// Call it from an AI agent over the Proxygate MCP server
call_api({
listing_id: "7742c7e4-1afe-483b-bdd6-e78dfc527a0e",
method: "GET",
path: "/polymarket/events"
})Polymarket API by Struct /polymarket/events: frequently asked questions
Get events
It costs $0.0010 per request, settled in USDC on Solana. There is no subscription and no monthly minimum: an agent pays per call from a single prepaid balance.
The agent calls GET /polymarket/events through the Proxygate gateway with the Proxygate CLI, SDK, or MCP server. Proxygate routes the request to the upstream provider, injects the provider key server-side, and returns the response with a signed receipt.
No. The upstream provider key never leaves the Proxygate gateway. Your agent authenticates once to Proxygate; the key is injected server-side per request and is never shared with or exposed to the agent.