Grok AI analysis + smart money detection for Polymarket in one x402 combo call at $0.09 USDC.
What it does
The `/api/v1/market-deep` endpoint from PolyNews Intelligence API combines two premium capabilities into a single parallel call: Grok-powered news and X (Twitter) analysis plus smart money detection for any Polymarket prediction market. It accepts a market ID and question, then returns AI-generated context (breaking news, sentiment, source citations) alongside smart money signals (suspicious wallets, insider confidence, holder positions, trade recommendations). Priced at $0.09 USDC per call on Base, it is 10% cheaper than calling `/market-context` ($0.05) and `/smart-money` ($0.05) individually.
The endpoint is part of a broader PolyNews API suite that covers Polymarket and Kalshi prediction markets. The API uses the x402 micropayment protocol — no API keys or subscriptions required. Agents pay per call in USDC on Base via the x402 facilitator. Free endpoints are available for market discovery (`/markets`, `/live-prices`), while paid tiers range from $0.001 for trade feeds up to $0.10 for deep combo analyses. The full OpenAPI 3.1 spec and JSON docs are published at the provider's site.
The `market-deep` endpoint requires a POST with `marketId` and `marketQuestion` as required fields, plus optional `marketOdds`, `conditionId`, and `outcomeName` for multi-outcome markets. The response contains a `context` object (equivalent to `/market-context` output) and a `smartMoney` object (equivalent to `/smart-money` output), along with a `partialFailure` boolean indicating if one sub-call failed while the other succeeded.
Capabilities
Use cases
- —Autonomous trading agents analyzing Polymarket positions before placing bets
- —Getting combined AI sentiment and whale-wallet signals for a prediction market in a single call
- —Monitoring smart money flows and news catalysts for political or geopolitical prediction markets
- —Building dashboards that show both AI-generated context and on-chain smart money activity
- —Reducing API costs by bundling Grok analysis and smart money detection into one request
Fit
Best for
- —Trading agents that need both news context and smart money signals per market
- —Prediction market researchers wanting AI-powered analysis with source citations
- —Developers building autonomous Polymarket trading bots on x402 rails
Not for
- —Users needing only free market data (use /markets or /live-prices instead)
- —Cross-platform arbitrage detection (use /arbitrage endpoint instead)
- —Non-Polymarket prediction platforms with no market ID mapping
Quick start
curl -X POST https://polynews.news/api/v1/market-deep \
-H 'Content-Type: application/json' \
-H 'X-Payment: <x402-payment-proof>' \
-d '{"marketId": "69317", "marketQuestion": "Democratic Presidential Nominee 2028", "marketOdds": "Newsom: 27%"}'Example
Request
{
"marketId": "69317",
"marketOdds": "Newsom: 27%",
"marketQuestion": "Democratic Presidential Nominee 2028"
}Response
{
"data": {
"smartMoney": {
"signals": [
{
"type": "large-accumulation",
"outcome": "Newsom",
"confidence": 0.78
}
],
"recommendation": "Monitor Newsom accumulation by sharp wallets",
"holderPositions": [],
"insiderConfidence": 0.65,
"suspiciousWallets": [
{
"address": "0xabc...",
"totalValue": 52000
}
]
},
"marketContext": {
"sources": [
{
"url": "https://example.com/article",
"type": "news",
"title": "Newsom 2028 exploratory moves"
},
{
"url": "https://x.com/politico/status/123",
"type": "x",
"title": "@politico on Dem primary"
}
],
"analysis": "Gavin Newsom leads the Democratic 2028 field at 27%. Recent polling and fundraising signals suggest...",
"latencyMs": 2400,
"sentiment": "bullish"
},
"partialFailure": false
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response definitions, live 402 challenge captured confirming the endpoint is operational, comprehensive docs page with pricing tiers and quick-start code, and clear x402 payment parameters. Only minor gap is that the response schema references generic 'object' types for smartMoney and context sub-fields rather than fully expanded properties.
Warnings
- —Response sub-objects (context, smartMoney) are described as generic 'object' types in the OpenAPI spec without fully expanded property definitions
- —Example response is inferred from combining /market-context and /smart-money schemas; no actual 200 response was captured
Citations
- —market-deep endpoint costs $0.09 USDC per call (10% cheaper than individual calls)https://polynews.news/docs
- —Endpoint combines Grok-powered news/X analysis with smart money detection in one parallel callhttps://polynews.news/docs
- —x402 challenge confirms maxAmountRequired of 90000 base units (= $0.09 USDC) on Base networkhttps://polynews.news/api/v1/market-deep
- —All payments go to 0x6ee49a7872844397Fb52870Cc07b308fFADC9427 on Basehttps://polynews.news/docs
- —USDC asset address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Basehttps://polynews.news/api/v1/market-deep
- —Required fields are marketId and marketQuestion; optional fields include marketOdds, conditionId, outcomeNamehttps://polynews.news/openapi.json
- —API uses x402 micropayment protocol with no API keys or subscriptionshttps://polynews.news/docs