New Order

post

https://api.bitfinex.com/v1/order/new

Submit a new Order, can be used to create margin, exchange, and derivative orders.

📘
aff_code
API orders can now pass an affiliate code through which you can earn rebates. To learn more about these rebates and our affiliate program, please look at the relevant announcement and knowledge base article.

Response Details

Key	Type	Description
order_id	[int64]	An order object containing the order’s ID as well as all the information provided by /order/status

Ratelimit: 450 req/min

Form Data

symbol

string

required

The name of the symbol (see /symbols).

amount

string

required

Order size: how much you want to buy or sell

price

string

required

Price to buy or sell at. Must be positive. Use random number for market orders. Note: For 'trailing-stop' orders, the price represents the desired 'distance'

side

string

required

Either “buy” or “sell”.

type

string

required

Either “market” / “limit” / “stop” / "stop limit" / “trailing-stop” / “fill-or-kill” / "immediate-or-cancel" / “exchange market” / “exchange limit” / “exchange stop” / "exchange stop limit" / “exchange trailing-stop” / “exchange fill-or-kill” / "exchange immediate-or-cancel" . (type starting by “exchange ” are exchange orders, others are margin trading orders)

exchange

string

Defaults to "bitfinex"

buy_stoplimit_price

float

Specify the limit price on a stop limit buy or exchange stop limit buy order

sell_stoplimit_price

string

Specify the limit price on a stop limit sell or exchange stop limit sell order

is_hidden

boolean

Defaults to false

true if the order should be hidden.

is_postonly

boolean

Defaults to false

true if the order should be post only. Only relevant for limit orders.

use_all_available

int32

Defaults to 0

1 will post an order that will use all of your available balance.

ocoorder

boolean

required

Set an additional STOP OCO order that will be linked with the current order.

buy_price_oco

float

required

If ocoorder is true, this field represent the price of the OCO stop order to place

sell_price_oco

float

required

If ocoorder is true, this field represent the price of the OCO stop order to place

lev

int32

Defaults to 10

Set the leverage for a derivative order, supported by derivative symbol orders only. The value should be between 1 and 100 inclusive. The field is optional, if omitted the default leverage value of 10 will be used.

aff_code

string

Allows you to pass along an affiliate code with your API orders

Responses

aff_code

200200

400400