x402basequality 0.88

Polymarket structure metadata: market type detection and outcome probabilities for $0.005 USDC per call.

Price
0.005 USDC / call
Protocol
x402
Verified
no

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

prediction-market-datamarket-type-detectionoutcome-probabilitiespolymarket-integrationx402-micropaymentusdc-on-basepay-per-callno-api-key

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 Base

Example

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

Transporthttp
Protocolx402
Pay to0x6ee49a7872844397Fb52870Cc07b308fFADC9427
CurrencyUSD COIN

Quality

0.88/ 1.00

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

Provenance

Indexed fromx402_bazaar
Enriched2026-04-22 01:35:17Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-21
Last seen2026-04-23

Agent access