Place Order

Create a new trading order with specified parameters such as symbol, side, order type, and quantity or amount.

Endpoint

POST /v1/trade/order

This endpoint allows users to submit a new order on the Flipster trading platform. It supports both market and stop-market (trigger) order types, with additional flags to control margin behavior and position management.

Requires authentication: Include api-key, api-expires, and api-signature headers.

Read-write permission required

Request Body

Schema

symbol	string	✅	Trading pair symbol (e.g., BTCUSDT.PERP)
side	string	✅	Order side — BUY or SELL
type	string	✅	Order type — MARKET or STOP_MARKET
reduceOnly	boolean		If true, the order will only reduce or close existing positions
price	string		Order price (only used for non-market orders)
amount	string		Notional order amount; use instead of quantity for quote-based orders
quantity	string		Order size in base asset units

Either amount or quantity must be provided, depending on trading symbol type.

Use reduceOnly: true when closing an existing position.

Response Body

Schema

order	object	Contains full details of the created order.

Order Object

orderId	string (UUID)	Unique identifier for the order
symbol	string	Symbol of the traded market
side	string	Side of the order (BUY, SELL)
orderType	string	Order type (MARKET, STOP_MARKET)
quantity	string	Ordered quantity
amount	string	Notional amount (if applicable)
price	string	Execution or trigger price
triggerPrice	string	Trigger price for stop-market orders
status	string	Order status — NEW, FILLED, PARTIALLY_FILLED, CANCELED, REJECTED
timeInForce	string	Execution policy (GTC, IOC, FOK)
takeProfitPrice	string	Optional take-profit price
stopLossPrice	string	Optional stop-loss price

Submit an 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

Precise, high-resolution integer type.

amountstring | nullableOptional

Precise, high-resolution integer type.

quantitystring | nullableOptional

Precise, high-resolution integer type.

maxSlippagePricestring | nullableOptional

Precise, high-resolution integer type.

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: 148

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

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