fix: remove (WebSocket) suffix and misleading POST body from watch docs

Author: realfishsam

core/scripts/generate-openapi.js

@@ -1424,27 +1424,13 @@ function buildPathSpec(method, sourceFile) {
 
     const pathObj = {
       post: {
-        summary: summary + ' (WebSocket)',
+        summary,
         operationId: name,
         parameters: [{ $ref: '#/components/parameters/ExchangeParam' }],
         description: wsDescription,
-        requestBody: {
-          content: {
-            'application/json': {
-              schema: {
-                title: name.charAt(0).toUpperCase() + name.slice(1) + 'Request',
-                type: 'object',
-                properties: {
-                  args: { type: 'array', items: { type: 'string' } },
-                  credentials: { $ref: '#/components/schemas/ExchangeCredentials' },
-                },
-              },
-            },
-          },
-        },
         responses: {
           '200': {
-            description: `${summary} response (WebSocket data event)`,
+            description: `${summary} response`,
             content: {
               'application/json': { schema: responseSchema },
             },

core/src/server/method-verbs.json

@@ -295,7 +295,7 @@
     ]
   },
   "watchOrderBook": {
-    "verb": "ws",
+    "verb": "post",
     "args": [
       {
         "name": "outcomeId",
@@ -310,7 +310,7 @@
     ]
   },
   "watchOrderBooks": {
-    "verb": "ws",
+    "verb": "post",
     "args": [
       {
         "name": "outcomeIds",
@@ -325,7 +325,7 @@
     ]
   },
   "unwatchOrderBook": {
-    "verb": "ws",
+    "verb": "post",
     "args": [
       {
         "name": "outcomeId",
@@ -335,7 +335,7 @@
     ]
   },
   "watchTrades": {
-    "verb": "ws",
+    "verb": "post",
     "args": [
       {
         "name": "outcomeId",
@@ -360,7 +360,7 @@
     ]
   },
   "watchAddress": {
-    "verb": "ws",
+    "verb": "post",
     "args": [
       {
         "name": "address",
@@ -375,7 +375,7 @@
     ]
   },
   "unwatchAddress": {
-    "verb": "ws",
+    "verb": "post",
     "args": [
       {
         "name": "address",