Replace Order

post

https://api.bitfinex.com/v1/order/cancel/replace

Replace an order with a new one. Can be used to replace an order with a new margin, exchange, or derivative order.

📘
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]	A randomly generated ID for the order and the information given by /order/status.

Ratelimit: 450 req/min

Form Data

order_id

int64

required

The order ID given by /order/new.

symbol

string

The name of the symbol (see /symbols).

amount

string

Order size: how much to buy or sell.

price

string

Price to buy or sell at. May omit if a market order.

exchange

string

“bitfinex”

side

string

Either “buy” or “sell”.

type

string

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

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_remaining

boolean

Defaults to false

True if the new order should use the remaining amount of the original order.

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