MARKETS & FINANCE
Polymarket Prediction Market & Wallet Monitor
Track live Polymarket prediction markets and the recent trades of wallets you choose.
About this data
Track live Polymarket prediction markets and the recent trades of wallets you choose. Each run returns a market board with outcome prices, end dates and tags, plus one record per wallet fill with side, shares, price, USDC value and timestamp.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
POST /v1/markets/polymarket/snapshot
The newest active Polymarket CLOB markets accepting orders, up to ten, from one current-region page: question, condition ID, outcome tokens with current prices and trading token IDs, end date, tags, order minimum and tick size.
Token prices are indicative dollars per $1-payout share, not executable quotes; CLOB rows publish no volume or book depth.
Null fields are omitted.
An optional tag applies to this bounded page.
No wallet histories, trades, alerts, Telegram or stored state.
Input
Send a JSON body to POST https://api.ssh.autos/v1/markets/polymarket/snapshot.
| Field | Type | Required | Notes |
|---|---|---|---|
tag | string | optional | up to 80 characters |
maxResults | integer | optional | 1–10; default 5 |
Returned fields
The answer is JSON: records, a list of up to 10, and summary, the run status and counts. Each record has these 28 fields; a field the source does not publish comes back null.
28 fields per record
| Field | Type | Notes |
|---|---|---|
recordKey | string | — |
source | string | always polymarket |
kind | string | one of market, wallet_trade |
collectedAt | string | — |
sourceUrl | string | — |
conditionId | string | The market identifier shared by a market row and its wallet trades. |
question | string | Market rows only: the market's question text. |
marketSlug | string | — |
eventSlug | string | Wallet-trade rows only: the parent event slug. |
active | boolean | Market rows only; null on wallet trades. |
closed | boolean | — |
archived | boolean | — |
acceptingOrders | boolean | — |
enableOrderBook | boolean | — |
negRisk | boolean | — |
endDate | string | Market rows only: ISO end date when published. |
tags | array of strings | Market rows only: the market's tags. |
minimumOrderSize | number | — |
minimumTickSize | number | — |
tokens | array of objects | Market rows only: outcome tokens with live price (outcomePrices). |
wallet | string | Wallet-trade rows only: the wallet watched. |
side | string | Wallet-trade rows only: BUY or SELL. |
size | number | Wallet-trade rows only: shares filled. |
price | number | Wallet-trade rows only: fill price in USDC (market rows keep token prices in tokens[]). |
usdcSize | number | Wallet-trade rows only: size × price in USDC. |
outcome | string | Wallet-trade rows only: outcome token traded. |
transactionHash | string | — |
tradedAt | string | Wallet-trade rows only: fill timestamp (ISO). |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/markets/polymarket/snapshot -m POST -b '{"maxResults": 3}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: Polymarket Prediction Market & Wallet Monitor. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt