Deribit Trading API

The Trading API from Deribit — 38 operation(s) for trading.

Operations 38

GET /private/get_settlement_history_by_currency
GET /private/get_settlement_history_by_instrument
GET /private/get_order_history_by_instrument
GET /private/get_order_history_by_currency
GET /private/get_order_state
GET /private/get_order_state_by_label
GET /private/get_open_orders
GET /private/get_open_orders_by_instrument
GET /private/get_open_orders_by_currency
GET /private/get_open_orders_by_label
GET /private/get_order_margin_by_ids
GET /private/get_trigger_order_history
GET /private/get_user_trades_by_instrument
GET /private/get_user_trades_by_instrument_and_time
GET /private/get_user_trades_by_currency
GET /private/get_user_trades_by_currency_and_time
GET /private/get_user_trades_by_order
GET /private/cancel_all
GET /private/cancel_all_by_instrument
GET /private/cancel_all_by_currency
GET /private/cancel_all_by_currency_pair
GET /private/cancel_all_by_kind_or_type
GET /private/cancel_by_label
GET /private/cancel_quotes
GET /private/cancel
GET /private/buy
GET /private/sell
GET /private/edit
GET /private/edit_by_label
GET /private/close_position
GET /private/get_margins
GET /private/get_mmp_config
GET /private/get_mmp_status
GET /private/set_mmp_config
GET /private/reset_mmp
GET /private/mass_quote
GET /private/move_positions
GET /api/v2/private/get_open_orders Get Open Orders #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/deribit-trading-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

deribit-trading-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Deribit Trading API
  version: '1.0'
  description: 'Operations tagged Trading across 2 of this provider''s published API definitions: deribit-openapi.json, deribit-starbase-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://test.deribit.com/api/v2
- url: https://195.138.37.5:4410
  description: Production — Gateway A (rest-order)
- url: https://195.138.37.6:4410
  description: Production — Gateway B (rest-order)
- url: https://195.138.37.137:4410
  description: Test — Gateway A (rest-order)
- url: https://195.138.37.138:4410
  description: Test — Gateway B (rest-order)
tags:
- name: Trading
paths:
  /private/get_settlement_history_by_currency:
    get:
      parameters:
      - name: currency
        required: true
        in: query
        schema:
          $ref: '#/components/schemas/currency'
        description: The currency symbol
      - in: query
        name: type
        required: false
        schema:
          $ref: '#/components/schemas/settlement_type'
        description: Settlement type
      - name: count
        required: false
        in: query
        schema:
          type: integer
          maximum: 1000
          minimum: 1
        description: Number of requested items, default - `20`, maximum - `1000`
      - name: continuation
        in: query
        required: false
        schema:
          type: string
          example: xY7T6cutS3t2B9YtaDkE6TS379oKnkzTvmEDUnEUP2Msa9xKWNNaT
        description: Continuation token for pagination
      - in: query
        name: search_start_timestamp
        required: false
        schema:
          $ref: '#/components/schemas/timestamp'
        description: The latest timestamp to return result from (milliseconds since the UNIX epoch)
      responses:
        '200':
          $ref: '#/components/responses/PrivateSettlementResponse'
      tags:
      - Trading
      requestBody:
        content:
          application/json:
            examples:
              request:
                value:
                  jsonrpc: '2.0'
                  id: 8304
                  method: private/get_settlement_history_by_currency
                  params:
                    currency: BTC
                    type: delivery
                    count: 1
                description: JSON-RPC Request Example
        description: JSON-RPC request body
      description: 'Retrieves settlement, delivery, and bankruptcy events that have affected your account for a specific currency. Settlements occur when futures or options contracts expire and are settled at the delivery price.


        Results can be filtered by settlement type and timestamp. Use pagination parameters (`count` and `continuation`) to retrieve large settlement histories. This data is useful for tracking account-affecting settlement events and understanding how contract expirations impact your account.


        **Scope:** `trade:read`


        [Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_settlement_history_by_currency)


        '
      x-mint:
        metadata:
          title: private/get_settlement_history_by_currency
          og:title: private/get_settlement_history_by_currency
          keywords:
          - private/get_settlement_history_by_currency
          - currency
          - type
          - count
          - continuation
          - search_start_timestamp
          - settlements
          - funding
          - funded
          - index_price
          - instrument_name
          - mark_price
          - position
          - profit_loss
          - session_bankruptcy
          - session_profit_loss
          - session_tax
          - session_tax_rate
          - socialized
          - timestamp
        href: /api-reference/trading/private-get_settlement_history_by_currency
    servers:
    - url: https://test.deribit.com/api/v2
  /private/get_settlement_history_by_instrument:
    get:
      parameters:
      - name: instrument_name
        required: true
        in: query
        schema:
          $ref: '#/components/schemas/instrument_name'
        description: Instrument name
      - in: query
        name: type
        required: false
        schema:
          $ref: '#/components/schemas/settlement_type'
        description: Settlement type
      - name: count
        required: false
        in: query
        schema:
          type: integer
          maximum: 1000
          minimum: 1
        description: Number of requested items, default - `20`, maximum - `1000`
      - name: continuation
        in: query
        required: false
        schema:
          type: string
          example: xY7T6cutS3t2B9YtaDkE6TS379oKnkzTvmEDUnEUP2Msa9xKWNNaT
        description: Continuation token for pagination
      - in: query
        name: search_start_timestamp
        required: false
        schema:
          $ref: '#/components/schemas/timestamp'
        description: The latest timestamp to return result from (milliseconds since the UNIX epoch)
      responses:
        '200':
          $ref: '#/components/responses/PrivateSettlementResponse'
      tags:
      - Trading
      requestBody:
        content:
          application/json:
            examples:
              request:
                value:
                  jsonrpc: '2.0'
                  id: 2192
                  method: private/get_settlement_history_by_instrument
                  params:
                    instrument_name: ETH-22FEB19
                    type: settlement
                    count: 1
                description: JSON-RPC Request Example
        description: JSON-RPC request body
      description: 'Retrieves settlement, delivery, and bankruptcy events for a specific instrument that have affected your account. Settlements occur when futures or options contracts expire and are settled at the delivery price.


        Results can be filtered by settlement type and timestamp. Use pagination parameters (`count` and `continuation`) to retrieve large settlement histories. This method is useful for tracking settlement events for a specific instrument.


        **Scope:** `trade:read`


        [Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_settlement_history_by_instrument)


        '
      x-mint:
        metadata:
          title: private/get_settlement_history_by_instrument
          og:title: private/get_settlement_history_by_instrument
          keywords:
          - private/get_settlement_history_by_instrument
          - instrument_name
          - type
          - count
          - continuation
          - search_start_timestamp
          - settlements
          - funding
          - funded
          - index_price
          - mark_price
          - position
          - profit_loss
          - session_bankruptcy
          - session_profit_loss
          - session_tax
          - session_tax_rate
          - socialized
          - timestamp
        href: /api-reference/trading/private-get_settlement_history_by_instrument
    servers:
    - url: https://test.deribit.com/api/v2
  /private/get_order_history_by_instrument:
    get:
      parameters:
      - name: instrument_name
        required: true
        in: query
        schema:
          $ref: '#/components/schemas/instrument_name'
        description: Instrument name
      - name: count
        required: false
        in: query
        schema:
          type: integer
          maximum: 1000
          minimum: 1
        description: Number of requested items, default - `20`, maximum - `1000`
      - name: offset
        in: query
        required: false
        schema:
          example: 10
          type: integer
        description: The offset for pagination, default - `0`
      - name: include_old
        in: query
        required: false
        schema:
          example: false
          type: boolean
        description: Include in result orders older than 2 days, default - `false`
      - name: include_unfilled
        in: query
        required: false
        schema:
          example: false
          type: boolean
        description: Include in result fully unfilled closed orders, default - `false`
      - name: with_continuation
        in: query
        required: false
        schema:
          type: boolean
        description: When set to true, the API response format changes from a simple list of orders to an object containing the orders and a continuation token.
      - name: continuation
        in: query
        required: false
        schema:
          type: string
          example: xY7T6cutS3t2B9YtaDkE6TS379oKnkzTvmEDUnEUP2Msa9xKWNNaT
        description: Continuation token for pagination
      - name: historical
        in: query
        required: false
        schema:
          type: boolean
        description: 'Determines whether historical trade and order records should be retrieved.


          - `false` (default): Returns recent records: orders for 30 min, trades for 24h.

          - `true`: Fetches historical records, available after a short delay due to indexing. Recent data is not included.


          **📖 Related Article:** [Accessing Historical Trades and Orders Using API](https://docs.deribit.com/articles/accessing-historical-trades-orders)

          '
      responses:
        '200':
          $ref: '#/components/responses/PrivateGetOrderHistoryResponse'
      tags:
      - Trading
      requestBody:
        content:
          application/json:
            examples:
              request:
                value:
                  jsonrpc: '2.0'
                  id: 1032
                  method: private/get_order_history_by_instrument
                  params:
                    instrument_name: BTC-PERPETUAL
                    count: 1
                description: JSON-RPC Request Example
        description: JSON-RPC request body
      description: 'Retrieves the order history for a specific instrument. The history includes orders that have been partially or fully filled, as well as cancelled orders (if `include_unfilled_orders` is set to true).


        Results can be paginated using `offset` and `count` parameters, or using continuation tokens. Use `include_old_orders` to include orders from before a certain date, and `historical` to retrieve historical order data.


        **📖 Related Article:** [Accessing Historical Trades and Orders Using API](https://docs.deribit.com/articles/accessing-historical-trades-orders)


        **Scope:** `trade:read`


        [Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_order_history_by_instrument)


        '
      x-mint:
        metadata:
          title: private/get_order_history_by_instrument
          og:title: private/get_order_history_by_instrument
          keywords:
          - private/get_order_history_by_instrument
          - instrument_name
          - count
          - offset
          - include_old
          - include_unfilled
          - with_continuation
          - continuation
          - historical
          - order_id
          - order_state
          - order_type
          - original_order_type
          - time_in_force
          - is_rebalance
          - is_liquidation
          - creation_timestamp
          - last_update_timestamp
          - direction
          - price
          - label
          - post_only
          - reject_post_only
          - reduce_only
          - api
          - web
          - mobile
          - refresh_amount
          - display_amount
          - amount
          - contracts
          - filled_amount
          - average_price
          - advanced
          - implv
          - usd
          - triggered
          - trigger
          - trigger_price
          - trigger_offset
          - trigger_reference_price
          - block_trade
          - mmp
          - risk_reducing
          - replaced
          - auto_replaced
          - quote
          - mmp_group
          - quote_set_id
          - quote_id
          - trigger_order_id
          - app_name
          - mmp_cancelled
          - cancel_reason
          - oto_order_ids
          - trigger_fill_condition
          - oco_ref
          - primary_order_id
          - is_secondary_oto
          - is_primary_otoco
        href: /api-reference/trading/private-get_order_history_by_instrument
    servers:
    - url: https://test.deribit.com/api/v2
  /private/get_order_history_by_currency:
    get:
      parameters:
      - name: currency
        required: true
        in: query
        schema:
          $ref: '#/components/schemas/currency'
        description: The currency symbol
      - name: kind
        required: false
        in: query
        schema:
          $ref: '#/components/schemas/kind_with_combo_all'
        description: Instrument kind, `"combo"` for any combo or `"any"` for all. If not provided instruments of all kinds are considered
      - name: count
        required: false
        in: query
        schema:
          type: integer
          maximum: 1000
          minimum: 1
        description: Number of requested items, default - `20`, maximum - `1000`
      - name: offset
        in: query
        required: false
        schema:
          example: 10
          type: integer
        description: The offset for pagination, default - `0`
      - name: include_old
        in: query
        required: false
        schema:
          example: false
          type: boolean
        description: Include in result orders older than 2 days, default - `false`
      - name: include_unfilled
        in: query
        required: false
        schema:
          example: false
          type: boolean
        description: Include in result fully unfilled closed orders, default - `false`
      - name: with_continuation
        in: query
        required: false
        schema:
          type: boolean
        description: When set to true, the API response format changes from a simple list of orders to an object containing the orders and a continuation token.
      - name: continuation
        in: query
        required: false
        schema:
          type: string
          example: xY7T6cutS3t2B9YtaDkE6TS379oKnkzTvmEDUnEUP2Msa9xKWNNaT
        description: Continuation token for pagination
      - name: historical
        in: query
        required: false
        schema:
          type: boolean
        description: 'Determines whether historical trade and order records should be retrieved.


          - `false` (default): Returns recent records: orders for 30 min, trades for 24h.

          - `true`: Fetches historical records, available after a short delay due to indexing. Recent data is not included.


          **📖 Related Article:** [Accessing Historical Trades and Orders Using API](https://docs.deribit.com/articles/accessing-historical-trades-orders)

          '
      responses:
        '200':
          $ref: '#/components/responses/PrivateGetOrderHistoryResponse'
      tags:
      - Trading
      requestBody:
        content:
          application/json:
            examples:
              request:
                value:
                  jsonrpc: '2.0'
                  id: 9305
                  method: private/get_order_history_by_currency
                  params:
                    currency: BTC
                    kind: future
                    count: 1
                description: JSON-RPC Request Example
        description: JSON-RPC request body
      description: 'Retrieves the order history for a specific currency. The history includes orders that have been partially or fully filled, as well as cancelled orders (if `include_unfilled_orders` is set to true).


        Results can be filtered by instrument kind and paginated using `offset` and `count` parameters, or using continuation tokens. Use `include_old_orders` to include orders from before a certain date, and `historical` to retrieve historical order data.


        **📖 Related Article:** [Accessing Historical Trades and Orders Using API](https://docs.deribit.com/articles/accessing-historical-trades-orders)


        **Scope:** `trade:read`


        [Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_order_history_by_currency)


        '
      x-mint:
        metadata:
          title: private/get_order_history_by_currency
          og:title: private/get_order_history_by_currency
          keywords:
          - private/get_order_history_by_currency
          - currency
          - kind
          - count
          - offset
          - include_old
          - include_unfilled
          - with_continuation
          - continuation
          - historical
          - order_id
          - order_state
          - order_type
          - original_order_type
          - time_in_force
          - is_rebalance
          - is_liquidation
          - instrument_name
          - creation_timestamp
          - last_update_timestamp
          - direction
          - price
          - label
          - post_only
          - reject_post_only
          - reduce_only
          - api
          - web
          - mobile
          - refresh_amount
          - display_amount
          - amount
          - contracts
          - filled_amount
          - average_price
          - advanced
          - implv
          - usd
          - triggered
          - trigger
          - trigger_price
          - trigger_offset
          - trigger_reference_price
          - block_trade
          - mmp
          - risk_reducing
          - replaced
          - auto_replaced
          - quote
          - mmp_group
          - quote_set_id
          - quote_id
          - trigger_order_id
          - app_name
          - mmp_cancelled
          - cancel_reason
          - oto_order_ids
          - trigger_fill_condition
          - oco_ref
          - primary_order_id
          - is_secondary_oto
          - is_primary_otoco
        href: /api-reference/trading/private-get_order_history_by_currency
    servers:
    - url: https://test.deribit.com/api/v2
  /private/get_order_state:
    get:
      tags:
      - Trading
      parameters:
      - in: query
        name: order_id
        required: true
        schema:
          $ref: '#/components/schemas/order_id'
        description: The order id
      responses:
        '200':
          $ref: '#/components/responses/PrivateGetOrderStateResponse'
        '400':
          $ref: '#/components/responses/ErrorMessageResponse'
      requestBody:
        content:
          application/json:
            examples:
              request:
                value:
                  jsonrpc: '2.0'
                  id: 4316
                  method: private/get_order_state
                  params:
                    order_id: ETH-331562
                description: JSON-RPC Request Example
        description: JSON-RPC request body
      description: 'Retrieves the current state of an order identified by its order ID. The response includes order details such as status (open, filled, cancelled), filled amount, remaining amount, price, and other order properties.


        **Important Note for Mass Quotes:** Quote orders are order-like structures that don''t fully translate to normal orders. When checking order state for quotes, the `amount` field represents the remaining amount, not the original order amount.


        **Scope:** `trade:read`


        [Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_order_state)


        '
      x-mint:
        metadata:
          title: private/get_order_state
          og:title: private/get_order_state
          keywords:
          - private/get_order_state
          - order_id
          - order_state
          - order_type
          - original_order_type
          - time_in_force
          - is_rebalance
          - is_liquidation
          - instrument_name
          - creation_timestamp
          - last_update_timestamp
          - direction
          - price
          - label
          - post_only
          - reject_post_only
          - reduce_only
          - api
          - web
          - mobile
          - refresh_amount
          - display_amount
          - amount
          - contracts
          - filled_amount
          - average_price
          - advanced
          - implv
          - usd
          - triggered
          - trigger
          - trigger_price
          - trigger_offset
          - trigger_reference_price
          - block_trade
          - mmp
          - risk_reducing
          - replaced
          - auto_replaced
          - quote
          - mmp_group
          - quote_set_id
          - quote_id
          - trigger_order_id
          - app_name
          - mmp_cancelled
          - cancel_reason
          - oto_order_ids
          - trigger_fill_condition
          - oco_ref
          - primary_order_id
          - is_secondary_oto
          - is_primary_otoco
        href: /api-reference/trading/private-get_order_state
    servers:
    - url: https://test.deribit.com/api/v2
  /private/get_order_state_by_label:
    get:
      tags:
      - Trading
      parameters:
      - name: currency
        required: true
        in: query
        schema:
          $ref: '#/components/schemas/currency'
        description: The currency symbol
      - name: label
        in: query
        schema:
          type: string
        required: false
        description: user defined label for the order (maximum 64 characters)
      responses:
        '200':
          $ref: '#/components/responses/PrivateGetOrderStateByLabelResponse'
        '400':
          $ref: '#/components/responses/ErrorMessageResponse'
      requestBody:
        content:
          application/json:
            examples:
              request:
                value:
                  jsonrpc: '2.0'
                  id: 4316
                  method: private/get_order_state_by_label
                  params:
                    currency: ETH
                    label: fooBar
                description: JSON-RPC Request Example
        description: JSON-RPC request body
      description: 'Retrieves the state of recent orders that have a specific label. This is useful for tracking orders that share the same label, which is helpful for managing related orders.


        Results are filtered by currency and label. The response includes order details such as status, filled amount, remaining amount, and other order properties for all orders with the specified label.


        **Scope:** `trade:read`


        [Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_order_state_by_label)


        '
      x-mint:
        metadata:
          title: private/get_order_state_by_label
          og:title: private/get_order_state_by_label
          keywords:
          - private/get_order_state_by_label
          - currency
          - label
          - order_id
          - order_state
          - order_type
          - original_order_type
          - time_in_force
          - is_rebalance
          - is_liquidation
          - instrument_name
          - creation_timestamp
          - last_update_timestamp
          - direction
          - price
          - post_only
          - reject_post_only
          - reduce_only
          - api
          - web
          - mobile
          - refresh_amount
          - display_amount
          - amount
          - contracts
          - filled_amount
          - average_price
          - advanced
          - implv
          - usd
          - triggered
          - trigger
          - trigger_price
          - trigger_offset
          - trigger_reference_price
          - block_trade
          - mmp
          - risk_reducing
          - replaced
          - auto_replaced
          - quote
          - mmp_group
          - quote_set_id
          - quote_id
          - trigger_order_id
          - app_name
          - mmp_cancelled
          - cancel_reason
          - oto_order_ids
          - trigger_fill_condition
          - oco_ref
          - primary_order_id
          - is_secondary_oto
          - is_primary_otoco
        href: /api-reference/trading/private-get_order_state_by_label
    servers:
    - url: https://test.deribit.com/api/v2
  /private/get_open_orders:
    get:
      parameters:
      - name: kind
        required: false
        in: query
        schema:
          $ref: '#/components/schemas/kind'
        description: Instrument kind, if not provided instruments of all kinds are considered
      - name: type
        required: false
        in: query
        schema:
          $ref: '#/components/schemas/order_type2'
        description: Order type, default - `all`
      responses:
        '200':
          $ref: '#/components/responses/PrivateGetOpenOrdersResponse'
      tags:
      - Trading
      requestBody:
        content:
          application/json:
            examples:
              request:
                value:
                  jsonrpc: '2.0'
                  id: 1953
                  method: private/get_open_orders
                  params: {}
                description: JSON-RPC Request Example
        description: JSON-RPC request body
      description: 'Retrieves a list of all open orders for the authenticated account across all currencies. Open orders are orders that have been placed but not yet filled or cancelled.


        Results can be filtered by instrument kind and order type. This method provides a comprehensive view of all active orders.


        **Scope:** `trade:read`


        [Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_open_orders)


        '
      x-mint:
        metadata:
          title: private/get_open_orders
          og:title: private/get_open_orders
          keywords:
          - private/get_open_orders
          - kind
          - type
          - order_id
          - order_state
          - order_type
          - original_order_type
          - time_in_force
          - is_rebalance
          - is_liquidation
          - instrument_name
          - creation_timestamp
          - last_update_timestamp
          - direction
          - price
          - label
          - post_only
          - reject_post_only
          - reduce_only
          - api
          - web
          - mobile
          - refresh_amount
          - display_amount
          - amount
          - contracts
          - filled_amount
          - average_price
          - advanced
          - implv
          - usd
          - triggered
          - trigger
          - trigger_price
          - trigger_offset
          - trigger_reference_price
          - block_trade
          - mmp
          - risk_reducing
          - replaced
          - auto_replaced
          - quote
          - mmp_group
          - quote_set_id
          - quote_id
          - trigger_order_id
          - app_name
          - mmp_cancelled
          - cancel_reason
          - oto_order_ids
          - trigger_fill_condition
          - oco_ref
          - primary_order_id
          - is_secondary_oto
          - is_primary_otoco
        href: /api-reference/trading/private-get_open_orders
    servers:
    - url: https://test.deribit.com/api/v2
  /private/get_open_orders_by_instrument:
    get:
      parameters:
      - name: instrument_name
        required: true
        in: query
        schema:
          $ref: '#/components/schemas/instrument_name'
        description: Instrument name
      - name: type
        required: false
        in: query
        schema:
          $ref: '#/components/schemas/order_type2'
        description: Order type, default - `all`
      responses:
        '200':
          $ref: '#/components/responses/PrivateGetOpenOrdersResponse'
      tags:
      - Trading
      requestBody:
        content:
          application/json:
            examples:
              request:
                value:
                  jsonrpc: '2.0'
                  id: 8442
                  method: private/get_open_orders_by_instrument
                  params:
                    instrument_name: ETH-22FEB19-120-C
                description: JSON-RPC Request Example
        description: JSON-RPC request body
      description: 'Retrieves a list of all open orders for a specific instrument. Open orders are orders that have been placed but not yet filled or cancelled.


        Results can be filtered by order type. This method is useful for checking active orders for a particular instrument.


        **Scope:** `trade:read`


        [Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_open_orders_by_instrument)


        '
      x-mint:
        metadata:
          title: private/get_open_orders_by_instrument
          og:title: private/get_open_orders_by_instrument
          keywords:
          - private/get_open_orders_by_instrument
          - instrument_name
          - type
          - order_id
          - order_state
          - order_type
          - original_order_type
          - time_in_force
          - is_rebalance
          - is_liquidation
          - creation_timestamp
          - last_update_timestamp
          - direction
          - price
          - label
          - post_only
          - reject_post_only
          - reduce_only
          - api
          - web
          - mobile
          - refresh_amount
          - display_amount
          - amount
          - contracts
          - filled_amount
          - average_price
          - advanced
          - implv
          - usd
          - triggered
          - trigger
          - trigger_price
          - trigger_offset
          - trigger_reference_price
          - block_trade
          - mmp
          - risk_reducing
          - replaced
          - auto_replaced
          - quote
          - mmp_group
          - quote_set_id
          - quote_id
          - trigger_order_id
          - app_name
          - mmp_cancelled
          - cancel_reason
          - oto_order_ids
          - trigger_fill_condition
          - oco_ref
          - primary_order_id
          - is_secondary_oto
          - is_primary_otoco
        href: /api-reference/trading/private-get_open_orders_by_instrument
    servers:
    - url: https://test.deribit.com/api/v2
  /private/get_open_orders_by_currency:
    get:
      parameters:
      - name: currency
        required: true
        in: query
        schema:
          $ref: '#/components/schemas/currency'
        description: The currency symbol
      - name: kind
        required: false
        in: query
        schema:
          $ref: '#/components/schemas/kind'
        description: Instrument kind, if not provided instruments of all kinds are considered
      - name: type
        required: false
        in: query
        schema:
          $ref: '#/components/schemas/order_type2'
        description: Order type, default - `all`
      responses:
        '200':
          $ref: '#/components/responses/PrivateGetOpenOrdersResponse'
      tags:
      - Trading
      requestBody:
        content:
          application/json:
            examples:
              request:
                value:
                  jsonrpc: '2.0'
                  id: 1953
                  method: private/get_open_orders_by_currency
                  params:
                    currency: BTC
                description: JSON-RPC Request Example
        description: JSON-RPC request body
      description: 'Retrieves a list of all open orders for a specific currency. Open orders are orders that have been placed but not yet filled or cancelled.


        Results can be filtered by instrument kind and order type. This method provides a view of all active orders within a currency.


        **Scope:** `trade:read`


        [Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_open_orders_by_currency)


        '
      x-mint:
        metadata:
          title: private/get_open_orders_by_currency
          og:title: private/get_open_orders_by_currency
          keywords:
          - private/get_open_orders_by_currency
          - currency
          - kind
          - type
          - order_id
          - order_state
          - order_type
          - original_order_type
          - time_in_force
          - is_rebalance
          - is_liquidation
          - instrument_name
          - creation_timestamp
          - last_update_timestamp
          - direction
          - price
          - label
          - post_only
          

# --- truncated at 32 KB (257 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/deribit/refs/heads/main/openapi/deribit-trading-api-openapi.yml