Place Order

Submits a new buy or sell order to the exchange for immediate or conditional execution, supporting Market, Limit, and Stop Market order types.

This endpoint is the primary method for executing trades. To place an order, the request must include the symbol (e.g., BTCUSDT.PERP), the side (BUY or SELL), and the order type (MARKET, LIMIT, or STOP_MARKET). Users should specify the size of the order by providing either the quantity (denominated in the base asset) or the amount (denominated in the quote asset).

For Limit orders, the price field allows users to set a specific execution price. Additionally, a priceMatchStrategy can be specified to define advanced matching behaviors for limit orders.

For risk management, the reduceOnly flag can be set to true to ensure the order only reduces an existing position and does not open a new one. A maxSlippagePrice can also be defined to protect against excessive price deviation during execution.

Request Body Example

• Market Buy Order (1 BTC Long)

This example demonstrates opening a Long position with a specific quantity (1 BTC) using a Market order.

{
  "symbol": "BTCUSDT.PERP",
  "side": "BUY",
  "type": "MARKET",
  "quantity": "1.0"
}

• Limit Sell Order (Fixed Price)

This example demonstrates placing a Limit order to Sell a specific value (e.g., 9,000 USDT worth) at a fixed price of 90,000. The system will calculate the corresponding base asset quantity (in this case, 0.1 BTC).

{
  "symbol": "BTCUSDT.PERP",
  "side": "SELL",
  "type": "LIMIT",
  "price": "90000",
  "quantity": "0.1"
}

• Limit Buy Order with BBO Strategy

This example demonstrates placing a Limit order where the price is automatically set to the current Best Bid or Offer (BBO) using the priceMatchStrategy, instead of specifying a fixed price.

{
  "symbol": "BTCUSDT.PERP",
  "side": "BUY",
  "type": "LIMIT",
  "quantity": "0.5",
  "priceMatchStrategy": "PRICE_MATCH_STRATEGY_COUNTERPARTY_1"
}

• Stop Market Buy Order

This example demonstrates placing a Stop Market order to enter a Long position (Buy) only when the price reaches or crosses 86,000. This is typically used to catch an upward trend breakout.

{
  "symbol": "BTCUSDT.PERP",
  "side": "BUY",
  "type": "STOP_MARKET",
  "price": "86000",
  "quantity": "0.1"
}

Response Body

Place Order

post

Required scopes

This endpoint requires the following scopes:

Authorizations

thirdPartyApiKeyAuth

api-keystringRequired

For third party retail API users

Body

application/json

symbolstringRequired

Trading symbol

Example: BTCUSDT.PERPPattern: ^[A-Z0-9]+(\.[A-Z0-9]+)?$

sidestring · enumRequired

Order side

Possible values:

typestring · enumRequired

Order type

Possible values:

reduceOnlybooleanOptionalDefault: false

pricestring · nullableOptional

the limit or trigger price for execution.

Example: ###.###

amountstring · nullableOptional

order size designated in base asset units (e.g., BTC amount)

Example: ###.###

quantitystring · nullableOptional

specifies the order size denominated in the base asset units (e.g., BTC for a BTCUSDT pair).

Example: ###.###

maxSlippagePricestring · nullableOptional

prevents the order from being executed at a price worse than this specified limit.

Example: ###.###

priceMatchStrategystring · enum · nullableOptional

Automatically sets the limit order price to the current Best Bid or Offer (BBO) when selected.

Possible values:

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

post

/api/v1/trade/order

HTTPcURLJavaScriptPython

POST /api/v1/trade/order HTTP/1.1
Host: trading-api.flipster.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 219

{
  "symbol": "BTCUSDT.PERP",
  "side": "BUY",
  "type": "MARKET",
  "reduceOnly": false,
  "price": "###.###",
  "amount": "###.###",
  "quantity": "###.###",
  "maxSlippagePrice": "###.###",
  "priceMatchStrategy": "PRICE_MATCH_STRATEGY_COUNTERPARTY_1"
}

{
  "order": {
    "orderId": "123e4567-e89b-12d3-a456-426614174000",
    "symbol": "BTCUSDT.PERP",
    "side": "BUY",
    "orderType": "MARKET",
    "quantity": "###.###",
    "amount": "###.###",
    "price": "###.###",
    "triggerPrice": "###.###",
    "status": "PENDING_NEW",
    "timeInForce": "FOK",
    "takeProfitPrice": "###.###",
    "stopLossPrice": "###.###",
    "leavesQty": "###.###"
  }
}