OneQAZ Trading Intelligence

Trade History

get_trade_history

Read-onlyIdempotent

Purpose: Query paper-trading history with dynamic filters (action / P&L / time / symbol). Triggers (casual questions too): "what trades happened lately?", "최근 거래 내역 보여줘", "how did the BTC trades go?", "승률 어때?", "show me the trade log", "how many trades won this week?". When to call: past trade review, single-symbol post-mortem, win-rate audits. Prerequisites: none. Next steps: analyze_trades, market://{market_id}/signals/feedback. Caveats: paper-trading data only (not real money). limit capped at 1000.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`limit`	No	Max rows returned (default 50, max 1000). Rows are paginated; see total_available / truncated. NOTE: stats (win_rate, avg_pnl) are aggregated over the scanned set, not over the returned rows — see stats_scope.
`symbol`	No	Filter by ticker symbol (e.g., "BTC", "AAPL"); case-insensitive
`max_pnl`	No	Max P&L % filter (e.g., 10.0)
`min_pnl`	No	Min P&L % filter (e.g., -5.0)
`market_id`	Yes	Market ID (crypto, kr_stock, us_stock; aliases coin/kr/us accepted)
`hours_back`	No	Only trades within last N hours
`action_filter`	No	Filter by action (all, buy, sell)	all

Output Schema

TableJSON Schema

Name	Required	Description
`full_data`	No
`timestamp`	Yes	RFC3339 UTC, server build time
`disclaimer`	Yes	Canonical compliance disclaimer (always present)
`request_id`	Yes	32-hex per-response correlation id
`is_real_money`	No
`data_classification`	No
`is_investment_advice`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 7, 2026
- addedInput schema / additionalProperties
```
Added value: +false
```

Changed17 schema fields changedSep 23, 2026

removedOutput schema / properties / _followup_questions_for_user

Removed value: -{
-  "anyOf": [
-    {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

removedOutput schema / properties / _llm_summary

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

removedOutput schema / properties / _market_state_narrative

Removed value: -{
-  "anyOf": [
-    {
-      "additionalProperties": true,
-      "description": "Wrapper for `_market_state_narrative` — bilingual + provenance.",
-      "properties": {
-        "_source": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null
-        },
-        "en": {
-          "anyOf": [
-            {
-              "additionalProperties": true,
-              "description": "Bilingual narrative — one of {ko, en} must carry a headline.",
-              "properties": {
-                "evidence": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "headline": {
-                  "type": "string"
-                },
-                "what_to_watch": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "default": null
-                }
-              },
-              "required": [
-                "headline"
-              ],
-              "type": "object"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null
-        },
-        "ko": {
-          "anyOf": [
-            {
-              "additionalProperties": true,
-              "description": "Bilingual narrative — one of {ko, en} must carry a headline.",
-              "properties": {
-                "evidence": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "headline": {
-                  "type": "string"
-                },
-                "what_to_watch": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ],
-                  "default": null
-                }
-              },
-              "required": [
-                "headline"
-              ],
-              "type": "object"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null
-        }
-      },
-      "type": "object"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

removedOutput schema / properties / _next_actions

Removed value: -{
-  "anyOf": [
-    {
-      "items": {
-        "additionalProperties": true,
-        "description": "One AI-actionable follow-up call recommendation.",
-        "properties": {
-          "args": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "intent": {
-            "description": "Short intent label, max ~120 chars",
-            "type": "string"
-          },
-          "priority": {
-            "default": "normal",
-            "enum": [
-              "high",
-              "normal",
-              "low"
-            ],
-            "type": "string"
-          },
-          "rationale": {
-            "default": "",
-            "description": "Why this is recommended",
-            "type": "string"
-          },
-          "tool": {
-            "description": "Recommended tool name to invoke next",
-            "type": "string"
-          }
-        },
-        "required": [
-          "intent",
-          "tool"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

removedOutput schema / properties / _value_signals

Removed value: -{
-  "anyOf": [
-    {
-      "additionalProperties": true,
-      "description": "Static product/value metadata — same for every response of a tool type.",
-      "properties": {
-        "data_freshness_seconds": {
-          "default": 120,
-          "type": "integer"
-        },
-        "key_signup_url": {
-          "default": "https://api.oneqaz.com/keys",
-          "type": "string"
-        },
-        "pricing_url": {
-          "default": "https://api.oneqaz.com/pricing",
-          "type": "string"
-        },
-        "schema_version": {
-          "default": "1.1",
-          "type": "string"
-        },
-        "self_correcting": {
-          "default": true,
-          "type": "boolean"
-        },
-        "tier_default": {
-          "default": "free",
-          "enum": [
-            "free",
-            "pro",
-            "internal"
-          ],
-          "type": "string"
-        },
-        "tier_default_limits": {
-          "additionalProperties": {
-            "type": "integer"
-          },
-          "type": "object"
-        },
-        "what_pro_unlocks": {
-          "default": "33x daily quota (50K), 3.3x burst (200/min) — same tools, higher volume",
-          "type": "string"
-        }
-      },
-      "type": "object"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

removedOutput schema / properties / action

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Recommended client action (error path)"
-}

removedOutput schema / properties / action_value

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

removedOutput schema / properties / ai_summary

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "One-line AI-oriented summary (success path)"
-}

removedOutput schema / properties / ai_summary_generated_at

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "RFC3339 UTC"
-}

removedOutput schema / properties / ai_summary_ttl_seconds

Removed value: -{
-  "anyOf": [
-    {
-      "minimum": 0,
-      "type": "integer"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

removedOutput schema / properties / error

Removed value: -{
-  "anyOf": [
-    {
-      "type": "boolean"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Set true on error responses"
-}

removedOutput schema / properties / error_code

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Stable error identifier; see mcp_error_policy.md"
-}

removedOutput schema / properties / fallback_note

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

removedOutput schema / properties / fallback_tool

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Suggested fallback (error path)"
-}

removedOutput schema / properties / reason

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Human-readable cause (error path)"
-}

removedOutput schema / properties / retryable

Removed value: -{
-  "anyOf": [
-    {
-      "type": "boolean"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Whether the client should retry (error path)"
-}

removedOutput schema / properties / summary_for_user

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "One-line jargon-free Korean summary (success path)"
-}

Changed2 schema fields changedSep 22, 2026

changedInput schema / properties / limit / default
```
Previous value: -1000New value: +50
```

changedInput schema / properties / limit / description

Previous value: -"Max results (default 1000)"New value: +"Max rows returned (default 50, max 1000). Rows are paginated; see total_available / truncated. NOTE: stats (win_rate, avg_pnl) are aggregated over the scanned set, not over the returned rows — see stats_scope."

Changed9 schema fields changedSep 22, 2026

addedInput schema / properties / action_filter / description
```
Added value: +"Filter by action (all, buy, sell)"
```
addedInput schema / properties / action_filter / enum
```
Added value: +[
+  "buy",
+  "sell",
+  "hold"
+]
```
addedInput schema / properties / hours_back / description
```
Added value: +"Only trades within last N hours"
```
addedInput schema / properties / limit / description
```
Added value: +"Max results (default 1000)"
```

addedInput schema / properties / market_id / description

Added value: +"Market ID (crypto, kr_stock, us_stock; aliases coin/kr/us accepted)"

addedInput schema / properties / market_id / enum

Added value: +[
+  "crypto",
+  "kr_stock",
+  "us_stock"
+]

addedInput schema / properties / max_pnl / description
```
Added value: +"Max P&L % filter (e.g., 10.0)"
```
addedInput schema / properties / min_pnl / description
```
Added value: +"Min P&L % filter (e.g., -5.0)"
```

addedInput schema / properties / symbol / description

Added value: +"Filter by ticker symbol (e.g., \"BTC\", \"AAPL\"); case-insensitive"

Changed1 schema field changedJul 20, 2026

changedOutput schema / properties / _value_signals / anyOf

Previous value: -[
-  {
-    "additionalProperties": true,
-    "description": "Static product/value metadata — same for every response of a tool type.",
-    "properties": {
-      "data_freshness_seconds": {
-        "default": 120,
-        "type": "integer"
-      },
-      "key_signup_url": {
-        "default": "https://api.oneqaz.com/keys",
-        "type": "string"
-      },
-      "pricing_url": {
-        "default": "https://api.oneqaz.com/pricing",
-        "type": "string"
-      },
-      "schema_version": {
-        "default": "1.0",
-        "type": "string"
-      },
-      "self_correcting": {
-        "default": true,
-        "type": "boolean"
-      },
-      "tier_default": {
-        "default": "free",
-        "enum": [
-          "free",
-          "pro",
-          "internal"
-        ],
-        "type": "string"
-      },
-      "tier_default_limits": {
-        "additionalProperties": {
-          "type": "integer"
-        },
-        "type": "object"
-      },
-      "what_pro_unlocks": {
-        "default": "33x daily quota (50K), 3.3x burst (200/min) — same tools, higher volume",
-        "type": "string"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "description": "Static product/value metadata — same for every response of a tool type.",
+    "properties": {
+      "data_freshness_seconds": {
+        "default": 120,
+        "type": "integer"
+      },
+      "key_signup_url": {
+        "default": "https://api.oneqaz.com/keys",
+        "type": "string"
+      },
+      "pricing_url": {
+        "default": "https://api.oneqaz.com/pricing",
+        "type": "string"
+      },
+      "schema_version": {
+        "default": "1.1",
+        "type": "string"
+      },
+      "self_correcting": {
+        "default": true,
+        "type": "boolean"
+      },
+      "tier_default": {
+        "default": "free",
+        "enum": [
+          "free",
+          "pro",
+          "internal"
+        ],
+        "type": "string"
+      },
+      "tier_default_limits": {
+        "additionalProperties": {
+          "type": "integer"
+        },
+        "type": "object"
+      },
+      "what_pro_unlocks": {
+        "default": "33x daily quota (50K), 3.3x burst (200/min) — same tools, higher volume",
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedJul 7, 2026

changedOutput schema / properties / _value_signals / anyOf

Previous value: -[
-  {
-    "additionalProperties": true,
-    "description": "Static product/value metadata — same for every response of a tool type.",
-    "properties": {
-      "data_freshness_seconds": {
-        "default": 120,
-        "type": "integer"
-      },
-      "key_signup_url": {
-        "default": "https://oneqaz.com/keys",
-        "type": "string"
-      },
-      "pricing_url": {
-        "default": "https://oneqaz.com/pricing",
-        "type": "string"
-      },
-      "schema_version": {
-        "default": "1.0",
-        "type": "string"
-      },
-      "self_correcting": {
-        "default": true,
-        "type": "boolean"
-      },
-      "tier_default": {
-        "default": "free",
-        "enum": [
-          "free",
-          "pro",
-          "internal"
-        ],
-        "type": "string"
-      },
-      "tier_default_limits": {
-        "additionalProperties": {
-          "type": "integer"
-        },
-        "type": "object"
-      },
-      "what_pro_unlocks": {
-        "default": "33x daily quota (50K), 3.3x burst (200/min) — same tools, higher volume",
-        "type": "string"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "description": "Static product/value metadata — same for every response of a tool type.",
+    "properties": {
+      "data_freshness_seconds": {
+        "default": 120,
+        "type": "integer"
+      },
+      "key_signup_url": {
+        "default": "https://api.oneqaz.com/keys",
+        "type": "string"
+      },
+      "pricing_url": {
+        "default": "https://api.oneqaz.com/pricing",
+        "type": "string"
+      },
+      "schema_version": {
+        "default": "1.0",
+        "type": "string"
+      },
+      "self_correcting": {
+        "default": true,
+        "type": "boolean"
+      },
+      "tier_default": {
+        "default": "free",
+        "enum": [
+          "free",
+          "pro",
+          "internal"
+        ],
+        "type": "string"
+      },
+      "tier_default_limits": {
+        "additionalProperties": {
+          "type": "integer"
+        },
+        "type": "object"
+      },
+      "what_pro_unlocks": {
+        "default": "33x daily quota (50K), 3.3x burst (200/min) — same tools, higher volume",
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed2 schema fields changedJun 8, 2026

addedOutput schema / properties

Added value: +{
+  "_followup_questions_for_user": {
+    "anyOf": [
+      {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null
+  },
+  "_llm_summary": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null
+  },
+  "_market_state_narrative": {
+    "anyOf": [
+      {
+        "additionalProperties": true,
+        "description": "Wrapper for `_market_state_narrative` — bilingual + provenance.",
+        "properties": {
+          "_source": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null
+          },
+          "en": {
+            "anyOf": [
+              {
+                "additionalProperties": true,
+                "description": "Bilingual narrative — one of {ko, en} must carry a headline.",
+                "properties": {
+                  "evidence": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "headline": {
+                    "type": "string"
+                  },
+                  "what_to_watch": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "default": null
+                  }
+                },
+                "required": [
+                  "headline"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null
+          },
+          "ko": {
+            "anyOf": [
+              {
+                "additionalProperties": true,
+                "description": "Bilingual narrative — one of {ko, en} must carry a headline.",
+                "properties": {
+                  "evidence": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "headline": {
+                    "type": "string"
+                  },
+                  "what_to_watch": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "default": null
+                  }
+                },
+                "required": [
+                  "headline"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null
+          }
+        },
+        "type": "object"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null
+  },
+  "_next_actions": {
+    "anyOf": [
+      {
+        "items": {
+          "additionalProperties": true,
+          "description": "One AI-actionable follow-up call recommendation.",
+          "properties": {
+            "args": {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            "intent": {
+              "description": "Short intent label, max ~120 chars",
+              "type": "string"
+            },
+            "priority": {
+              "default": "normal",
+              "enum": [
+                "high",
+                "normal",
+                "low"
+              ],
+              "type": "string"
+            },
+            "rationale": {
+              "default": "",
+              "description": "Why this is recommended",
+              "type": "string"
+            },
+            "tool": {
+              "description": "Recommended tool name to invoke next",
+              "type": "string"
+            }
+          },
+          "required": [
+            "intent",
+            "tool"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null
+  },
+  "_value_signals": {
+    "anyOf": [
+      {
+        "additionalProperties": true,
+        "description": "Static product/value metadata — same for every response of a tool type.",
+        "properties": {
+          "data_freshness_seconds": {
+            "default": 120,
+            "type": "integer"
+          },
+          "key_signup_url": {
+            "default": "https://oneqaz.com/keys",
+            "type": "string"
+          },
+          "pricing_url": {
+            "default": "https://oneqaz.com/pricing",
+            "type": "string"
+          },
+          "schema_version": {
+            "default": "1.0",
+            "type": "string"
+          },
+          "self_correcting": {
+            "default": true,
+            "type": "boolean"
+          },
+          "tier_default": {
+            "default": "free",
+            "enum": [
+              "free",
+              "pro",
+              "internal"
+            ],
+            "type": "string"
+          },
+          "tier_default_limits": {
+            "additionalProperties": {
+              "type": "integer"
+            },
+            "type": "object"
+          },
+          "what_pro_unlocks": {
+            "default": "33x daily quota (50K), 3.3x burst (200/min) — same tools, higher volume",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null
+  },
+  "action": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Recommended client action (error path)"
+  },
+  "action_value": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null
+  },
+  "ai_summary": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "One-line AI-oriented summary (success path)"
+  },
+  "ai_summary_generated_at": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "RFC3339 UTC"
+  },
+  "ai_summary_ttl_seconds": {
+    "anyOf": [
+      {
+        "minimum": 0,
+        "type": "integer"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null
+  },
+  "data_classification": {
+    "anyOf": [
+      {
+        "const": "research_information_only",
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null
+  },
+  "disclaimer": {
+    "description": "Canonical compliance disclaimer (always present)",
+    "type": "string"
+  },
+  "error": {
+    "anyOf": [
+      {
+        "type": "boolean"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Set true on error responses"
+  },
+  "error_code": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Stable error identifier; see mcp_error_policy.md"
+  },
+  "fallback_note": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null
+  },
+  "fallback_tool": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Suggested fallback (error path)"
+  },
+  "full_data": {
+    "anyOf": [
+      {
+        "additionalProperties": true,
+        "description": "`full_data` for get_trade_history.",
+        "properties": {
+          "filters": {
+            "additionalProperties": true,
+            "type": "object"
+          },
+          "market_id": {
+            "type": "string"
+          },
+          "stats": {
+            "additionalProperties": true,
+            "properties": {
+              "avg_pnl": {
+                "type": "number"
+              },
+              "losses": {
+                "type": "integer"
+              },
+              "total_pnl": {
+                "type": "number"
+              },
+              "total_trades": {
+                "type": "integer"
+              },
+              "win_rate": {
+                "type": "number"
+              },
+              "wins": {
+                "type": "integer"
+              }
+            },
+            "required": [
+              "total_trades",
+              "wins",
+              "losses",
+              "win_rate",
+              "total_pnl",
+              "avg_pnl"
+            ],
+            "type": "object"
+          },
+          "trades": {
+            "items": {
+              "additionalProperties": true,
+              "properties": {
+                "action": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                },
+                "ai_score": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                },
+                "entry_price": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                },
+                "entry_timestamp": {
+                  "anyOf": [
+                    {
+                      "type": "integer"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                },
+                "exit_price": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                },
+                "exit_timestamp": {
+                  "anyOf": [
+                    {
+                      "type": "integer"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                },
+                "holding_duration": {
+                  "anyOf": [
+                    {
+                      "type": "integer"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                },
+                "profit_loss_pct": {
+                  "anyOf": [
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                },
+                "signal_pattern": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null
+                },
+                "symbol": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "symbol"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "market_id",
+          "stats"
+        ],
+        "type": "object"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null
+  },
+  "is_investment_advice": {
+    "anyOf": [
+      {
+        "const": false,
+        "type": "boolean"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null
+  },
+  "is_real_money": {
+    "anyOf": [
+      {
+        "const": false,
+        "type": "boolean"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null
+  },
+  "reason": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Human-readable cause (error path)"
+  },
+  "request_id": {
+    "description": "32-hex per-response correlation id",
+    "type": "string"
+  },
+  "retryable": {
+    "anyOf": [
+      {
+        "type": "boolean"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "Whether the client should retry (error path)"
+  },
+  "summary_for_user": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "description": "One-line jargon-free Korean summary (success path)"
+  },
+  "timestamp": {
+    "description": "RFC3339 UTC, server build time",
+    "type": "string"
+  }
+}

addedOutput schema / required

Added value: +[
+  "disclaimer",
+  "request_id",
+  "timestamp"
+]

Changed1 schema field changedApr 20, 2026

addedInput schema / properties / symbol

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

First observedApr 19, 2026

TDQS

A4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, and openWorldHint, so the safety profile is covered. The description adds genuinely new behavioral context: the data is paper-trading only (not real money) and the limit is capped at 1000. It does not restate annotation content, but it also omits how truncation/pagination behaves, which the schema carries instead.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Uses labeled sections (Purpose / Triggers / When to call / Prerequisites / Next steps / Caveats) with the core purpose front-loaded, and each section is brief. The multi-lingual trigger examples are somewhat expansive but serve retrieval matching rather than being pure padding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only query tool with a full output schema and 100% parameter coverage, the description supplies purpose, triggers, prerequisites, next-step routing, and a caveat about data provenance and row limits. Return values are legitimately left to the output schema, so nothing an agent needs to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so every one of the 7 parameters is already documented in-schema, including the stats_scope nuance on limit. The description only loosely maps its filter list ('action / P&L / time / symbol') to those parameters and adds no format or semantic detail beyond the schema. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource ('Query paper-trading history') and enumerates the filter dimensions (action / P&L / time / symbol), plus scope ('paper-trading data only'). It does not explicitly distinguish itself from closely-named siblings like get_winning_trades or get_losing_trades, so an agent must infer that those are subsets of this broader query.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives concrete when-to-use contexts ('past trade review, single-symbol post-mortem, win-rate audits') and even casual-question triggers in two languages, plus 'Prerequisites: none' and follow-up tools under 'Next steps'. It stops short of naming an alternative tool for when NOT to use this one, so no exclusions are stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All OneQAZ Trading Intelligence tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.