GET

/polymarket/market/trades

GET /polymarket/market/trades is an endpoint of the Polymarket API by Struct API, listed on Proxygate by Struct. Get market trades 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.

Price

$0.0010 / request

Method

GET

Settlement

USDC on Solana

Parameters

ParameterTypeRequiredDescription
aibooleanNoReturn truncated response optimized for AI consumers (default: false)
tointegerNoEnd timestamp (ms)
fromintegerNoStart timestamp (ms)
sidestringNoTrade side: 0 (Buy), 1 (Sell)
limitintegerNoResults per page (default: 10, max: 250)
slugsstringNoComma-separated market slugs
offsetintegerNoPagination offset (number of results to skip). Takes precedence over pagination_key.
outcomestringNoOutcome name filter (e.g. Yes, No)
tradersstringNoComma-separated trader addresses (max 25)
max_pricenumberNoMax price (0.0-1.0)
min_pricenumberNoMin price (0.0-1.0)
sort_descbooleanNoSort newest first (default: true)
trade_typesstringNoComma-separated trade types: OrderFilled, Redemption, Merge, Split, Cancelled, PositionsConverted, OrdersMatched, MakerRebate, Reward, Yield
position_idsstringNoComma-separated position IDs
builder_codesstringNoComma-separated builder codes (max 25)
condition_idsstringNoComma-separated condition IDs (max 20)
outcome_indexstringNoOutcome index: 0 (Yes), 1 (No)
max_usd_amountnumberNoMax USD amount
min_usd_amountnumberNoMin USD amount
pagination_keystringNoCursor-based pagination key obtained from previous response's pagination.pagination_key
max_shares_amountnumberNoMax shares amount
min_shares_amountnumberNoMin shares amount

Call /polymarket/market/trades with an AI agent

Proxygate CLI
# Call this endpoint with the Proxygate CLI
proxygate proxy polymarket-api-by-struct /polymarket/market/trades -X GET
MCP / agent
// Call it from an AI agent over the Proxygate MCP server
call_api({
  listing_id: "7742c7e4-1afe-483b-bdd6-e78dfc527a0e",
  method: "GET",
  path: "/polymarket/market/trades"
})

Polymarket API by Struct /polymarket/market/trades: frequently asked questions

Get market trades

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/market/trades 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.