get_order_history

Retrieve detailed order history from Bybit by specifying category, symbol, order ID, and time range. Use this tool to monitor past orders, analyze trading activity, and manage portfolio performance.

Instructions

Get order history

Args:
    category (str): Category (spot, linear, inverse, etc.)
    symbol (Optional[str]): Symbol (e.g., BTCUSDT)
    orderId (Optional[str]): Order ID
    orderLinkId (Optional[str]): Order link ID
    orderFilter (Optional[str]): Order filter
    orderStatus (Optional[str]): Order status
    startTime (Optional[int]): Start time in milliseconds
    endTime (Optional[int]): End time in milliseconds
    limit (int): Number of orders to retrieve

Returns:
    Dict: Order history

Example:
    get_order_history("spot", "BTCUSDT", "123456789", "link123", "Order", "Created", 1625097600000, 1625184000000, 10)

Reference:
    https://bybit-exchange.github.io/docs/v5/order/order-list

Input Schema

Name	Required	Description
`category`	Yes	Category (spot, linear, inverse, etc.)
`endTime`	No	End time in milliseconds
`limit`	No	Number of orders to retrieve
`orderFilter`	No	Order filter
`orderId`	No	Order ID
`orderLinkId`	No	Order link ID
`orderStatus`	No	Order status
`startTime`	No	Start time in milliseconds
`symbol`	No	Symbol (e.g., BTCUSDT)

Input Schema (JSON Schema)

{
  "properties": {
    "category": {
      "description": "Category (spot, linear, inverse, etc.)",
      "title": "Category",
      "type": "string"
    },
    "endTime": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "End time in milliseconds",
      "title": "Endtime"
    },
    "limit": {
      "default": 50,
      "description": "Number of orders to retrieve",
      "title": "Limit",
      "type": "integer"
    },
    "orderFilter": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Order filter",
      "title": "Orderfilter"
    },
    "orderId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Order ID",
      "title": "Orderid"
    },
    "orderLinkId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Order link ID",
      "title": "Orderlinkid"
    },
    "orderStatus": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Order status",
      "title": "Orderstatus"
    },
    "startTime": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Start time in milliseconds",
      "title": "Starttime"
    },
    "symbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Symbol (e.g., BTCUSDT)",
      "title": "Symbol"
    }
  },
  "required": [
    "category"
  ],
  "title": "get_order_historyArguments",
  "type": "object"
}

Bybit Server

get_order_history

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Bybit Server

Related Tools

MCP directory API