# Avasis Polymarket Markets Search > Avasis Polymarket Markets Search is a paid API for AI agents from agents.avasis.ai, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31). Search and rank live Polymarket prediction markets by text query or volume/liquidity/time metrics, returning full pricing and probability data per market ## Facts - Endpoint: GET https://agents.avasis.ai/v1/pm/markets?utm_source=zero.xyz - Price: $0.002/call - Payment: x402 - Status: unknown - Last checked: 2026-10-31 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/avasis-polymarket-markets-search-f9165c30 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VhuFk9JpE1LWFFfELYbJz Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability avasis-polymarket-markets-search-f9165c30 ``` Example prompt: Search Polymarket for prediction markets about the Fed rate decision, sorted by 24h volume, show me the top 5 with at least $5000 liquidity, and include the current implied probabilities and best bid/ask spreads. ## When to prefer this Use this endpoint when you need live Polymarket market data in a single read-only call without managing Polymarket API keys or authentication. It is ideal for agents that want to discover, rank, or filter prediction markets by topic or trading activity, retrieve CLOB token IDs for downstream trading, or monitor which markets are ending soon. Prefer it over direct Polymarket API access when you want a simple x402-metered interface with no key management, or when you need implied probabilities and spread data pre-computed in one response. ## Known failure modes - 502 Bad Gateway — Polymarket upstream API is unavailable or returned an error - 504 Gateway Timeout — Polymarket upstream did not respond in time - 400 Bad Request — query parameter out of range (e.g. q shorter than 2 chars, limit outside 1-50) - Empty markets array — valid response but no markets match the filters (e.g. min_liquidity too high) - Stale data — response may be up to 20 seconds cached, so live prices may lag slightly ## How this service works Find live Polymarket prediction markets in one call: search by text or rank by 24h volume, liquidity, ending soon or newest, with filters for min liquidity and resolving within N hours. Each market: question, event, URL, outcomes with implied probabilities and CLOB token ids, best bid/ask, spread, last trade, 1h/24h price change, 24h/1wk/total volume, liquidity, end date. Read-only, 20 s cache. Upstream error -> 502/504, never charged. USDC on Base, no API key. ## Output Returns a JSON object with a count of matched markets, the echo of query parameters used, a timestamp, and an array of market objects. Each market includes: question text, event title and slug, Polymarket URL, outcome names with implied prices and CLOB token IDs, best bid, best ask, spread, last trade price, 1h and 24h price change, 24h/1-week/total volume in USD, liquidity in USD, start and end dates, accepting-orders status, and neg-risk flag. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET" ], "type": "string" }, "queryParams": { "type": "object", "properties": { "q": { "type": "string", "description": "Optional search text (2-100 chars), e.g. bitcoin, election, fed rate" }, "limit": { "type": "string", "description": "Markets returned, 1-50 (default 10)" }, "order": { "type": "string", "description": "Sort: volume_24h | liquidity | ending_soon | newest (default volume_24h)" }, "min_liquidity": { "type": "string", "description": "Only markets with at least this much liquidity (USD)" }, "ending_within_hours": { "type": "string", "description": "Only markets resolving within N hours" } }, "additionalProperties": false } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "required": [ "count", "markets" ], "properties": { "count": { "type": "integer" }, "query": { "type": "object" }, "markets": { "type": "array" }, "matched": { "type": "integer" }, "fetched_at": { "type": "string" } } } } } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "count": 1, "query": { "q": "bitcoin", "limit": 1, "order": "volume_24h", "min_liquidity": null, "ending_within_hours": null }, "cached": false, "source": "polymarket gamma api (public)", "markets": [ { "id": "562803", "url": "https://polymarket.com/event/what-price-will-bitcoin-hit-in-2026", "slug": "will-bitcoin-hit-150k-in-2026", "event": { "id": "1112205", "slug": "what-price-will-bitcoin-hit-in-2026", "title": "What price will Bitcoin hit in 2026?" }, "spread": 0.01, "best_ask": 0.07, "best_bid": 0.06, "end_date": "2026-12-31T23:59:00Z", "neg_risk": true, "outcomes": [ { "name": "Yes", "price": 0.065, "token_id": "6513…" }, { "name": "No", "price": 0.935, "token_id": "1737…" } ], "question": "Will Bitcoin hit $150k in 2026?", "change_1h": 0, "change_24h": -0.01, "group_item": "$150k", "last_trade": 0.065, "start_date": "2025-07-11T19:50:45Z", "condition_id": "0x4e4f…", "liquidity_usd": 533497.4, "volume_1wk_usd": 553773.6, "volume_24h_usd": 271053.8, "accepting_orders": true, "volume_total_usd": 14088469.1 } ], "matched": 37, "fetched_at": "2026-10-30T12:00:00.000Z" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/avasis-polymarket-markets-search-f9165c30/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from agents.avasis.ai](https://www.zero.xyz/host/agents.avasis.ai/llms.txt)