> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.ripio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update The Amount And/or Price Of An Order

> Allows update the amount and/or price of an order, it is not possible to change a canceled or fully executed order.

Publishes updates in the following websocket topics: [`orderbook`](#operation/orderbook), and [`balance`](#operation/balance).

---

**Authorization**

- Requires a valid API key.
- Required API-key permission(s):
  - trading_write



## OpenAPI

````yaml put /trade/orders
openapi: 3.0.0
info:
  title: Ripio Gateway
  description: Ripio API - Services documentation.
  version: 0.1.0
  x-logo:
    url: https://cwstatic.nyc3.digitaloceanspaces.com/1996/bitcointrade.png
servers:
  - url: https://api.ripio.com
    description: Production environment
security: []
paths:
  /trade/orders:
    put:
      tags:
        - Ripio Trade
      summary: Orders - Update the amount and/or price of an order
      description: >-
        Allows update the amount and/or price of an order, it is not possible to
        change a canceled or fully executed order.


        Publishes updates in the following websocket topics:
        [`orderbook`](#operation/orderbook), and
        [`balance`](#operation/balance).


        ---


        **Authorization**


        - Requires a valid API key.

        - Required API-key permission(s):
          - trading_write
      parameters:
        - in: header
          name: authorization
          required: true
          description: The API key as a string.
          schema:
            type: string
        - in: header
          name: signature
          required: true
          description: >-
            See the [Generating
            Signature](/static/api/authentication#generating-signature) section
            for more details.
          schema:
            type: string
        - in: header
          name: timestamp
          required: true
          description: >-
            A timestamp in milliseconds. See the [Timestamp
            Security](/static/api/authentication#timestamp-security) section for
            more details.
          schema:
            type: number
        - in: header
          name: timstamp-tolerance
          required: false
          description: >-
            An additional, non-required parameter, that you can send to specify
            the number of milliseconds after the timestamp for the request to be
            valid. See the [Timestamp
            Security](/static/api/authentication#timestamp-security) section for
            more details.
          schema:
            type: number
      requestBody:
        content:
          application/json:
            schema:
              properties:
                unit_price:
                  description: >-
                    New order price. Cannot be changed if it would immediately
                    execute against existing orders
                  type: string
                  example: '10'
                amount:
                  description: New order amount in base currency
                  type: string
                  example: '100'
                order_id:
                  description: Unique identifier of the order to update
                  type: string
                  example: 00CE34E9-0168-4050-9D58-10C705A1AC81
              required:
                - order_id
              type: object
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                description: Ok
                properties:
                  data:
                    type: number
                  error_code:
                    type: number
                    example: null
                  message:
                    type: string
                    example: null
                required:
                  - data
                  - error_code
                  - message
                type: object

````