Orderly Network Trading

Trade perpetual futures on Orderly Network, an omnichain orderbook DEX built on unified liquidity. Supports both cryptocurrency pairs (169+ assets) and RWA commodities (Gold, Silver). Orders are signed using Ed25519 keys auto-provisioned via this agent's EVM wallet (Privy). Trades execute through Orderly's central limit orderbook with settlement on Arbitrum (or other supported EVM chains).

Available Markets

Orderly Network supports two asset categories:

Cryptocurrency Perpetuals (169+ pairs)

Major cryptocurrencies and altcoins tradable as perpetual futures:

• Major assets: BTC, ETH, SOL, AVAX, MATIC, NEAR, OP, ARB

• DeFi tokens: UNI, AAVE, SUSHI, CRV, COMP

• Layer-1/Layer-2: ATOM, DOT, ADA, FTM, MATIC

• Symbol format: PERP_<TOKEN>_USDC (e.g., PERP_BTC_USDC , PERP_ETH_USDC )

• Shorthand accepted: Use "BTC" instead of "PERP_BTC_USDC" — auto-expanded by tools

RWA Commodities (Launched Dec 2025)

Real-world asset commodities available for perpetual futures trading:

• Gold: $XAU or PERP_XAU_USDC — physical gold price tracking

• Silver: $XAG or PERP_XAG_USDC — physical silver price tracking

• Leverage: Up to 20x leverage available

• Pricing: Institutional-grade oracle feeds ensure real-world price accuracy

• Not tokenized: Direct on-chain exposure without wrapping or tokenization

Use orderly_futures() to get the complete real-time list of all available instruments.

Prerequisites

Before trading, the wallet policy must be active. Load the wallet-policy skill and propose the standard wildcard policy (deny key export + allow * ). This covers all Orderly operations — USDC deposits, vault interactions, account registration, and withdrawal signing.

Available Tools (19)

Public Tools (read-only, no auth)

Tool Description

orderly_system_info

System maintenance status

orderly_futures

Futures instrument info (tick sizes, lot sizes, max leverage)

orderly_funding

Funding rates (current + history)

orderly_volume

Volume statistics (24h volume, open interest)

orderly_orderbook

Orderbook snapshot (bids/asks with sizes)

orderly_kline

OHLCV candlestick data

orderly_market

Market overview (instruments + recent trades)

orderly_chain_info

Chain and broker configuration

Private Tools (require Ed25519 auth)

Tool Description

orderly_account

Account info (fees, tier, status)

orderly_holdings

Asset balances (available, frozen)

orderly_positions

Open positions (size, entry, PnL)

orderly_orders

List orders (open/completed/cancelled)

orderly_trades

Trade/fill history

orderly_liquidations

Liquidation history

Trading Tools (require Ed25519 auth)

Tool Description

orderly_order

Create order (LIMIT/MARKET/IOC/FOK/POST_ONLY)

orderly_modify

Edit existing order (price/quantity)

orderly_cancel

Cancel order by ID

orderly_cancel_all

Cancel all orders (optionally per symbol)

orderly_leverage

Update leverage for a symbol

Tool Usage Examples

Check System Status

orderly_system_info()

Check Futures Instruments

orderly_futures() # All instruments (crypto + RWA) orderly_futures(symbol="BTC") # BTC perp details orderly_futures(symbol="XAU") # Gold perp details orderly_futures(symbol="XAG") # Silver perp details

Check Orderbook

orderly_orderbook(symbol="BTC") orderly_orderbook(symbol="ETH", max_level=10) orderly_orderbook(symbol="XAU") # Gold orderbook orderly_orderbook(symbol="XAG", max_level=5) # Silver orderbook

Get Candles

orderly_kline(symbol="BTC", interval="1h", limit=100) orderly_kline(symbol="ETH", interval="4h", limit=200)

Intervals: 1m , 5m , 15m , 30m , 1h , 4h , 12h , 1d , 1w

Check Funding Rates

orderly_funding(symbol="BTC") # Current rate orderly_funding(symbol="BTC", history=true) # Current + history

Check Account Info

orderly_account()

Check Holdings

orderly_holdings()

Check Positions

orderly_positions()

Place a Limit Order

orderly_order(symbol="BTC", side="buy", quantity=0.01, price=95000) orderly_order(symbol="XAU", side="buy", quantity=1, price=2800) # Buy 1 oz Gold at $2,800 orderly_order(symbol="XAG", side="sell", quantity=10, price=32) # Sell 10 oz Silver at $32

Places a GTC limit buy for 0.01 BTC at $95,000.

Place a Market Order

orderly_order(symbol="ETH", side="sell", quantity=0.1, order_type="MARKET")

Place a Post-Only Order

orderly_order(symbol="BTC", side="buy", quantity=0.01, price=94000, order_type="POST_ONLY")

Rejected if it would immediately fill (maker only).

Close a Position

orderly_order(symbol="BTC", side="sell", quantity=0.01, reduce_only=true)

Use reduce_only=true to ensure it only closes, never opens a new position.

Cancel an Order

orderly_cancel(symbol="BTC", order_id=12345678)

Get order_id from orderly_orders .

Cancel All Orders

orderly_cancel_all() # Cancel everything orderly_cancel_all(symbol="BTC") # Cancel only BTC orders

Modify an Order

orderly_modify(order_id=12345678, symbol="BTC", side="buy", quantity=0.02, price=94500)

Set Leverage

orderly_leverage(symbol="BTC", leverage=10) orderly_leverage(symbol="ETH", leverage=5)

Check Order History

orderly_orders() # All open orders orderly_orders(symbol="BTC", status="INCOMPLETE") # Open BTC orders orderly_orders(status="COMPLETED", limit=20) # Recent filled orders

Check Trade History

orderly_trades() # All recent trades orderly_trades(symbol="BTC", limit=10) # Recent BTC trades

Common Workflows

Open a Perp Position

• orderly_market(symbol="BTC") — Check current price and instrument details

• orderly_leverage(symbol="BTC", leverage=5) — Set desired leverage

• orderly_order(symbol="BTC", side="buy", quantity=0.01, price=95000) — Place limit order

• orderly_orders(symbol="BTC", status="INCOMPLETE") — Verify order is live

• orderly_trades(symbol="BTC") — Check if filled

Close a Perp Position

• orderly_positions() — See current positions and sizes

• orderly_order(symbol="BTC", side="sell", quantity=0.01, order_type="MARKET", reduce_only=true) — Close with market order

• orderly_positions() — Verify position is closed

Market Research

• orderly_futures() — Scan all available instruments

• orderly_funding(symbol="BTC", history=true) — Check funding environment

• orderly_kline(symbol="BTC", interval="4h", limit=168) — 7-day price action

• orderly_orderbook(symbol="BTC") — Check liquidity depth

• orderly_volume() — Check aggregate volume stats

Trading RWA Commodities (Gold/Silver)

• orderly_futures(symbol="XAU") — Check Gold instrument details (min order size, tick size, leverage limits)

• orderly_market(symbol="XAU") — Get current Gold price and recent trades

• orderly_kline(symbol="XAU", interval="1h", limit=24) — 24-hour Gold price chart

• orderly_leverage(symbol="XAU", leverage=10) — Set 10x leverage for Gold trading

• orderly_order(symbol="XAU", side="buy", quantity=1, price=2800) — Buy 1 oz Gold at $2,800

• orderly_positions() — Check Gold/Silver positions

• orderly_order(symbol="XAU", side="sell", quantity=1, order_type="MARKET", reduce_only=true) — Close Gold position

RWA Trading Notes:

• Gold and Silver use same tools as crypto perpetuals

• Quantities in troy ounces (e.g., 1 = 1 oz Gold, 10 = 10 oz Silver)

• Pricing tracks real-world spot prices via institutional oracle feeds

• Up to 20x leverage available

• USDC settlement like all Orderly perps

Order Types

Type Parameter Behavior

Limit (GTC) order_type="LIMIT"

Rests on book until filled or cancelled

Market order_type="MARKET"

Fills at best available price immediately

IOC order_type="IOC"

Immediate-or-Cancel: fill what's available, cancel rest

FOK order_type="FOK"

Fill-or-Kill: fill entirely or cancel entirely

Post-Only order_type="POST_ONLY"

Rejected if it would cross the spread (maker only)

Add reduce_only=true to any order type to ensure it only closes existing positions.

Symbol Format

Orderly uses structured symbol names. You can use shorthand (just the coin name) and it auto-expands:

You type Expands to

"BTC"

"PERP_BTC_USDC"

"ETH"

"PERP_ETH_USDC"

"PERP_BTC_USDC"

passed through as-is

"SPOT_ETH_USDC"

passed through as-is

Full symbol format: {PERP|SPOT}{BASE}{QUOTE}

Risk Management

• Always check positions before trading — know your existing exposure and margin usage

• Set leverage explicitly before opening new positions

• Use reduce_only when closing to avoid accidentally opening the opposite direction

• Monitor funding rates — high positive funding means longs are expensive to hold

• Start with small sizes — check instrument details for minimum order sizes

• Post-only orders save on fees (maker vs taker rates)

• Check trades after market orders — market orders may get partial fills

Error Handling

Error Cause Fix

"Orderly API 400" Invalid request parameters Check symbol name, order type, and required fields

"Orderly API 401" Authentication failed Ed25519 key may have expired — restart triggers re-registration

"Orderly error" Business logic rejection Check error message for details (insufficient margin, invalid price, etc.)

"Not running on Fly" No wallet access Wallet signing only works on Fly.io deployment

"Orderly account not registered" Registration not complete Private/trading calls auto-register on first use

"No ethereum wallet found" Missing Privy wallet Ensure WALLET_SERVICE_URL is configured and wallet is provisioned

"Policy violation" / signing rejected Wallet policy doesn't allow required methods Load the wallet-policy skill and propose the standard wildcard policy (deny key export + allow * )