Create Order

POST

portfolios

{portfolio_id}

order

curl --request POST \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/order \
  --header 'Content-Type: application/json' \
  --data '{
  "product_id": "<string>",
  "side": "UNKNOWN_ORDER_SIDE",
  "client_order_id": "<string>",
  "type": "UNKNOWN_ORDER_TYPE",
  "base_quantity": "<string>",
  "quote_value": "<string>",
  "limit_price": "<string>",
  "start_time": "2023-11-07T05:31:56Z",
  "expiry_time": "2023-11-07T05:31:56Z",
  "time_in_force": "UNKNOWN_TIME_IN_FORCE",
  "stp_id": "<string>",
  "display_quote_size": "<string>",
  "display_base_size": "<string>",
  "is_raise_exact": true,
  "historical_pov": "<string>",
  "stop_price": "<string>",
  "settl_currency": "<string>"
}'

{
  "order_id": "ba0eb21c-672b-44de-8342-d6363cef87f0"
}

VWAP and TWAP

VWAP and TWAP orders must have a minimum notional of $100/hr and also include these additional parameters: limit_price, start_time and expiry_time.

Use the Prime SDK or CLI to test this endpoint by following the quickstart guide and running with the following examples

OrdersService ordersService = PrimeServiceFactory.createOrdersService(client);

CreateOrderRequest request = new CreateOrderRequest.Builder()
    .portfolioId("PORTFOLIO_ID_HERE")
    .productId("ADA-USD")
    .side(OrderSide.BUY)
    .type(OrderType.MARKET)
    .baseQuantity("10.0")
    .clientOrderId(UUID.randomUUID().toString())
    .build());
CreateOrderResponse orderResponse = ordersService.createOrder(request);

For more information, please visit the Prime Java SDK.

OrdersService ordersService = PrimeServiceFactory.createOrdersService(client);

CreateOrderRequest request = new CreateOrderRequest.Builder()
    .portfolioId("PORTFOLIO_ID_HERE")
    .productId("ADA-USD")
    .side(OrderSide.BUY)
    .type(OrderType.MARKET)
    .baseQuantity("10.0")
    .clientOrderId(UUID.randomUUID().toString())
    .build());
CreateOrderResponse orderResponse = ordersService.createOrder(request);

For more information, please visit the Prime Java SDK.

var ordersService = new OrdersService(client);

var request = new CreateOrderRequest("PORTFOLIO_ID_HERE")
{
    BaseQuantity = "5",
    LimitPrice = "0.32",
    Side = OrderSide.BUY,
    ProductId = "ADA-USD",
    Type = OrderType.LIMIT,
    ExpiryTime = new DateTimeOffset(DateTime.UtcNow.AddMinutes(5)).ToString("o"),
    ClientOrderId = Guid.NewGuid().ToString()
};

var createOrderResponse = orderService.CreateOrder(request);

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

ordersService := orders.NewOrdersService(client)

request := &orders.CreateOrderRequest{
    Order: &model.Order{
        PortfolioId:   "PORTFOLIO_ID_HERE",
        BaseQuantity:  "5",
        LimitPrice:    "0.32",
        Side:          "BUY",
        ProductId:     "ADA-USD",
        Type:          "LIMIT",
        ExpiryTime:    time.Now().UTC().Add(5 * time.Minute).Format(time.RFC3339),
        ClientOrderId: uuid.New().String(),
    },
}

response, err := ordersService.CreateOrder(context.Background(), request)

For more information, please visit the Prime Go SDK.

prime_client = PrimeClient(credentials)

request = CreateOrderRequest(
    portfolio_id="PORTFOLIO_ID_HERE",
    base_quantity="5",
    limit_price="0.32",
    side="BUY",
    product_id="ADA-USD",
    type="LIMIT",
    expiry_time=(datetime.datetime.now() + datetime.timedelta(minutes=5)).isoformat() + "Z",
    client_order_id=str(uuid.uuid4()),
)

response = prime_client.create_order(request)

For more information, please visit the Prime Python SDK.

primectl create-order --help

For more information, please visit the Prime CLI.

const ordersService = new OrdersService(client);
const today = new Date();

ordersService.createOrder({
    portfolioId: "PORTFOLIO_ID_HERE",
    baseQuantity: "5",
    limitPrice: "0.32",
    side: OrderSide.BUY,
    productId: "ADA-USD",
    type: OrderType.LIMIT,
    expiryTime: date.setDate(date.getDate() + 1),
    clientOrderId: uuidv4()
}).then(async (response) => {
    console.log('Order: ', response);
})

For more information, please visit the Prime TS SDK.

Path Parameters

portfolio_id

string

required

The ID of the portfolio that owns the order

Body

application/json

Response

200

application/json

A successful response.

The response is of type object.

Cancel Order

Create Quote Request

curl --request POST \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/order \
  --header 'Content-Type: application/json' \
  --data '{
  "product_id": "<string>",
  "side": "UNKNOWN_ORDER_SIDE",
  "client_order_id": "<string>",
  "type": "UNKNOWN_ORDER_TYPE",
  "base_quantity": "<string>",
  "quote_value": "<string>",
  "limit_price": "<string>",
  "start_time": "2023-11-07T05:31:56Z",
  "expiry_time": "2023-11-07T05:31:56Z",
  "time_in_force": "UNKNOWN_TIME_IN_FORCE",
  "stp_id": "<string>",
  "display_quote_size": "<string>",
  "display_base_size": "<string>",
  "is_raise_exact": true,
  "historical_pov": "<string>",
  "stop_price": "<string>",
  "settl_currency": "<string>"
}'

{
  "order_id": "ba0eb21c-672b-44de-8342-d6363cef87f0"
}

REST API

FIX API

Websocket Feed

Path Parameters

Body

Response