docs(hosted): drop (Hosted) suffix, hide self-host API ref group (2.49.5)

Sidebar groups, op summaries, and tags in openapi-hosted-trading.json
all drop the (Hosted) disambiguator. The parallel Self-host API
reference group is removed from docs.json — the hosted endpoints are
the canonical Group A surface; self-hosters consume openapi.json
directly or via /guides/self-hosted.

Author: realfishsam

changelog.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.49.5] - 2026-06-09
+
+Sidebar cleanup: drop "(Hosted)" suffixes everywhere and hide the parallel self-hosted Group A reference. The hosted endpoints are now the only Group A surface in the sidebar; the API reference reads as "Trading → Create Order" instead of "Trading (Hosted) → Create Order (Hosted)."
+
+### Changed
+
+- **Sidebar group labels (`docs.json`)**: `"Trading (Hosted)"` → `"Trading"`, `"Orders & Positions (Hosted)"` → `"Orders & Positions"` inside the API Reference tab. The "(Hosted)" disambiguation made sense when a sibling self-hosted group existed in the same sidebar; with that group removed (see below), the suffix is just noise.
+- **Operation summaries (`openapi-hosted-trading.json`)**: All 9 hosted op `summary` fields drop the `(Hosted)` suffix — `"Create Order (Hosted)"` → `"Create Order"`, etc. `"Cancel Order -- Build (Hosted)"` collapses to `"Cancel Order"` (the build / sign / submit two-step is already explained in the operation description; the user-facing name shouldn't telegraph internal mechanics).
+- **Operation tags (`openapi-hosted-trading.json`)**: `"Trading (Hosted)"` → `"Trading"`, `"Orders & Positions (Hosted)"` → `"Orders & Positions"` on every op. Mintlify derives URL slugs from the tag, so the rendered hosted endpoint URLs go from `/api-reference/trading-hosted/create-order` to `/api-reference/trading/create-order` (and equivalent for Orders & Positions). No external links pointed at the previous slugs.
+
+### Removed
+
+- **`"Self-host API reference"` sidebar group (`docs.json`)**: The 11-page nested group rendering the self-hosted Group A endpoints from `openapi.json` (each operation flagged with a `"Local Only"` badge) is dropped from the Documentation tab sidebar. It duplicated the hosted endpoints' purpose for most readers and made the sidebar feel cluttered (a "Trading" group with "Local Only"–badged entries sitting alongside the prominent hosted "Trading" group on the API Reference tab). The underlying `openapi.json` file is unchanged — self-hosters who want the full reference can still consume the spec directly or reach the per-method pages via the existing `/guides/self-hosted` narrative. Net effect on the rendered sidebar: one canonical "Trading" group in the API Reference tab, no parallel "Local Only" entries elsewhere.
+
 ## [2.49.4] - 2026-06-09
 
 Hosted-trading docs QA pass. This patch also ships the 2.49.2 doc restructure work that had accumulated dirty in the working tree but never landed (Pattern E sidebar split, custody page, prediction-markets-101 glossary, terminology cleanup, etc. — see the 2.49.2 entry below for the full list).

docs/api-reference/openapi-hosted-trading.json

@@ -37,10 +37,10 @@
   "paths": {
     "/v0/trade/build-order": {
       "post": {
-        "summary": "Build Order (Hosted)",
+        "summary": "Build Order",
         "description": "Build an order *without* placing it. Returns the order's typed-data payload (for the wallet to sign) plus a `built_order_id` to pass to `submitOrderHosted` once it's signed.\n\nUse this when you want a human to approve each trade before it submits — for example, surfacing the order details in a wallet popup. For everything else, use `createOrderHosted`, which builds + signs + submits in one call.",
         "tags": [
-          "Trading (Hosted)"
+          "Trading"
         ],
         "operationId": "buildOrderHosted",
         "requestBody": {
@@ -144,10 +144,10 @@
     },
     "/v0/trade/submit-order": {
       "post": {
-        "summary": "Submit Order (Hosted)",
+        "summary": "Submit Order",
         "description": "Submit a signed order returned by `buildOrderHosted` and get back the resulting order — id, fill status, average price, and the on-chain tx hash once it settles.\n\n`built_order_id` must come from a recent `buildOrderHosted` call and be submitted before its expiry. For one-shot order placement, use `createOrderHosted` instead.",
         "tags": [
-          "Trading (Hosted)"
+          "Trading"
         ],
         "operationId": "submitOrderHosted",
         "requestBody": {
@@ -231,10 +231,10 @@
     },
     "/v0/trade/create-order": {
       "post": {
-        "summary": "Create Order (Hosted)",
+        "summary": "Create Order",
         "description": "Place a buy or sell order on Polymarket or Opinion. Returns the resulting order with id, fill status, average price, fees, and the on-chain tx hash once it settles.\n\nMost callers pass an outcome straight from `client.fetch_markets()`:\n\n```python\nmarket = client.fetch_markets({\"query\": \"trump 2028\"})[0]\norder = client.create_order(outcome=market.yes, side=\"buy\", amount=10, order_type=\"limit\", price=0.55)\n```\n\nNeed to show the order to a user before they sign it (custom approval UX)? Use `buildOrderHosted` + `submitOrderHosted` instead — together they do the same thing.",
         "tags": [
-          "Trading (Hosted)"
+          "Trading"
         ],
         "operationId": "createOrderHosted",
         "requestBody": {
@@ -338,10 +338,10 @@
     },
     "/v0/orders/cancel/build": {
       "post": {
-        "summary": "Cancel Order -- Build (Hosted)",
+        "summary": "Cancel Order",
         "description": "Start a cancel on an existing open order. Returns the cancel payload for the wallet to sign — you then submit the signature to `POST /v0/orders/cancel`.\n\nThe SDK's `cancelOrder()` chains both steps. Call this endpoint directly only if you need to show the cancel to a user before signing.",
         "tags": [
-          "Trading (Hosted)"
+          "Trading"
         ],
         "operationId": "cancelOrderHosted",
         "requestBody": {
@@ -425,10 +425,10 @@
     },
     "/v0/user/{address}/balances": {
       "get": {
-        "summary": "Fetch Balance (Hosted)",
+        "summary": "Fetch Balance",
         "description": "Check the USDC available for trading. Returns the wallet's balance inside the PMXT escrow on Polygon — *not* the wallet's on-chain USDC balance.\n\nTop up by depositing at [pmxt.dev/dashboard/wallet](https://pmxt.dev/dashboard/wallet).",
         "tags": [
-          "Orders & Positions (Hosted)"
+          "Orders & Positions"
         ],
         "operationId": "fetchBalanceHosted",
         "parameters": [
@@ -503,10 +503,10 @@
     },
     "/v0/user/{address}/positions": {
       "get": {
-        "summary": "Fetch Positions (Hosted)",
+        "summary": "Fetch Positions",
         "description": "List the open positions held by `address` across Polymarket and Opinion. Each position carries the market, outcome, share count, and average entry price.\n\nMark-to-market fields (`current_price`, `current_value`, `unrealized_pnl`) are reserved for a future release and currently return `null`.",
         "tags": [
-          "Orders & Positions (Hosted)"
+          "Orders & Positions"
         ],
         "operationId": "fetchPositionsHosted",
         "parameters": [
@@ -584,10 +584,10 @@
     },
     "/v0/orders/open": {
       "get": {
-        "summary": "Fetch Open Orders (Hosted)",
+        "summary": "Fetch Open Orders",
         "description": "List the wallet's resting orders that haven't filled or been cancelled yet. Each entry has the market, outcome, side, size, price, and time-in-force.\n\nFilter by `venue` to scope to Polymarket or Opinion only.",
         "tags": [
-          "Orders & Positions (Hosted)"
+          "Orders & Positions"
         ],
         "operationId": "fetchOpenOrdersHosted",
         "parameters": [
@@ -667,10 +667,10 @@
     },
     "/v0/user/{address}/trades": {
       "get": {
-        "summary": "Fetch My Trades (Hosted)",
+        "summary": "Fetch My Trades",
         "description": "List the wallet's historical fills on Polymarket and Opinion. Each trade carries the executed price (net of venue fees), size, and on-chain settlement tx hash.\n\nClosed orders are modelled as trades in hosted mode — use this endpoint instead of `fetchClosedOrders` / `fetchAllOrders` (which raise `NotSupported`).",
         "tags": [
-          "Orders & Positions (Hosted)"
+          "Orders & Positions"
         ],
         "operationId": "fetchMyTradesHosted",
         "parameters": [
@@ -738,10 +738,10 @@
     },
     "/v0/orders/{order_id}": {
       "get": {
-        "summary": "Fetch Order (Hosted)",
+        "summary": "Fetch Order",
         "description": "Look up a single order by id. Returns the order's current status, filled / remaining size, average fill price, and — once settled — the on-chain tx hash.\n\n`order_id` is what `createOrderHosted` (or `fetchOpenOrdersHosted`) returns.",
         "tags": [
-          "Orders & Positions (Hosted)"
+          "Orders & Positions"
         ],
         "operationId": "fetchOrderHosted",
         "parameters": [

docs/docs.json

@@ -92,23 +92,6 @@
               "guides/self-hosted",
               "sdk/server"
             ]
-          },
-          {
-            "group": "Self-host API reference",
-            "openapi": "api-reference/openapi.json",
-            "pages": [
-              "POST /api/{exchange}/createOrder",
-              "POST /api/{exchange}/buildOrder",
-              "POST /api/{exchange}/submitOrder",
-              "POST /api/{exchange}/cancelOrder",
-              "GET /api/{exchange}/fetchOrder",
-              "GET /api/{exchange}/fetchOpenOrders",
-              "GET /api/{exchange}/fetchMyTrades",
-              "GET /api/{exchange}/fetchClosedOrders",
-              "GET /api/{exchange}/fetchAllOrders",
-              "GET /api/{exchange}/fetchPositions",
-              "GET /api/{exchange}/fetchBalance"
-            ]
           }
         ]
       },
@@ -190,26 +173,24 @@
           },
           {
             "group": "Trading",
+            "openapi": "api-reference/openapi-hosted-trading.json",
             "pages": [
-              "POST /api/{exchange}/createOrder",
-              "POST /api/{exchange}/buildOrder",
-              "POST /api/{exchange}/submitOrder",
-              "POST /api/{exchange}/cancelOrder"
-            ],
-            "openapi": "api-reference/openapi.json"
+              "POST /v0/trade/create-order",
+              "POST /v0/trade/build-order",
+              "POST /v0/trade/submit-order",
+              "POST /v0/orders/cancel/build"
+            ]
           },
           {
             "group": "Orders & Positions",
+            "openapi": "api-reference/openapi-hosted-trading.json",
             "pages": [
-              "GET /api/{exchange}/fetchOrder",
-              "GET /api/{exchange}/fetchOpenOrders",
-              "GET /api/{exchange}/fetchMyTrades",
-              "GET /api/{exchange}/fetchClosedOrders",
-              "GET /api/{exchange}/fetchAllOrders",
-              "GET /api/{exchange}/fetchPositions",
-              "GET /api/{exchange}/fetchBalance"
-            ],
-            "openapi": "api-reference/openapi.json"
+              "GET /v0/orders/{order_id}",
+              "GET /v0/orders/open",
+              "GET /v0/user/{address}/trades",
+              "GET /v0/user/{address}/positions",
+              "GET /v0/user/{address}/balances"
+            ]
           },
           {
             "group": "Realtime",