Vertex Docs
  • Getting Started
    • 📋Overview
    • 📜Table of Contents
    • 🚀Mission
    • ⚔️Vertex Edge
      • 1️⃣Vertex on Arbitrum
      • 2️⃣Blitz on Blast
        • Blitz Documentation
      • 3️⃣Vertex on Mantle
        • 🎆Trading Rewards
        • 📊Perpetual & Spot Market Specifications
        • 🖥️Open-Source Contracts
        • 🔌API
      • 4️⃣Vertex on Sei
        • 💰Trading Rewards
        • 📊Perpetual & Spot Market Specifications
        • 🖥️On-Chain Contracts
        • 🔌API
      • 5️⃣Vertex on Base
        • 💰Trading Rewards
        • 📊Perpetual & Spot Market Specifications
        • 💻Onchain Contracts
        • 🔌API
        • ✍️Create a Coinbase Smart Wallet
      • 6️⃣Vertex on Sonic
        • 💰Trading Rewards
        • 📊Perpetual & Spot Market Specifications
        • ⛓️On-Chain Contracts
        • 🔌API
      • 7️⃣Vertex on Abstract
        • 📊Market Specifications
        • ⛓️On-Chain Contracts
        • 🔌API
      • 8️⃣Bro.Trade on Berachain
        • ⛓️On-Chain Contracts
        • 🔌API
      • 9️⃣Vertex on Avalanche
        • 💰Trading Rewards
        • 📊Market Specifications
        • ⛓️On-Chain Contracts
        • 🔌API
  • Basics
    • 📽️Products
    • ⚡Technical Architecture
    • 🧵Universal Cross Margin
    • ✂️Isolated Margin
    • ℹ️Subaccounts & Health
    • ⏰Liquidations & Insurance Fund
    • 💵PnL Settlements
    • 📊Pricing (Oracles)
    • 💰Fees
    • 📈Funding Rates
    • 📅Market Specifications
    • ⚡One-Click Trading
    • 🔫Trigger Orders
    • 🗂️GMCI 30 & MEME Indices
    • 💰Trade & Earn
      • 🤝Maker Program
      • 🔁Cross-Chain VRTX Rewards
      • ❓Trading Rewards - FAQs
    • 🧑‍🤝‍🧑Referral Program
    • ⚒️Resources & Links
    • ❔FAQs
  • VRTX Token
    • 🎓VRTX Tokenomics
    • 📊Token Supply Distribution
  • More
    • 🌐Glossary
    • 🔬Contracts & Code Audits
    • 🦋Bug Bounties
    • 💽Data & Research
    • 🪟Maintenance Windows
    • 🏁Terms of Use
    • ✍️Statement of Risk
    • 🌍Restricted Territories
    • 📸Brand Assets
  • Tutorials
    • 🏁Quick Start
    • 🖱️One-Click Trading
    • ⚙️Trading Basics
    • ♾️Perpetuals
    • 🔮Spot
    • 🧑‍🤝‍🧑Multiple Accounts
    • 🔫TP/SL & Stop-Market
    • 💰Withdrawals
    • ⚡Fast Withdrawals
    • 🌉Cross-Chain Deposits
    • 🔄Lend, Borrow & Repay
    • ❤️Margin Health
    • 💧Pools
    • 💫VRTX Staking
    • ↔️Switching Chains
    • 🪙Trading Rewards
    • ✂️Shortcuts
  • Developer Resources
    • API
      • 🔌Endpoints
      • Gateway
        • Executes
          • Place Order
          • Place Isolated Order
          • Cancel Orders
          • Cancel Product Orders
          • Cancel And Place
          • Withdraw Collateral
          • Transfer Quote
          • Liquidate Subaccount
          • Mint LP
          • Burn LP
          • Link Signer
        • Queries
          • Status
          • Contracts
          • Nonces
          • Order
          • Orders
          • Subaccount Info
          • Isolated Positions
          • Market Liquidity
          • Symbols
          • All Products
          • Edge All Products
          • Market Prices
          • Max Order Size
          • Max Withdrawable
          • Max LP Mintable
          • Fee Rates
          • Health Groups
          • Linked Signer
          • Insurance
          • Min Deposit Rates
        • Signing
          • Examples
          • Q&A
      • Subscriptions
        • Authentication
        • Streams
        • Events
        • Rate limits
      • Archive (indexer)
        • Orders
        • Matches
        • Events
        • Summary
        • Candlesticks
        • Edge Candlesticks
        • Funding Rate
        • Interest & funding payments
        • Oracle Price
        • Perp Prices
        • Product Snapshots
        • Market Snapshots
        • Edge Market Snapshots
        • Maker Statistics
        • Merkle Proofs
        • Rewards
        • Referral Code
        • Liquidation Feed
        • Linked Signer Rate Limit
        • Subaccounts
        • Signatures
        • USDC Price
      • Trigger
        • Executes
          • Place Order
          • Cancel Orders
          • Cancel Product Orders
        • Queries
          • List Trigger Orders
      • V2
        • Assets
        • Pairs
        • APR
        • Orderbook
        • Tickers
        • Contracts
        • Trades
        • VRTX Token
      • Rate limits
      • Errors
      • Symbols
      • Depositing
      • Withdrawing (on-chain)
      • Integrate via Smart Contracts
      • Definitions / Formulas
    • Vertex Typescript SDK
      • Getting Started
      • How To
        • Create a Vertex client
        • Useful Common Functions
        • Query Markets & Products
        • Deposit Funds
        • Withdraw Funds
        • Manage Orders
      • User Guide
        • Client
          • Market
            • Place Order
            • Cancel Orders
            • Cancel Product Orders
            • Mint LP
            • Burn LP
            • Get All Markets
            • Get Latest Market Price
            • Get Market Liquidity
            • Get Open Subaccount orders
            • Get Historical Orders
            • Get Max Order Size
            • Get Max Mint LP
            • Get Candlesticks
            • Get Funding Rate
            • Get Product Snapshots
          • Spot
            • Approve Allowance
            • Deposit
            • Withdraw
            • Get Max Withdrawable
            • Get Token Contract for Product
            • Get Token Wallet Balance
            • Get Token Allowance
          • Perp
            • Get prices
          • Subaccount
            • Link Signer
            • Get Subaccount Linked Signer with Rate limits
            • Get Subaccount Summary
            • Get Subaccount Fee Rates
            • Get Subaccount Token Rewards
        • Engine Client
          • Executes
          • Queries
        • Indexer Client
          • Base Queries
          • Paginated Queries
        • Websocket
          • Executes
          • Queries
          • Subscriptions
        • Utilities
          • Contracts
          • Utils
      • API Reference
    • Vertex Python SDK
    • Vertex Rust SDK
    • Contracts
    • API/SDK Terms of Use
Powered by GitBook
On this page
  • Summary
  • Example: Stop-Market Order
  • Trigger Orders on Vertex
  • How Trigger Orders Work
  • Types of Trigger Orders
  • Stop-Market Orders
  • Take Profit (TP) Orders
  • Stop-Loss (SL) Orders
Export as PDF
  1. Basics

🔫Trigger Orders

Learn about conditional order types like Stop-Loss (SL) and Take-Profit (TP) on Vertex.

PreviousOne-Click TradingNextGMCI 30 & MEME Indices

Last updated 4 months ago

Summary

A trigger order, otherwise known as a conditional order, is a type of order placed with an explicit condition that must be met before the order is executed. These orders are set to automatically trigger a buy or sell action when the market reaches a specific price level, known as the trigger price.

Trigger orders can be beneficial for active traders, as they allow for predetermined entry and exit points based on market movements without the need for constant monitoring. As a result, trigger orders function as a key tool for risk management, applying conditional-based price event thresholds to managing open orders -- based on a given trader's preferences.

It's important to note that trigger orders do not guarantee trade execution at a specific price, especially in volatile markets where prices may change rapidly.

Trigger orders are common in both TradFi and crypto markets. For example, some of the most popular trigger orders include:

  • Stop-Market Orders: These are orders placed to buy or sell once the market reaches a specified price, known as the stop price. Once the stop price is reached, the order is triggered and becomes a market order to buy or sell at the best available price. Stop-market orders are not linked to existing (e.g., open) positions.

  • Stop-Loss Orders: Stop-loss orders are designed to limit potential losses by automatically triggering a market order when the price of an asset reaches a certain level. Stop-loss orders are linked to existing (i.e., open) positions.

  • Take Profit Orders: These orders are placed to automatically buy / sell an asset once it reaches a certain profit level. When the market price hits the specified take profit price, the order is triggered and becomes a market order to buy / sell. Take profit orders are linked to existing (i.e., open) positions.


Example: Stop-Market Order

Imagine you're a Bitcoin (BTC) trader and you've noticed a pattern that whenever BTC's price drops to $50,000, it tends to bounce back up. You want to take advantage of this trend but don't want to sit in front of your computer 24/7 waiting for the BTC price to hit the $50,000 mark.

So, you decide to set a stop-market order with a trigger price of $50,000.

If the current price of BTC is $55,000 and you set a stop-market order to buy at $50,000, once BTC''s price reaches the $50,000 price, your market buy order will be triggered automatically.

Here's how it works:

  1. BTC's price starts at $55,000.

  2. You place a stop-market order to buy 1 BTC at the $50,000 trigger price.

  3. BTC's price drops to $50,000.

  4. Your stop-market order is triggered, and it becomes a market order to buy 1 BTC at the best available price around $50,000.

Using a stop-market order, traders can capitalize on the expected upward trend without constantly monitoring the price. Notably, stop-market orders are not linked to existing, open positions -- they are new orders to buy / sell an asset at a prescribed price level.

Bear in mind that if the market is highly volatile or experiences a sudden drop, the execution price might differ from the trigger price.


Trigger Orders on Vertex

Traders can make use of trigger order types on Vertex to maximize their trading experience.

Let's examine how trigger orders work on Vertex in more detail.

How Trigger Orders Work

Trigger orders are sent to Vertex's trigger order service. If the trigger price level is reached, the order will automatically be executed on behalf of the user.

As a result, One-Click Trading mode switched to ON is required to use trigger orders on Vertex.

Types of Trigger Orders

Vertex currently supports the following trigger order types:

  • Stop-Market Orders

  • Take Profit Orders

  • Stop-Loss Orders

Type
How to place
Direction/Size

Stop-Market

Order Entry -- Beside "Limit"

Trader sets the order like a normal trade.

Take Profit

Click on + add on "Open Position"

The same size but in the opposite direction of existing position.

Stop-Loss

Click on + add on "Open Position"

The same size but the opposite direction of existing position.

Vertex cannot guarantee that a trigger order will execute.

Stop-Market Orders

A stop-market order on Vertex enables you to set a trigger price, that once reached, will execute a market order for the direction and size of your order.

  • Stop-market orders can be placed the same way that Market and Limit orders are placed on the trading page.

  • Stop-market orders are new orders that are NOT linked to an existing position.

  • Stop-market orders will only be triggered if the Last Price for the market reaches the trigger price and if the order can fully fill (see slippage).

  • A stop-market order will NOT auto-cancel if you add or reduce a position's size for that market

  • Stop-market orders are Fill or Kill (FoK) -- meaning that if the order does not fill entirely, it will be canceled. There are no partial fills.

For more details on placing and managing stop-market orders, please refer to the tutorial here.

Slippage Tolerance for stop-market orders is configurable under the "Settings" button on the trading panel. In the case where a stop-market order can't fill the full order amount, the order will fail to execute.

Take Profit (TP) Orders

Orders that are placed to automatically close / exit a position a profitable position once it reaches a certain price level. For example, if a long BTC position is in profit and the market price hits the specified take profit (TP) price set by the trader, then the order is triggered and becomes a market order to sell BTC at the prescribed price.

  • Take Profit (TP) orders can be placed for existing (i.e., open) perpetual positions.

  • Users can select whether they want to base the trigger price on the Mark Price or Last Price.

    • Oracle Price: Oracle price from other exchanges.

    • Last Price: Last-traded price on Vertex.

  • TP orders can only be set for the entire notional size of an existing position.

  • TP orders execute in the opposite direction of the existing position to which they are applied.

  • TP orders are Fill or Kill (FoK) -- meaning that if the order does not fill entirely, it will be canceled. There are no partial fills.

For more details on placing and managing take profit orders, please refer to the tutorial here.

Slippage Tolerance for take profit (TP) orders is configurable under the "Settings" button on the trading panel. In the case where a TP order can't fill the full amount, the order will fail to execute.

Stop-Loss (SL) Orders

Stop-loss (SL) orders are designed to limit potential losses by automatically triggering a an order to close / exit an open position when the price of an asset reaches a certain level. SL orders are a highly popular tool for managing risk when trading, often functioning as a means to cut losses on a bad trade and defend a position from liquidation.

  • Stop Loss (SL) orders can be placed for existing (i.e., open) perpetual positions.

  • SL orders are classified as "Taker" orders as they take existing liquidity from the orderbook to fill the market order at the best available price.

  • Users can select whether they want to base the trigger on the Mark Price or Last Price.

    • Oracle Price: Oracle price from other exchanges.

    • Last Price: Last-traded price on Vertex.

  • Can only be set for the entire notional size of an existing position.

  • SL orders execute in the opposite direction of the existing position to which they are applied.

  • SL orders are Fill or Kill (FoK) -- meaning that if the order does not fill entirely, it will be canceled. There are no partial fills.

For more details on placing and managing stop-loss orders, please refer to the tutorial here.

Slippage Tolerance for stop-loss (SL) orders is configurable under the "Settings" button on the trading panel. In the case where a SL order can't fill the full amount, the order will fail to execute.

Tool-tips on the Vertex app will inform users about the details of a given trigger order type, including slippage tolerance parameters, before placing an order.

*Vertex users are advised to monitor their trigger orders and manage their risk accordingly.


TP orders are classified as "" orders as they take existing liquidity from the orderbook to fill the market order at the best available price.

Learn About Different Order Types on Vertex
Taker
Page cover image