Skip to main content
POST
/
api
/
v1
/
orders
Create order
curl --request POST \
  --url https://api.international.coinbase.com/api/v1/orders \
  --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": "<string>",
  "side": "BUY",
  "size": "<string>",
  "tif": "GTC",
  "instrument": "<string>",
  "type": "LIMIT",
  "price": "<string>",
  "stop_price": "<string>",
  "stop_limit_price": "<string>",
  "expire_time": "2023-11-07T05:31:56Z",
  "portfolio": "<string>",
  "stp_mode": "AGGRESSING",
  "post_only": true,
  "close_only": true,
  "algo_strategy": "TWAP"
}'
{
  "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);
CreateOrderRequest request = new CreateOrderRequest.Builder()
    .instrument("BTC-PERP")
    .side("BUY")
    .size("0.0001")
    .orderType("LIMIT")
    .price("50000")
    .tif("GTC")
    .clientOrderId("1234567890")
    .build();
CreateOrderResponse response = ordersService.createOrder(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

Body

application/json
​
client_order_id
string
required
​
side
enum<string>
required
Available options:
BUY,
SELL
Example:
​
size
string
required
​
tif
enum<string>
required
Available options:
GTC,
IOC,
GTT,
FOK
Example:
​
instrument
string
required
​
type
enum<string>
required
Available options:
LIMIT,
MARKET,
STOP_LIMIT,
STOP,
TAKE_PROFIT_STOP_LOSS
Example:
​
price
string
​
stop_price
string
​
stop_limit_price
string
​
expire_time
string<date-time>
​
portfolio
string
​
stp_mode
enum<string>
Available options:
NONE,
AGGRESSING,
RESTING,
BOTH,
DECREMENT_AND_CANCEL
Example:
​
post_only
boolean
​
close_only
boolean
​
algo_strategy
enum<string>
Available options:
TWAP
Example:

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: