Create order

POST

api

orders

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"
}

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.

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.

var ordersService = new OrdersService(client);
var request = new CreateOrderRequest(
    Instrument: "BTC-PERP",
    Side: "BUY",
    Size: "0.0001",
    OrderType: "LIMIT",
    Price: "50000",
    Tif: "GTC",
    ClientOrderId: "1234567890",
);
var response = ordersService.CreateOrder(request);

For more information, please visit the INTX .NET SDK.

ordersSvc := orders.NewOrdersService(client)
request := &orders.CreateOrderRequest{
    Instrument: "BTC-PERP",
    Side: "BUY",
    Size: "0.0001",
    OrderType: "LIMIT",
    Price: "50000",
    Tif: "GTC",
    ClientOrderId: "1234567890",
}
response, err := ordersSvc.CreateOrder(context.Background(), request)

For more information, please visit the INTX Go SDK.

client = IntxClient()
request = CreateOrderRequest(
    instrument="BTC-PERP",
    side="BUY",
    size="0.0001",
    order_type="LIMIT",
    price="50000",
    tif="GTC",
    client_order_id="1234567890",
)
response = client.create_order(request)

For more information, please visit the INTX Python SDK.

const ordersService = new OrdersService(client);

ordersService.getOrder({
    clientOrderId: 'CLIENT_ORDER_ID_HERE',
    instrument: 'ETH-PERP',
    side: OrderSide.BUY,
    size: '0.001',
    orderType: OrderType.LIMIT,
    tif: TimeInForce.GTC,
    price: '4000',
}).then(async (response) => {
    console.log('Order Created: ', response);
})

For more information, please visit the INTX TS SDK.

intxctl create-order --help

For more information, please visit the INTX CLI.

Authorizations

CB-ACCESS-KEY

string

header

required

The Client ID that owns the API Key for the request

CB-ACCESS-PASSPHRASE

string

header

required

The pass phrase affiliated with the API Key

CB-ACCESS-SIGN

string

header

required

A HMAC SHA-256 signature using the API Key secret on the string TIMESTAMP, METHOD, REQUEST_PATH, BODY

CB-ACCESS-TIMESTAMP

string

header

required

The timestamp of when the request is being made

Body

application/json

Response

200

application/json

Order submitted

The response is of type object.

Cancel orders

Get order details

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"
}

REST API

FIX API

WEBSOCKET FEED

Authorizations

Body

Response