Bybit perpetuals command reference

Autoview · Reference

This is the full reference for writing Bybit perpetual orders from an Autoview alert, using e=BYBIT. The perpetual surface is the richest of any exchange Autoview supports, with one-order brackets, conditional entries, trailing stops, and leverage. It goes parameter by parameter and order type by order type, and for each one it shows the exact order Bybit resolves, not just the command you type. If you trade Bybit spot instead, that is a smaller surface with its own page: the Bybit spot command reference.

How Autoview reads a command

A command is a single line of key=value tokens separated by spaces. e=BYBIT s=BTCUSDT b=sell t=market q=0.001 is five tokens. The order you write them in does not matter.

• First occurrence wins. If a key appears twice, Autoview keeps the first and ignores the rest. Write each key once.
• A line starting with // is a comment and places nothing. Useful for labelling an alert without triggering a trade.
• You can send several commands at once by separating them with a new line or a pipe (|). Each is parsed on its own.
• A token that starts with a colon is ignored. TradingView sometimes inserts placeholder tokens like :plot_0=; Autoview skips anything with a leading colon so those never affect the order.

Four tokens matter for every order: e=BYBIT (the perpetual product line), s= (the symbol), b= (the side), and q= (the size). The size is not optional in practice. Read the sizing section before you send a real order.

The parameter table

These are the parameters Bybit perpetuals read, grouped by what they do.

Routing and identity

Direction and size

Order type and price

Trigger source and mode

Margin and modifiers

Cancelling, closing, and wallets

Order types and what each resolves to

Here is each order type with the command on the left and the order Bybit actually built on the right. The resolved time-in-force is the useful part: it shows that a market order runs as immediate-or-cancel, that t=post becomes a limit with a post-only flag, and so on.

Bybit gives you both immediate-or-cancel and fill-or-kill, which not every exchange does. The next sections cover the parts that make the perpetual surface the richest one.

The one-order bracket: attached stop and target

This is the feature that sets Bybit apart, and the one to read carefully if you have used another exchange. On Bybit perpetuals a stop-loss and a take-profit ride along on the entry order itself. You send one order, and the stop and the target are attached to the position it opens. The side does not flip.

Conditional entries

A conditional entry waits for the price to reach a trigger before it places. You add fpx= (absolute) or px= (relative) to a market or limit order, and the side stays as you wrote it, because this is an entry, not an exit.

Use a conditional entry to enter on a breakout or a break-down, where you want the order to wait until the market confirms the move.

Trailing stops

A trailing stop follows the price by a fixed distance and locks in gains as the position moves your way. fts= sets the distance, and ftsx= sets the price the trail starts following from.

Trigger price source: last, index, mark

Every trigger on Bybit can watch one of three prices, and you choose which. The default is the last traded price. The index price is an average across exchanges, and the mark price is the one Bybit uses for liquidation, so it is steadier than the last trade.

pxs= sets the source for an entry trigger, sls= for a stop, and tps= for a target. Watching the index or mark price helps a trigger ignore a brief wick on a single venue.

Sizing: base units, percent, and notional

q= sets the size, and it reads three ways.

• A plain number is base units. q=0.001 is 0.001 BTC on BTCUSDT, passed straight through.
• A percent is a share of your balance, sized at the current price. q=50% commits half of the relevant balance.
• With u=currency, the number is a notional amount in the quote currency. q=100 u=currency commits about 100 USDT, which Bybit converts to a sub-one BTC quantity at the current price.

Margin and modifiers

l=0 selects cross margin. hedge=1 tags an order to the matching side when the symbol is in hedge mode, where a long and a short can be held at once.

Cancelling and closing

How you close depends on what you are closing. You cancel resting orders, and you close a position.

There is no c=all on Bybit. Cancel orders with c=order and close a position with c=position. When you have several resting orders, cm= and cmo= act on a subset: cm= is how many (a count or a percent) and cmo= is which ones, by newest, oldest, and so on.

Moving balances between wallets

Bybit keeps balances in account types, and a command can move balance between them. w= names the coin and y= names the destination.

e=BYBIT w=USDT y=UNIFIED q=1

That moves 1 USDT into the unified account. The amount follows the same rules as an order size, so set it explicitly.

What Bybit does not accept

A few things look like they should work and do not. Knowing them saves a debugging session.

• No attached stop-limit or target-limit. The plain attached stop (fsl=) and target (ftp=) work, but the limit-price variants do not register, so the stop and target run as triggers, not as resting limits.
• No c=all. Cancel orders with c=order and close a position with c=position.
• One command, one account. You cannot list several accounts with a=acct1,acct2; send a separate command per account.

If you trade spot, note that most of the perpetual surface above does not carry over: conditional entries do, while brackets, trailing stops, and leverage stay perpetual-only. See the Bybit spot command reference for what spot accepts and what it quietly drops.

Testing and going live

Append d=1 to any command and Autoview parses it, reports what it would have done, and places nothing:

e=BYBIT s=BTCUSDT b=sell t=market q=0.001 d=1

That is the safest first run for a command you have just written. Read the log, confirm the symbol and side are right and the size is what you meant, then drop d=1 to send it for real. Bybit orders are real money from the first fill on the live exchange, so keep your first live size small and grow it once the alert behaves. For more on reading the log, see test and debug your setup.

Bybit spot command reference