Polymarket search

Search active Polymarket markets by keyword. Returns the top matches sorted by 24h volume, with question, current outcome prices (implied probabilities), volume, liquidity, end date, and CLOB token ids for orderbook lookups.

Input

Field	Type	Description
query *	string	Keyword to search market questions, slugs, and descriptions.
limit	number	Max markets to return (1-50, default 10).
activeOnly	boolean	Filter to active+open markets only (default true).

Example output

{
  "query": "election",
  "count": 1,
  "markets": [
    {
      "id": "12345",
      "slug": "will-x-win-election",
      "question": "Will X win the election?",
      "endDate": "2026-11-03T23:59:00Z",
      "active": true,
      "closed": false,
      "volume": 1234567.89,
      "outcomes": [
        "Yes",
        "No"
      ],
      "prices": [
        0.62,
        0.38
      ],
      "clobTokenIds": [
        "7290..."
      ],
      "venue": "polymarket",
      "venueUrl": "https://polymarket.com/market/will-x-win-election"
    }
  ],
  "source": "polymarket-gamma"
}

Try it — see the 402 challenge (free)

curl -i -X POST https://agent402.tools/api/polymarket-search \
  -H "Content-Type: application/json" \
  -d '{"query":"election","limit":5}'

The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/polymarket-search", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "query": "election",
    "limit": 5
  }),
});

Wallet-only. This tool reaches the network/browser/storage, so it is paid in USDC via x402 (no proof-of-work tier).

Related tools