/polymarket/search
GET /polymarket/search is an endpoint of the Polymarket API by Struct API, listed on Proxygate by Struct. Search events, markets, traders, and builders 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 |
|---|---|---|---|
| q | string | Yes | Search query (min 2 characters). Slug-shaped values match event/market slugs. Prefix with 0x for exact wallet address lookup. |
| type | string | No | Comma-separated categories to search: events, markets, traders, builders (default: all four, 1 credit per type). Example: type=markets,builders |
| limit | integer | No | Results limit per category (default: 10, max: 250) |
| sort_by | string | No | Sort field applied to both events and markets (default: volume). Fields marked events-only or markets-only fall back to volume on the other category. |
| sort_dir | string | No | Sort direction (default: desc) |
| timeframe | string | No | Metrics timeframe used for volume/txns/unique_traders sort (default: 24h) |
| include_pnl | boolean | No | Include lifetime PnL summary for each trader (default: false, +1 credit) |
| events_pagination_key | string | No | Cursor for the next page of events, obtained from previous response's events_pagination.pagination_key |
| markets_pagination_key | string | No | Cursor for the next page of markets, obtained from previous response's markets_pagination.pagination_key |
| traders_pagination_key | string | No | Cursor for the next page of traders, obtained from previous response's traders_pagination.pagination_key |
| builders_pagination_key | string | No | Cursor for the next page of builders, obtained from previous response's builders_pagination.pagination_key |
Call /polymarket/search with an AI agent
# Call this endpoint with the Proxygate CLI
proxygate proxy polymarket-api-by-struct /polymarket/search -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/search"
})Polymarket API by Struct /polymarket/search: frequently asked questions
Search events, markets, traders, and builders
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/search 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.