Skip to main content
PUT
/
api
/
v1
/
orders
/
{id}
Modify open order
curl --request PUT \
  --url https://api.international.coinbase.com/api/v1/orders/{id} \
  --header 'CB-ACCESS-KEY: <api-key>' \
  --header 'CB-ACCESS-PASSPHRASE: <api-key>' \
  --header 'CB-ACCESS-SIGN: <api-key>' \
  --header 'CB-ACCESS-TIMESTAMP: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "client_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "portfolio": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "price": "<string>",
  "stop_price": "<string>",
  "size": "<string>",
  "stop_limit_price": "<string>"
}'
{
  "order_id": 43877033468085760,
  "client_order_id": "ABC123",
  "side": "BUY",
  "instrument_id": 2562519737567269,
  "instrument_uuid": "359f66d8-4235-47c3-9733-0fbfe2cfaa0a",
  "symbol": "BTC-PERP",
  "portfolio_id": 1724343681801273,
  "portfolio_uuid": "b80ec69b-1229-4bcf-a6a8-c506ffd74c20",
  "type": "LIMIT",
  "price": 20215.53,
  "stop_price": 20015.53,
  "stop_limit_price": 20015.53,
  "size": 1.5423,
  "tif": "GTC",
  "expire_time": "2023-03-16T23:59:53.000Z",
  "stp_mode": "AGGRESSING",
  "event_type": "TRADE",
  "event_time": "2023-03-16T23:59:53.000Z",
  "submit_time": "2023-03-16T23:59:53.000Z",
  "order_status": "WORKING",
  "leaves_qty": "<string>",
  "exec_qty": "<string>",
  "avg_price": "<string>",
  "fee": "<string>",
  "post_only": true,
  "close_only": true,
  "algo_strategy": "TWAP",
  "text": "client cancel"
}
  • Java
  • .NET
  • Go
  • Python
  • TS/JS
  • CLI
OrdersService ordersService = IntxServiceFactory.createOrdersService(client);
ModifyOrderRequest request = new ModifyOrderRequest.Builder()
    .id("order_id")
    .build();
ModifyOrderResponse response = ordersService.modifyOrder(request);
For more information, please visit the INTX Java SDK.

Authorizations

​
CB-ACCESS-KEY
string
header
required
​
CB-ACCESS-PASSPHRASE
string
header
required
​
CB-ACCESS-SIGN
string
header
required
​
CB-ACCESS-TIMESTAMP
string
header
required

Path Parameters

​
id
string
required

Body

application/json
​
client_order_id
string<uuid>
required
​
portfolio
string<uuid>
required
​
price
string
​
stop_price
string
​
size
string
​
stop_limit_price
string

Response

​
order_id
string
Example:
​
client_order_id
string
Example:
​
side
enum<string>
Available options:
BUY,
SELL
Example:
​
instrument_id
string
Example:
​
instrument_uuid
string<uuid>
Example:
​
symbol
string
Example:
​
portfolio_id
string<string>
Example:
​
portfolio_uuid
string<uuid>
Example:
​
type
enum<string>
Available options:
LIMIT,
MARKET,
STOP_LIMIT,
STOP,
TAKE_PROFIT_STOP_LOSS
Example:
​
price
string
Example:
​
stop_price
string
Example:
​
stop_limit_price
string
Example:
​
size
string
Example:
​
tif
enum<string>
Available options:
GTC,
IOC,
GTT,
FOK
Example:
​
expire_time
string<date-time>
Example:
​
stp_mode
enum<string>
Available options:
NONE,
AGGRESSING,
RESTING,
BOTH,
DECREMENT_AND_CANCEL
Example:
​
event_type
enum<string>
Available options:
NEW,
TRADE,
CANCELED,
REPLACED,
PENDING_CANCEL,
REJECTED,
PENDING_NEW,
EXPIRED,
PENDING_REPLACE,
STOP_TRIGGERED
Example:
​
event_time
string<date-time>
Example:
​
submit_time
string<date-time>
Example:
​
order_status
enum<string>
Available options:
WORKING,
DONE
Example:
​
leaves_qty
string
​
exec_qty
string
​
avg_price
string
​
fee
string
​
post_only
boolean
​
close_only
boolean
​
algo_strategy
enum<string>
Available options:
TWAP
Example:
​
text
string
Example: