Skip to main content
Glama

My open orders

get_my_open_orders
Read-onlyIdempotent

Resting orders on the user's exchange accounts, including protective stop-loss and take-profit orders (is_trigger = true), and trigger entries TradeHub holds (type TRIGGER_ENTRY, order_id req_…). Use to find an order_id to cancel or to confirm a stop is in place. Not for filled trades (use get_my_trade_history). Inputs: optional venue and symbol filters. Sizes in the base coin, prices in USD. Next: cancel_order(order_id).

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_my_open_orders"
  }
}

Input Schema

NameRequiredDescriptionDefault
venueNoOnly this venue
symbolNoOnly this base coin

Output Schema

NameRequiredDescriptionDefault
ordersYesResting orders, including protective stops
deprecationNoPresent only while this tool is deprecated: replacement, removal_date, changelog

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • addedOutput schema / $defs / OrderOut / properties / oco_group
      Added value: +{
      +  "description": "Such an entry's one-cancels-other group; once one entry of the group opens, the others are withdrawn",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / $defs / OrderOut / properties / request_id
      Added value: +{
      +  "description": "An entry TradeHub placed that has not filled (a limit order or a TRIGGER_ENTRY): its order request, the id oco_with takes",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • removedOutput schema / $defs / OrderOut / properties / size
      Removed value: -{
      -  "description": "Order size, in the base coin (e.g. BTC), not USD",
      -  "type": "number"
      -}
    • addedOutput schema / $defs / OrderOut / properties / size_base
      Added value: +{
      +  "description": "Order size, in the base coin (e.g. BTC), not USD",
      +  "type": "number"
      +}
    • changedOutput schema / $defs / OrderOut / required
      Previous value: -[
      -  "venue",
      -  "order_id",
      -  "symbol",
      -  "side",
      -  "size",
      -  "type",
      -  "is_trigger",
      -  "reduce_only"
      -]New value: +[
      +  "venue",
      +  "order_id",
      +  "symbol",
      +  "side",
      +  "size_base",
      +  "type",
      +  "is_trigger",
      +  "reduce_only"
      +]
  2. Changed46 schema fields changed
    • removedInput schema / properties / symbol / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedInput schema / properties / symbol / default
      Removed value: -null
    • removedInput schema / properties / symbol / title
      Removed value: -"Symbol"
    • addedInput schema / properties / symbol / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedInput schema / properties / venue / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedInput schema / properties / venue / default
      Removed value: -null
    • removedInput schema / properties / venue / title
      Removed value: -"Venue"
    • addedInput schema / properties / venue / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedInput schema / title
      Removed value: -"get_my_open_ordersArguments"
    • addedOutput schema / $defs / OrderOut / properties / deprecation / additionalProperties
      Added value: +true
    • removedOutput schema / $defs / OrderOut / properties / deprecation / anyOf
      Removed value: -[
      -  {
      -    "additionalProperties": true,
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / OrderOut / properties / deprecation / default
      Removed value: -null
    • removedOutput schema / $defs / OrderOut / properties / deprecation / title
      Removed value: -"Deprecation"
    • addedOutput schema / $defs / OrderOut / properties / deprecation / type
      Added value: +[
      +  "object",
      +  "null"
      +]
    • removedOutput schema / $defs / OrderOut / properties / expires_at / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / OrderOut / properties / expires_at / default
      Removed value: -null
    • removedOutput schema / $defs / OrderOut / properties / expires_at / title
      Removed value: -"Expires At"
    • addedOutput schema / $defs / OrderOut / properties / expires_at / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / $defs / OrderOut / properties / is_trigger / title
      Removed value: -"Is Trigger"
    • removedOutput schema / $defs / OrderOut / properties / order_id / title
      Removed value: -"Order Id"
    • removedOutput schema / $defs / OrderOut / properties / price / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / OrderOut / properties / price / default
      Removed value: -null
    • removedOutput schema / $defs / OrderOut / properties / price / title
      Removed value: -"Price"
    • addedOutput schema / $defs / OrderOut / properties / price / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / OrderOut / properties / reduce_only / title
      Removed value: -"Reduce Only"
    • removedOutput schema / $defs / OrderOut / properties / side / title
      Removed value: -"Side"
    • removedOutput schema / $defs / OrderOut / properties / size / title
      Removed value: -"Size"
    • removedOutput schema / $defs / OrderOut / properties / stop_loss / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / OrderOut / properties / stop_loss / default
      Removed value: -null
    • removedOutput schema / $defs / OrderOut / properties / stop_loss / title
      Removed value: -"Stop Loss"
    • addedOutput schema / $defs / OrderOut / properties / stop_loss / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / OrderOut / properties / symbol / title
      Removed value: -"Symbol"
    • removedOutput schema / $defs / OrderOut / properties / trigger_price / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / $defs / OrderOut / properties / trigger_price / default
      Removed value: -null
    • removedOutput schema / $defs / OrderOut / properties / trigger_price / title
      Removed value: -"Trigger Price"
    • addedOutput schema / $defs / OrderOut / properties / trigger_price / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / $defs / OrderOut / properties / type / title
      Removed value: -"Type"
    • removedOutput schema / $defs / OrderOut / properties / venue / title
      Removed value: -"Venue"
    • removedOutput schema / $defs / OrderOut / title
      Removed value: -"OrderOut"
    • addedOutput schema / properties / deprecation / additionalProperties
      Added value: +true
    • removedOutput schema / properties / deprecation / anyOf
      Removed value: -[
      -  {
      -    "additionalProperties": true,
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • removedOutput schema / properties / deprecation / default
      Removed value: -null
    • removedOutput schema / properties / deprecation / title
      Removed value: -"Deprecation"
    • addedOutput schema / properties / deprecation / type
      Added value: +[
      +  "object",
      +  "null"
      +]
    • removedOutput schema / properties / orders / title
      Removed value: -"Orders"
    • removedOutput schema / title
      Removed value: -"Orders"
  3. First observed

TDQS

A4.5/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true and destructiveHint=false, so the safety profile is covered. The description adds genuine context beyond that: which order families are surfaced (triggered protective orders, held TRIGGER_ENTRY records with req_ ids) and the units of the returned sizes and prices (base coin, USD). It stops short of stating pagination or result limits, which is the only remaining behavioral gap.

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

Conciseness5/5

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

Front-loaded with the definition, then usage, then exclusions, then inputs, units, and the follow-up call — a clean decision-oriented progression with no filler. Every clause carries information an agent would otherwise have to guess.

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?

Return values need not be described because an output schema exists, and the description covers the things structured fields cannot: which order categories appear, id formats to look for, and unit conventions. For a two-optional-filter read tool this is complete enough to invoke confidently.

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% and both params are optional with descriptions ('Only this venue', 'Only this base coin'), so the description's one line about optional venue and symbol filters largely restates structured data. The units sentence (sizes in base coin, prices in USD) is useful but pertains to output values rather than to parameter meaning, so this lands at the baseline.

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

Purpose5/5

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

Names a specific resource and its exact scope: resting orders across the user's venues, including protective stop-loss/take-profit (is_trigger = true) and TradeHub TRIGGER_ENTRY orders with req_… ids. It explicitly separates itself from get_my_trade_history (filled trades) and implicitly from get_order_status, so an agent can identify it without opening any schema.

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

Usage Guidelines5/5

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

Gives concrete when-to-use reasons (find an order_id to cancel, confirm a stop is in place), an explicit exclusion with a named alternative (filled trades → get_my_trade_history), and a handoff to the natural next tool, cancel_order(order_id). Nothing about tool selection is left to inference.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources