---
title: "Modify Multiple Orders"
method: POST
path: "/v1/orders/batched/modify"
tags: ["Orders"]
---

# Modify Multiple Orders

`POST /v1/orders/batched/modify`

Modify up to 20 existing orders in a single request. Each entry is forwarded to the exchange as a cancel-replace. If any entry fails request-shape validation, the whole batch is rejected by the gateway before reaching the exchange. The exchange may silently ignore unknown `orderId`s. `modifiedOrderIds` is an echo of the request, not a confirmation; observe actual outcomes on the order stream.

## Request body

- ModifyOrderListRequest — Batched modify-order request.
  - `orders` ModifyOrderListEntry[], required — Orders to modify (1 to 20).
    - `orderId` string, required — Exchange-assigned order ID to modify.
    - `marketSlug` string, required — Market slug the order belongs to.
    - `price` Amount — Represents a monetary amount with its currency
      - `value` string, decimal, required — The amount as a decimal string
      - `currency` string, required — The currency code
    - `quantity` number, double — New order quantity in contracts. Supports decimal quantities on markets whose minimumTradeQty is less than 1.
    - `tif` 'TIME_IN_FORCE_DAY' | 'TIME_IN_FORCE_GOOD_TILL_CANCEL' | 'TIME_IN_FORCE_IMMEDIATE_OR_CANCEL' | 'TIME_IN_FORCE_GOOD_TILL_TIME' | 'TIME_IN_FORCE_FILL_OR_KILL' — TimeInForce specifies how long the order remains in effect.
    - `participateDontInitiate` boolean — Order must rest on the book prior to matching (maker only)
    - `goodTillTime` string — Good till time for orders with TIME_IN_FORCE_GOOD_TILL_DATE

## Response `200`

Orders modified successfully

- ModifyOrderListResponse
  - `modifiedOrderIds` string[] — Order IDs submitted for modification, in request order. Echo of the input, not a confirmation. Watch the order stream for actual outcomes.

## Other responses

- `400` — Bad request - invalid batched modify request or exceeds max batch size
- `401` — Unauthorized - invalid or missing authentication token
- `500` — Internal server error

---

[API](https://skmtc.dev/polymarket/apis/portfolio-api.md) · [All operations](https://skmtc.dev/polymarket/apis/portfolio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/polymarket/portfolio-api/revisions/150874842db1/schema)