RULE CHANGE
Trading with the API
Added explanation of multi-venue instrument trading, including API endpoints, position rules, and limitations for TWAP and scaled orders.
What this means
Article now documents that GET /v1/markets returns default venues while GET /v1/markets?venues=all shows alternate venues with default_venue flags; traders can trade alternate venues by sending their market_id; accounts can hold an instrument on only one venue at a time, with orders rejected if they would open on a second venue while a position exists on another (venue_conflict error); TWAP and scaled orders use the default venue only. Execution price, margin calculation, and slippage reference rules stayed the same.
▸ View exact changes
What the page said before and after
Before Oct 21, 2026
| market | expected_price | slippage_tolerance_bps, attached TP/SL |
|---|---|---|
| limit | limit_price | attached TP/SL, IOC, FOK, or GTD time in force |
| chase | chase_offset | optional chase_cap_price |
| stop_market | trigger_price | attached TP/SL, or reduce-only protection |
| stop_limit | trigger_price, limit_price | opening conditional order, attached TP/SL |
| take_market | trigger_price | opening conditional order |
| take_limit | trigger_price, limit_price | opening conditional order |
| take_profit | trigger_price, reduce_only: true | position protection |
| conditional | trigger_price, trigger_market_id, trigger_direction | observe one market and execute on another |
The server resolves provider, symbol, and venue coin from market_id. Do not
send those fields. expected_price records what your client observed, but it
never controls the execution price, margin calculation, or slippage reference.
FX markets trade on veranta. Use their current market_id values from
GET /v1/markets. The previous hyperliquid EUR/USD and USD/JPY markets are
retiring: they accept only orders that reduce or close existing positions
there. The historical fpx and lighter providers are retired and have no
markets available for new trades.
Before placing a market order, request
GET /v1/markets/{market_id}/quote?side=buy&size=... to estimate the fill. A
size-aware quote returns the projected fill price (top-of-book bounded by the
mark-based slippage cap), the maximum adverse slippage tier in basis points
(slippage_bps), notional,
fee, and whether the requested size is valid at the market's precision. The
eventual order still executes against newer authoritative market data, so
After Oct 29, 2026
| market | expected_price | slippage_tolerance_bps, attached TP/SL |
|---|---|---|
| limit | limit_price | attached TP/SL, IOC, FOK, or GTD time in force |
| chase | chase_offset | optional chase_cap_price |
| stop_market | trigger_price | attached TP/SL, or reduce-only protection |
| stop_limit | trigger_price, limit_price | opening conditional order, attached TP/SL |
| take_market | trigger_price | opening conditional order |
| take_limit | trigger_price, limit_price | opening conditional order |
| take_profit | trigger_price, reduce_only: true | position protection |
| conditional | trigger_price, trigger_market_id, trigger_direction | observe one market and execute on another |
The server resolves provider, symbol, and venue coin from market_id. Do not
send those fields. expected_price records what your client observed, but it
never controls the execution price, margin calculation, or slippage reference.
+ Some instruments are listed on more than one venue. GET /v1/markets returns
+ each instrument's default venue; GET /v1/markets?venues=all also returns its
+ alternate venues, with default_venue: false. Trade an alternate venue by
+ sending its market_id, the same choice the trade page's venue switcher
+ offers. An account holds an instrument on one venue at a time: an order that
+ would open on a second venue while a position is open on another is rejected
+ with venue_conflict. Close the existing position first. TWAP and scaled
+ orders use the default venue.
FX markets trade on veranta. Use their current market_id values from
GET /v1/markets. The previous hyperliquid EUR/USD and USD/JPY markets are
retiring: they accept only orders that reduce or close existing positions
there. The historical fpx and lighter providers are retired and have no
markets available for new trades.
Before placing a market order, request
GET /v1/markets/{market_id}/quote?side=buy&size=... to estimate the fill. A
size-aware quote returns the projected fill price (top-of-book bounded by the
mark-based slippage cap), the maximum adverse slippage tier in basis points
(slippage_bps), notional,
fee, and whether the requested size is valid at the market's precision. The
eventual order still executes against newer authoritative market data, so
| market | expected_price | slippage_tolerance_bps, attached TP/SL |
|---|---|---|
| limit | limit_price | attached TP/SL, IOC, FOK, or GTD time in force |
| chase | chase_offset | optional chase_cap_price |
| stop_market | trigger_price | attached TP/SL, or reduce-only protection |
| stop_limit | trigger_price, limit_price | opening conditional order, attached TP/SL |
| take_market | trigger_price | opening conditional order |
| take_limit | trigger_price, limit_price | opening conditional order |
| take_profit | trigger_price, reduce_only: true | position protection |
| conditional | trigger_price, trigger_market_id, trigger_direction | observe one market and execute on another |
The server resolves provider, symbol, and venue coin from market_id. Do not
send those fields. expected_price records what your client observed, but it
never controls the execution price, margin calculation, or slippage reference.
+ Some instruments are listed on more than one venue. GET /v1/markets returns
+ each instrument's default venue; GET /v1/markets?venues=all also returns its
+ alternate venues, with default_venue: false. Trade an alternate venue by
+ sending its market_id, the same choice the trade page's venue switcher
+ offers. An account holds an instrument on one venue at a time: an order that
+ would open on a second venue while a position is open on another is rejected
+ with venue_conflict. Close the existing position first. TWAP and scaled
+ orders use the default venue.
FX markets trade on veranta. Use their current market_id values from
GET /v1/markets. The previous hyperliquid EUR/USD and USD/JPY markets are
retiring: they accept only orders that reduce or close existing positions
there. The historical fpx and lighter providers are retired and have no
markets available for new trades.
Before placing a market order, request
GET /v1/markets/{market_id}/quote?side=buy&size=... to estimate the fill. A
size-aware quote returns the projected fill price (top-of-book bounded by the
mark-based slippage cap), the maximum adverse slippage tier in basis points
(slippage_bps), notional,
fee, and whether the requested size is valid at the market's precision. The
eventual order still executes against newer authoritative market data, so