openapi: 3.1.0
info:
  title: PlatPhorm Polymarkets API
  version: 1.0.0
  description: Public-safe Polymarket prediction-market feeds, market APIs, quality/signal endpoints, discovery files, and MCP intelligence.
servers:
  - url: https://polymarkets.platphormnews.com
components:
  securitySchemes:
    PlatPhormBearer:
      type: http
      scheme: bearer
      description: Use Authorization: Bearer $PLATPHORM_API_KEY for protected platform actions.
    PlatPhormApiKey:
      type: apiKey
      in: header
      name: X-PlatPhorm-API-Key
      description: Use X-PlatPhorm-API-Key: $PLATPHORM_API_KEY for protected platform actions.
paths:
  /.well-known/agents.json:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /.well-known/ai-plugin.json:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /.well-known/feeds.json:
    get:
      summary: Get a valid public feed generated from real market data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /.well-known/mcp.json:
    get:
      summary: Discover or call Polymarkets MCP market intelligence.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /.well-known/security.txt:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /.well-known/trust.json:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/categories:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/docs:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/feed:
    get:
      summary: Get a valid public feed generated from real market data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/feed/atom:
    get:
      summary: Get a valid public feed generated from real market data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/feed/json:
    get:
      summary: Get a valid public feed generated from real market data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/feed/rss:
    get:
      summary: Get a valid public feed generated from real market data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/feed/xml:
    get:
      summary: Get a valid public feed generated from real market data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/health:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/markets:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/mcp:
    get:
      summary: Discover or call Polymarkets MCP market intelligence.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/network:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/quality:
    get:
      summary: Get quality-ranked markets based on real liquidity, volume, and price balance.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/signals/live:
    get:
      summary: Get live informational market signals derived from real prices, volume, and liquidity.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/trending:
    get:
      summary: Get trending markets by volume, liquidity, or signal confidence.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/categories:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/health:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/markets:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/markets/{id}:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/markets/{id}/history:
    get:
      summary: Get persisted price history when configured plus bounded CLOB history when available.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/markets/{id}/orderbook:
    get:
      summary: Get real CLOB orderbook data for a market or an honest degraded state.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/markets/{id}/related:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/network/graph:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/network/route-compliance:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/network/sites:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/network/trusted-domains:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/quality:
    get:
      summary: Get quality-ranked markets based on real liquidity, volume, and price balance.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/signals/live:
    get:
      summary: Get live informational market signals derived from real prices, volume, and liquidity.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/source-status:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/sync/markets:
    post:
      summary: Protected market synchronization action.
      security:
        - PlatPhormApiKey: []
        - PlatPhormBearer: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /api/v1/trending:
    get:
      summary: Get trending markets by volume, liquidity, or signal confidence.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /atom.xml:
    get:
      summary: Get a valid public feed generated from real market data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /feed.xml:
    get:
      summary: Get a valid public feed generated from real market data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /llms-full.txt:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /llms-index.json:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /llms.txt:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /manifest.webmanifest:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /openapi.yaml:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /robots.txt:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /rss.xml:
    get:
      summary: Get a valid public feed generated from real market data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /sitemap-index.xml:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
  /sitemap.xml:
    get:
      summary: Get public-safe Polymarkets platform data.
      security: []
      responses:
        "200":
          description: Public-safe Polymarkets response
        "401":
          description: PLATPHORM_API_KEY required for protected actions
