Polymarket structure metadata: market type detection and outcome probabilities for $0.005 USDC per call.
What it does
The `/api/v1/market-info` endpoint is part of the PolyNews Intelligence API, a prediction-market data platform serving autonomous trading agents via the x402 micropayment protocol. This specific endpoint accepts a POST request with a Polymarket event ID or slug and returns structured metadata about the market: whether it is binary or multi-outcome, along with all available outcomes and their current probabilities. It costs $0.005 USDC per call, settled on Base.
PolyNews exposes a broader suite of 16 endpoints spanning free market discovery (active markets, live prices), standard-tier data (trade feeds, price history, market structure), premium Grok-AI-powered analysis (news context, catalyst detection, daily briefings), and alpha-tier signals (cross-platform Polymarket×Kalshi arbitrage, smart money detection, wallet scoring). All paid endpoints use the x402 payment protocol — the server returns HTTP 402 with USDC payment requirements, and compatible client libraries handle payment and retry automatically. No API keys or subscriptions are needed.
The `market-info` endpoint is useful as a lightweight structural lookup before committing to more expensive analysis calls. For example, an agent can confirm a market is multi-outcome and enumerate candidates before calling `/market-context` ($0.05) or `/smart-money` ($0.05) on a specific outcome. The response schema includes `marketId`, `question`, `type` (binary or multi-outcome), and an array of outcome objects each with `id`, `name`, and `price` (probability 0–1).
Capabilities
Use cases
- —Look up whether a Polymarket event is binary or multi-outcome before placing trades
- —Enumerate all outcomes and their current probabilities for a given market
- —Pre-flight check before calling more expensive AI analysis or smart-money endpoints
- —Build automated dashboards that classify and display market structures
- —Agent-driven portfolio construction across prediction market outcomes
Fit
Best for
- —Autonomous trading agents that need structured market metadata before analysis
- —Developers building prediction-market tooling on Polymarket data
- —Workflows that chain market-info into deeper analysis (market-context, smart-money)
- —Low-cost structural lookups at $0.005 per call
Not for
- —Historical price data or time-series analysis (use /price-history instead)
- —AI-powered news analysis or sentiment (use /market-context instead)
- —Non-Polymarket prediction platforms without a Polymarket event ID
Quick start
curl -X POST https://polynews.news/api/v1/market-info \
-H 'Content-Type: application/json' \
-d '{"marketId": "69317"}'
# Returns 402 — use an x402 client to auto-pay $0.005 USDC on BaseExample
Request
{
"marketId": "69317"
}Response
{
"data": {
"outcomes": [
{
"name": "Gavin Newsom",
"probability": 0.27
},
{
"name": "Alexandria Ocasio-Cortez",
"probability": 0.08
},
{
"name": "Jon Ossoff",
"probability": 0.08
}
],
"marketType": "multi-outcome"
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response definitions, live 402 challenge captured confirming the endpoint is operational, clear pricing ($0.005 USDC), and comprehensive docs page. Minor deduction because no actual 200 response example was captured — the response shape is inferred from the schema and outputSchema in the x402 challenge.
Warnings
- —No actual successful (200) response was captured; response structure is inferred from OpenAPI schema and x402 outputSchema.
- —The example response JSON is illustrative based on schema — actual field names in the live response may differ slightly (e.g., 'marketType' vs 'type').
Citations
- —The /api/v1/market-info endpoint costs $0.005 USDC per callhttps://polynews.news/docs
- —The endpoint returns market type detection (binary/multi-outcome) and outcomes with probabilitieshttps://polynews.news/docs
- —Payment is settled in USDC on Base to address 0x6ee49a7872844397Fb52870Cc07b308fFADC9427https://polynews.news/docs
- —The x402 challenge confirms the endpoint is live with maxAmountRequired of 5000 base units (=$0.005 USDC)https://polynews.news/api/v1/market-info
- —The endpoint accepts POST with a JSON body containing marketIdhttps://polynews.news/docs
- —PolyNews API requires no API keys or subscriptions — agents pay per call via x402https://polynews.news/docs