Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vela.monolithsystematic.com/llms.txt

Use this file to discover all available pages before exploring further.

Vela supports two order types: Limit and Market. Both types can be combined with any Time in Force setting to control execution behavior.
A limit order specifies both the quantity and the maximum price you are willing to pay (buy) or the minimum price you are willing to accept (sell).Key properties:
  • Will only execute at your specified price or better
  • Rests in the order book if it cannot fill immediately (with GTC)
  • Provides price certainty — you know the worst-case execution price
  • May not fill immediately, or at all, if the market doesn’t reach your price
When to use limit orders:
  • When the exact execution price matters to you
  • When you want to enter or exit a position at a specific level
  • When you are a market maker providing liquidity (combine with Post-Only TIF)
  • When market impact is a concern and you want to avoid paying the spread
Example — Limit Buy: You want to buy 1 ETH but only at 3,200 USDC or lower. You place a limit buy at 3200 for 1 ETH. If the best ask is currently 3250, your order rests in the book. When a seller is willing to sell at 3200 or below, your order fills.Example — Limit Sell: You hold 2 ETH and want to sell if the price rises to 3,500 USDC. You place a limit sell at 3500 for 2 ETH. The order rests until a buyer arrives at that price or better.

Comparison

FeatureLimitMarket
Price controlYes — specify max/min priceNo — takes best available
Guaranteed executionNo — may not fillYes — fills or cancels
Rests in bookYes (with GTC)No — immediate only
Slippage riskNone (or bounded)Present on thin markets
Compatible TIFGTC, IOC, FOK, Post-OnlyIOC only (implicit)
Maker eligibleYesNo — always taker

Order Type and Fees

Market makers (limit orders that rest in the book) receive a different fee treatment than market takers (market orders and aggressive limit orders that immediately match). See Fees and Rebates for the full fee schedule.
Using Post-Only Time in Force with a limit order guarantees you will always be a maker. The order is rejected if it would match immediately, protecting you from accidentally paying taker fees.

Fixed-Point Price and Quantity

Prices and quantities submitted via the API are integers in fixed-point format scaled by 1,000,000:
Human-readableAPI value
3200.00 USDC3200000000
0.5 ETH500000
0.001 BTC1000
The UI handles this conversion automatically. If you’re using the API directly, see API Reference for encoding details.