# Vextorium Polymarket Trades

> Vextorium Polymarket Trades is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-11).

Fetches recent and largest trades on a specific Polymarket prediction market, including money flow analysis broken down by outcome (Yes/No).

## Facts

- Endpoint: POST https://api.vextorium.com/v1/polymarket-trades?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-polymarket-trades-f716e595
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JVptYuPbMRf4DSKQXHoMw

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 vextorium-polymarket-trades-f716e595 -d '<json body>'
```

Example prompt: Pull the Polymarket trade data for the market 'will-trump-win-the-2024-us-presidential-election' — show me recent trades, the largest ones, and how money is flowing between Yes and No outcomes.

## When to prefer this

Use this endpoint when you need granular trade-level data for a specific Polymarket prediction market, including individual transaction details, wallet addresses, and directional money flow analysis. Prefer this over general Polymarket browsing when you want to detect whale activity, analyze net buying/selling pressure per outcome, or monitor a particular market's trading history programmatically.

## Known failure modes

- Invalid or non-existent slug returns empty or error response
- Market has no trades yet — returns empty recent/largest arrays
- Limit parameter exceeds maximum (500) resulting in capped results
- Network latency from Polymarket's public API causing delayed or failed fetch
- Malformed slug format causes lookup failure

## How this service works

Recent trades of a Polymarket market (by slug): buys and sells per outcome with price, USD size, wallet and tx, net buy/sell flow per outcome and the largest orders. Set a minimum size to follow whales.

## Output

Returns a JSON object containing: the market question text, a list of the most recent trades (up to the requested limit), a list of the largest trades by USD size, total analyzed trade count, a timestamp since when trades were analyzed, and a flow_per_result breakdown showing total trades, buys USD, sells USD, and net flow USD separately for Yes and No outcomes. Each trade includes transaction hash, USD amount, date, buy/sell side, price, outcome result, number of stakes, and wallet address.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "slug"
     ],
     "properties": {
      "slug": {
       "type": "string"
      },
      "limit": {
       "type": "integer"
      },
      "min_usd": {
       "type": "number"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "note": {
       "type": [
        "string",
        "null"
       ]
      },
      "slug": {
       "type": [
        "string",
        "null"
       ]
      },
      "since": {
       "type": [
        "string",
        "null"
       ]
      },
      "recent": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "tx": {
          "type": [
           "null",
           "string"
          ]
         },
         "usd": {
          "type": [
           "null",
           "number"
          ]
         },
         "date": {
          "type": [
           "null",
           "string"
          ]
         },
         "side": {
          "type": [
           "null",
           "string"
          ]
         },
         "price": {
          "type": [
           "null",
           "number"
          ]
         },
         "result": {
          "type": [
           "null",
           "string"
          ]
         },
         "stakes": {
          "type": [
           "null",
           "number"
          ]
         },
         "wallet": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      },
      "source": {
       "type": [
        "string",
        "null"
       ]
      },
      "largest": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Flow of the latest trades (up to 500); they are not guaranteed predictions.",
  "slug": "will-oprah-winfrey-win-the-2028-democratic-presidential-nomination",
  "since": "2026-08-31T05:13:04+00:00",
  "recent": [
   {
    "tx": "0x61126fd9cdfdf95d47802855d8884597fe057d1e691da9a71eda913f95913469",
    "usd": 0.03,
    "date": "2026-10-02T16:21:30+00:00",
    "side": "buy",
    "price": 0.001,
    "result": "Yes",
    "stakes": 25,
    "wallet": "0x55c07e4005ce11ee0c1e91c481b39091bb350b35"
   },
   {
    "tx": "0x4accf4d49d34870911b92a400eaa0da272056622ead422149bddef3a123c1d89",
    "usd": 0.03,
    "date": "2026-10-02T16:21:27+00:00",
    "side": "buy",
    "price": 0.001,
    "result": "Yes",
    "stakes": 25,
    "wallet": "0x55c07e4005ce11ee0c1e91c481b39091bb350b35"
   }
  ],
  "source": "Polymarket (public data API)",
  "largest": [
   {
    "tx": "0x2c94952c6905afb733fb388950ff1f61c2c616c6537afbd5e57c8643a7ab0838",
    "usd": 499.5,
    "date": "2026-09-04T16:48:45+00:00",
    "side": "buy",
    "price": 0.999,
    "result": "No",
    "stakes": 500,
    "wallet": "0x72f9fc3bed03fc02b33d4a242d576a9dfca7c573"
   },
   {
    "tx": "0x2e71591406b95337712df97460869d2773883660cdb010565577541bca7aabb6",
    "usd": 499.5,
    "date": "2026-09-03T14:13:00+00:00",
    "side": "buy",
    "price": 0.999,
    "result": "No",
    "stakes": 500,
    "wallet": "0x72f9fc3bed03fc02b33d4a242d576a9dfca7c573"
   }
  ],
  "question": "Will Oprah Winfrey win the 2028 Democratic presidential nomination?",
  "analyzed_trades": 500,
  "flow_per_result": {
   "No": {
    "trades": 454,
    "buys_usd": 3785,
    "sells_usd": 5661,
    "net_flow_usd": -1876
   },
   "Yes": {
    "trades": 46,
    "buys_usd": 50,
    "sells_usd": 105,
    "net_flow_usd": -55
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-polymarket-trades-f716e595/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)
