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

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
  }),
});

Related tools