Name: market-filter
Price: 0.005 USDC
Availability: InStock

$ man market-filter

agentutility / edge-finance / market-filter

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

edgefinance

CATEGORY

uncategorized

STATUS

● live

NAME

market-filter — filters polymarket prediction markets by query, category, tag, liquidity, open/closed status, and sort order, on a demand-matching route

synonym alias of polymarket-markets — reuses the canonical handler.

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Filters Polymarket prediction markets by query, category, tag, liquidity, open/closed status, and sort order, on a demand-matching route. Data-only public market research endpoint; no wallet filtering or trade execution. Use it as a Polymarket filter API or market screener.

INPUT — request schema

property	type	description	req?
query	string	Free-text filter applied to question, description, and slug.	optional
category	string	Filter by Polymarket category substring, e.g. 'Sports', 'Crypto', 'Politics'.	optional
tag	string	Polymarket tag slug filter, passed through to upstream.	optional
active	boolean	Default true. Pass false to include inactive markets.	optional
closed	boolean	Default false. Pass true to include closed markets.	optional
limit	number	1-100. Default 20.	optional
offset	number	Pagination offset.	optional
order	string	Sort field: 'volume24hr', 'liquidity', 'endDate', or 'startDate'. Omit for default gamma-api order. enum: volume24hr · liquidity · endDate · startDate	optional
ascending	boolean	Sort direction when order is set. Default false (descending).	optional
min_liquidity	number	Minimum liquidity in USD.	optional

OUTPUT — response shape

field	type	description
markets	string	—
count	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/market-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 market-filter tool from your MCP-aware agent.

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

METADATA

tags: marketfiltermarket-filter
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
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
polymarket-trades	Recent trades from any Polymarket market (by slug or conditionId) or for a specific wallet.	$0.005
prediction-markets	List and search active Polymarket prediction markets with outcome probabilities, liquidity, volume, end dates, and URLs.	$0.005