Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man polymarket-filter

/polymarket-filter

agentutility / edge-finance / polymarket-filter
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CATEGORY
uncategorized
STATUS
live
NAME
polymarket-filter polymarket filter api / filter prediction markets by category, query, tag, status, liquidity, and sort order
synonym alias of polymarket-markets — reuses the canonical handler.
SYNOPSIS
POST https://x402.agentutility.ai/polymarket-filter
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

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

Polymarket filter API / filter prediction markets by category, query, tag, status, liquidity, and sort order. Market-data filter only; it does not filter wallets by trade history.

INPUTrequest schema
propertytypedescriptionreq?
querystringoptional
categorystringoptional
tagstringoptional
activebooleanoptional
closedbooleanoptional
limitnumberoptional
offsetnumberoptional
orderstring
enum: volume24hr · liquidity · endDate · startDate
optional
ascendingbooleanoptional
min_liquiditynumberoptional
OUTPUTresponse shape
fieldtypedescription
marketsstring
countstring
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/polymarket-filter \
  -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-filter tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
polymarketfilterpolymarket-filter
methods
POST
cluster
edgefinance
price
$0.005 USDC per call
ADJACENTother endpoints in edgefinance
endpointdescriptionprice
kalshi-marketsLists live Kalshi event contract markets from api.elections.kalshi.com, with filters for status, series ticker, event ticker, free-text q…$0.005
market-filterFilters Polymarket prediction markets by query, category, tag, liquidity, open/closed status, and sort order, on a demand-matching route.$0.005
marketsLists and searches Polymarket prediction markets, backed by gamma-api public market data under an exact buyer-demand slug.$0.005
polymarket-leaderboardReturns the Polymarket leaderboard: top accounts by realized profit OR notional volume over 1d/1w/1m/all-time windows.$0.005
polymarket-marketsLists live Polymarket prediction markets from gamma-api, with filters for category, tag, free-text query, and minimum liquidity.$0.005
polymarket-searchSearches Polymarket prediction markets by question, description, and slug over the returned market page, with optional category/tag/liqui…$0.005
polymarket-tradesRecent trades from any Polymarket market (by slug or conditionId) or for a specific wallet.$0.005
prediction-marketsList and search active Polymarket prediction markets with outcome probabilities, liquidity, volume, end dates, and URLs.$0.005
SEE ALSO
agentutility · edgefinance · x402 · mcp · llms.txt · registry.json · bazaar.x402.org