For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/modify-order.md.

Modify an active limit order

Organization tokenNo token

PATCH
/orders/{id}

Changes the price and/or quantity of an active CeFi limit order. The change is asynchronous: the order's stored price and quantity update once the exchange confirms the modification. Only active limit orders are modifiable. On a DeFi-settled market, a modification that holds more than the CeFi balance covers first allocates the difference from the user's DeFi wallet and is queued until it lands; if the queued modification then fails, the user is notified and the order keeps its previous price and quantity.

Rate limit: counts against the Orders limit, 10 a second and 120 a minute (user token, per user); 100 a second and 1,200 a minute (organization api key, per organization). See Rate limits.

Authorization

bearerAuth
headerAuthorizationBearer <JWT>

An access token from POST /v1/auth/api-key/token. An organization token lasts one hour and has no refresh token; a personal token can be refreshed.

Path Parameters

id*string

Order ID

Header Parameters

TM-On-Behalf-Of?string

Act as one of your organization's users. The value is the user_id returned when the user was created; the request then reads and writes that user's account. Requires an organization token and a user your organization created: 400 for a personal token, a repeated header or a non-UUID, 403 for a user outside your organization. Not accepted on organization-scoped routes.

Formatuuid

Request Body

application/json
  1. body

Request to modify an active limit order. At least one of price or qty must be supplied; any field that is omitted is left unchanged.

price?string

New limit price per unit of base asset as a positive decimal string.

qty?string

New quantity as a positive decimal string.

Response Body

Modification request accepted

application/json
  1. response
Example Request
curl -X PATCH 'https://api.truemarkets.co/v1/gateway/orders/string' \  -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{}