Claude Skill Integration

{
  "name": "simutrade",
  "description": "Simulated securities trading API supporting US stocks, HK stocks, and cryptocurrency. Allows checking prices, placing orders, and managing portfolios.",
  "api_key_env": "TRADESIM_API_KEY",
  "base_url": "https://api.simutrade.ai/v1",
  "tools": [
    {
      "name": "get_quote",
      "description": "Get the current price and market data for a stock or cryptocurrency. Use this to check prices before trading.",
      "input_schema": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string",
            "description": "Trading symbol. US stocks: AAPL, GOOGL, TSLA. HK stocks: 0700.HK, 9988.HK. Crypto: BTC-USD, ETH-USD"
          }
        },
        "required": ["symbol"]
      }
    },
    {
      "name": "place_order",
      "description": "Place a buy or sell order for a stock or cryptocurrency. Supports market, limit, and stop orders.",
      "input_schema": {
        "type": "object",
        "properties": {
          "symbol": {
            "type": "string",
            "description": "Trading symbol (e.g., AAPL, 0700.HK, BTC-USD)"
          },
          "side": {
            "type": "string",
            "enum": ["buy", "sell"],
            "description": "Order side - buy or sell"
          },
          "type": {
            "type": "string",
            "enum": ["market", "limit", "stop"],
            "description": "Order type. Use 'market' for immediate execution at current price"
          },
          "quantity": {
            "type": "number",
            "description": "Number of shares or units to trade"
          },
          "price": {
            "type": "number",
            "description": "Limit or stop price. Required for limit and stop orders, ignored for market orders"
          }
        },
        "required": ["symbol", "side", "type", "quantity"]
      }
    },
    {
      "name": "get_portfolio",
      "description": "Get the current portfolio summary including cash balance, positions, and P&L",
      "input_schema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "list_orders",
      "description": "List recent orders with optional status filter",
      "input_schema": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "enum": ["pending", "filled", "cancelled"],
            "description": "Filter orders by status"
          },
          "limit": {
            "type": "integer",
            "description": "Number of orders to return (default: 10)"
          }
        }
      }
    },
    {
      "name": "cancel_order",
      "description": "Cancel a pending order by its ID",
      "input_schema": {
        "type": "object",
        "properties": {
          "order_id": {
            "type": "string",
            "description": "The order ID to cancel"
          }
        },
        "required": ["order_id"]
      }
    },
    {
      "name": "create_risk_control_rule",
      "description": "Create a risk control rule with structured risk metrics and AI metadata. Rules can be set at order, position, or account level. IMPORTANT: You MUST always provide the reason field and SHOULD include risk assessment data (max_loss, max_loss_percent, risk_reward_ratio, volatility) and comprehensive metadata (ai, strategy, market, triggerConditions) to enable proper risk tracking and AI self-review. These fields document your decision-making process and enable better risk management analysis.",
      "input_schema": {
        "type": "object",
        "properties": {
          "rule_type": {
            "type": "string",
            "enum": ["stop_loss", "take_profit", "trailing_stop", "position_limit"],
            "description": "Type of risk control rule"
          },
          "config": {
            "type": "object",
            "description": "Rule configuration (type: absolute/percentage, price/percentage/distance values, enabled flag)"
          },
          "order_id": {
            "type": "string",
            "description": "Optional: Order ID for order-level rules"
          },
          "symbol": {
            "type": "string",
            "description": "Optional: Symbol for position-level rules"
          },
          "reason": {
            "type": "string",
            "description": "REQUIRED: Human-readable explanation for setting this rule. You MUST provide a clear reason explaining why this rule is being created, including technical analysis, market conditions, or risk considerations. Example: 'Based on RSI indicator (72) showing overbought condition and MACD divergence signal, setting 5% stop loss to protect existing profits'"
          },
          "max_loss": {
            "type": "number",
            "description": "RECOMMENDED: Maximum loss amount in currency (e.g., 5000.0). Calculate based on position size and stop loss percentage."
          },
          "max_loss_percent": {
            "type": "number",
            "description": "RECOMMENDED: Maximum loss percentage (e.g., 5.0 for 5%). Should match the stop loss percentage in config if applicable."
          },
          "risk_reward_ratio": {
            "type": "number",
            "description": "RECOMMENDED: Risk-reward ratio (e.g., 2.0 for 2:1). Calculate as potential profit divided by potential loss."
          },
          "volatility": {
            "type": "number",
            "description": "RECOMMENDED: Volatility metric (e.g., 0.15 for 15%). Use historical volatility or implied volatility if available."
          },
          "metadata": {
            "type": "object",
            "description": "RECOMMENDED: AI metadata and extended information. You should include: ai (confidence, model, reasoning, decision_factors), strategy (id, name, params), market (trend, support, resistance, current_price), and trigger_conditions (technical_indicators, price_levels). This metadata enables AI self-review and better decision tracking.",
            "properties": {
              "ai": {
                "type": "object",
                "description": "AI metadata",
                "properties": {
                  "confidence": {"type": "number", "description": "Confidence level 0-1"},
                  "model": {"type": "string", "description": "AI model name (e.g., 'claude-3.5-sonnet')"},
                  "reasoning": {"type": "string", "description": "AI reasoning process"},
                  "decision_factors": {"type": "array", "items": {"type": "string"}, "description": "List of decision factors"}
                }
              },
              "strategy": {
                "type": "object",
                "description": "Strategy information",
                "properties": {
                  "id": {"type": "string"},
                  "name": {"type": "string"},
                  "params": {"type": "object"}
                }
              },
              "market": {
                "type": "object",
                "description": "Market analysis",
                "properties": {
                  "trend": {"type": "string", "enum": ["up", "down", "sideways"]},
                  "support": {"type": "number"},
                  "resistance": {"type": "number"},
                  "current_price": {"type": "number"}
                }
              },
              "trigger_conditions": {
                "type": "object",
                "description": "Trigger condition details",
                "properties": {
                  "technical_indicators": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {"type": "string"},
                        "value": {"type": "number"},
                        "threshold": {"type": "number"},
                        "condition": {"type": "string", "enum": ["above", "below", "cross"]}
                      }
                    }
                  },
                  "price_levels": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "type": {"type": "string", "enum": ["support", "resistance", "target"]},
                        "price": {"type": "number"}
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "required": ["rule_type", "config", "reason"]
      }
    },
    {
      "name": "list_risk_control_rules",
      "description": "List risk control rules with optional filters",
      "input_schema": {
        "type": "object",
        "properties": {
          "order_id": {
            "type": "string",
            "description": "Filter by order ID"
          },
          "symbol": {
            "type": "string",
            "description": "Filter by symbol"
          },
          "rule_type": {
            "type": "string",
            "enum": ["stop_loss", "take_profit", "trailing_stop", "position_limit"],
            "description": "Filter by rule type"
          },
          "is_active": {
            "type": "boolean",
            "description": "Filter by active status"
          }
        }
      }
    },
    {
      "name": "list_risk_control_executions",
      "description": "List risk control execution records showing when rules were triggered",
      "input_schema": {
        "type": "object",
        "properties": {
          "rule_id": {
            "type": "string",
            "description": "Filter by rule ID"
          },
          "status": {
            "type": "string",
            "enum": ["triggered", "executed", "cancelled"],
            "description": "Filter by execution status"
          },
          "limit": {
            "type": "integer",
            "description": "Number of records to return (default: 50)"
          }
        }
      }
    }
  ]
}