/polymarket/holders/markets/history
GET /polymarket/holders/markets/history is an endpoint of the Polymarket API by Struct API, listed on Proxygate by Struct. Get market holders history 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 |
|---|---|---|---|
| to | integer | No | End timestamp (Unix seconds). Defaults to now. |
| from | integer | No | Start timestamp (Unix seconds). If omitted, derived from `hours` param. |
| hours | number | No | Fallback time range in hours when `from`/`to` are not provided (default: 24, max: 336 = 14 days) |
| count_back | integer | No | Number of candles to return (default: 500, max: 2500) |
| market_slug | string | No | Market slug (e.g. `will-trump-win`) |
| condition_id | string | No | Market condition ID (0x-prefixed hex) |
| pagination_key | string | No | Cursor-based pagination key from previous response |
Call /polymarket/holders/markets/history with an AI agent
# Call this endpoint with the Proxygate CLI
proxygate proxy polymarket-api-by-struct /polymarket/holders/markets/history -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/holders/markets/history"
})Polymarket API by Struct /polymarket/holders/markets/history: frequently asked questions
Get market holders history
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/holders/markets/history 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.