Name: polymarket-trades
Price: 0.005 USDC
Availability: InStock

$ man polymarket-trades

agentutility / edge-finance / polymarket-trades

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

edgefinance

CATEGORY

uncategorized

STATUS

● live

NAME

polymarket-trades — recent trades from any polymarket market (by slug or conditionid) or for a specific wallet

SYNOPSIS

POST https://x402.agentutility.ai/polymarket-trades
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Recent trades from any Polymarket market (by slug or conditionId) or for a specific wallet. Returns side, size, price, timestamp, trader pseudonym, on-chain tx hash, and computed notional USD. A data-only Polymarket trade feed for prediction-market and on-chain bet-history research.

INPUT — request schema

property	type	description	req?
market	string	Market slug (e.g. 'will-x-happen') OR conditionId (0x...). Optional.	optional
user	string	Polymarket proxy wallet address to filter by. Optional.	optional
limit	number	1-500. Default 50.	optional
offset	number	Pagination offset.	optional
side	string	Filter by side. enum: BUY · SELL	optional
after_ts	number	Unix seconds. Only trades after.	optional
before_ts	number	Unix seconds. Only trades before.	optional

OUTPUT — response shape

field	type	description
trades	string	Array of recent Polymarket trades with side, size, price, timestamp, trader pseudonym, and on-chain tx hash.
count	string	Number of trades returned in the trades array for the requested market or wallet.
total_notional_usd	string	Sum of notional USD value across all returned trades, computed as size times price.
attribution	string	Source credit string pointing to Polymarket as the upstream data provider for these trades.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/polymarket-trades \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the polymarket-trades tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: edge-financepolymarketprediction-marketstrade-feedon-chain-tradeswallet-historymarket-datapolymarket-trades
methods: POST
cluster: edgefinance
price: $0.005 USDC per call

ADJACENT — other endpoints in edgefinance

endpoint	description	price
kalshi-markets	Lists live Kalshi event contract markets from api.elections.kalshi.com, with filters for status, series ticker, event ticker, free-text q…	$0.005
market-filter	Filters Polymarket prediction markets by query, category, tag, liquidity, open/closed status, and sort order, on a demand-matching route.	$0.005
markets	Lists and searches Polymarket prediction markets, backed by gamma-api public market data under an exact buyer-demand slug.	$0.005
polymarket-filter	Filters and searches active Polymarket prediction markets by category, keyword query, tag, liquidity threshold, and sort order.	$0.005
polymarket-leaderboard	Returns the Polymarket leaderboard: top accounts by realized profit OR notional volume over 1d/1w/1m/all-time windows.	$0.005
polymarket-markets	Lists live Polymarket prediction markets from gamma-api, with filters for category, tag, free-text query, and minimum liquidity.	$0.005
polymarket-search	Searches Polymarket prediction markets by question, description, and slug over the returned market page, with optional category/tag/liqui…	$0.005
prediction-markets	List and search active Polymarket prediction markets with outcome probabilities, liquidity, volume, end dates, and URLs.	$0.005