# Polymarket Recent Trades by Keyword

> Polymarket Recent Trades by Keyword is a paid API for AI agents from predict.gocreativeai.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the latest trade fills (side, price, size, timestamp) from Polymarket for the top market matching a given keyword search.

## Facts

- Endpoint: GET https://predict.gocreativeai.com/v1/predict/trades/:var1
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-recent-trades-by-keyword-41e4c3a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lZFVMexaG17F6h9p2sQbD

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 polymarket-recent-trades-by-keyword-41e4c3a4
```

Example prompt: Can you pull the latest Polymarket trade fills for the 'Federal Reserve rate cut 2025' market — I want to see recent buy/sell sides, prices, and sizes to get a sense of current trading sentiment?

## When to prefer this

Use this endpoint when you need raw recent trade fill data (side, price, size, time) for a specific Polymarket market identified by keyword, particularly for trading signal generation, sentiment analysis, or monitoring on-chain prediction market activity. Prefer this over the order-book endpoint when you want executed trades rather than resting bids/asks, and over the bundle endpoint when you only need trade fills and want to minimize cost.

## Known failure modes

- No matching Polymarket market found for the given keyword — returns empty or error response
- Keyword too ambiguous — returns fills for an unintended top market
- Polymarket CLOB data temporarily unavailable — upstream timeout or 503
- Payment not processed (x402 payment required) — returns 402 if USDC payment not attached
- Rate limiting or network issues on Base/Solana payment layer

## How this service works

Returns latest Polymarket fills (side, price, size, time) for the top market matching a keyword. Trading-signal & research agents extract fresh on-chain activity + sentiment. Keyless, pay-per-call USDC on Base/Solana, no API key, no signup.

## Output

A list of recent trade fills for the top Polymarket market matching the keyword, each entry including the trade side (buy or sell), price (implied probability), size (USDC notional or shares), and timestamp of execution.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "input"
     ],
     "properties": {
      "input": {
       "type": "string",
       "description": "endpoint argument"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-recent-trades-by-keyword-41e4c3a4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from predict.gocreativeai.com](https://www.zero.xyz/host/predict.gocreativeai.com/llms.txt)