Smart money detection for Polymarket: suspicious wallets, insider signals, holder positions, and trade recommendations via x402.
What it does
The PolyNews `/api/v1/smart-money` endpoint analyzes smart money activity on a specific Polymarket prediction market. Given a market ID (and optionally a condition ID for multi-outcome markets), it returns suspicious wallet analysis, notable holder positions, insider confidence scoring, sentiment signals, and trade recommendations. The endpoint is part of the PolyNews Intelligence API, which provides real-time Polymarket and Kalshi prediction market data to autonomous trading agents.
This endpoint costs $0.05 per call, paid in USDC on Base via the x402 micropayment protocol — no API key or subscription required. The caller POSTs a JSON body with a `marketId` field, receives an HTTP 402 challenge on first attempt, and the x402 client library handles payment automatically. The response includes arrays of suspicious wallets, holder positions, and signals, plus an insider confidence score and a recommendation string.
PolyNews also offers related endpoints: `/api/v1/wallet` ($0.02) for individual wallet scoring (sharp score, badges, ROI, P&L), `/api/v1/smart-money-deep` ($0.10) which bundles smart money analysis with auto-profiling of the top N wallets, and `/api/v1/market-deep` ($0.09) which combines Grok AI news analysis with smart money detection. Free endpoints like `/api/v1/markets` and `/api/v1/live-prices` can be used to discover market IDs before calling this endpoint. All payments settle to `0x6ee49a7872844397Fb52870Cc07b308fFADC9427` on Base.
Capabilities
Use cases
- —Autonomous trading agents detecting informed money flows before placing Polymarket bets
- —Identifying suspicious wallet clusters accumulating positions in a specific prediction market
- —Screening markets for insider confidence signals to prioritize research
- —Building dashboards that surface smart money sentiment alongside price data
- —Combining with /market-context for a full AI + on-chain analysis workflow
Fit
Best for
- —Autonomous prediction market trading agents that need on-chain alpha signals
- —Developers building Polymarket analytics tools or dashboards
- —Agents that want pay-per-call smart money intelligence without API keys or subscriptions
Not for
- —General cryptocurrency token analysis outside prediction markets
- —Users who need free or subscription-based access rather than per-call micropayments
- —Real-time streaming websocket feeds of trades
Quick start
from x402_client import X402Client
client = X402Client(wallet_key="YOUR_PRIVATE_KEY", network="base")
resp = client.post(
"https://polynews.news/api/v1/smart-money",
json={"marketId": "69317"}
)
print(resp.json())Example
Request
{
"marketId": "69317"
}Response
{
"data": {
"signals": [
{
"type": "large-accumulation",
"description": "3 wallets accumulated $200k+ in Yes shares over 48h"
}
],
"sentiment": "bullish",
"holderPositions": [
{
"size": 125000,
"address": "0xdef456...",
"outcome": "Yes"
}
],
"recommendations": [
"Monitor Yes-side accumulation; insider confidence elevated"
],
"suspiciousWallets": [
{
"address": "0xabc123...",
"totalValue": 52000,
"recentTrades": 8
}
]
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response shapes, live 402 challenge confirmed, clear pricing ($0.05 USDC on Base), and documentation page available. Deducted slightly because the response schema uses generic `type: object`/`type: array` without fully detailed inner properties, and no actual successful response example was captured — the example response above is inferred from the schema.
Warnings
- —Response schema inner object shapes (suspiciousWallets items, signals items, etc.) are not fully specified in the OpenAPI spec — actual response structure may differ from inferred example.
- —This endpoint provides trade recommendations and insider signals for prediction markets; users should evaluate regulatory implications in their jurisdiction.
Citations
- —Smart money endpoint costs $0.05 per call in USDC on Basehttps://polynews.news/docs
- —Endpoint returns suspicious wallet analysis, holder positions, sentiment, insider signals, and trade recommendationshttps://polynews.news/docs
- —x402 challenge confirmed live with maxAmountRequired of 50000 base units (= $0.05 USDC)https://polynews.news/api/v1/smart-money
- —All payments go to 0x6ee49a7872844397Fb52870Cc07b308fFADC9427 on Basehttps://polynews.news/docs
- —USDC asset address on Base is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913https://polynews.news/api/v1/smart-money
- —Related combo endpoint /smart-money-deep costs $0.10 and bundles wallet profilinghttps://polynews.news/docs
- —No API key or subscription required; payment handled via x402 protocolhttps://polynews.news/docs