Back to Details

orderly

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Orderly Network Trading

Orderly Network 交易指南

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).
在Orderly Network上交易永续期货，这是一个基于统一流动性构建的全链订单簿DEX。支持加密货币交易对（169+种资产）和RWA商品（黄金、白银）。订单通过本Agent的EVM钱包（Privy）自动提供的Ed25519密钥进行签名。交易通过Orderly的中央限价订单簿执行，结算在Arbitrum（或其他支持的EVM链）上完成。

Available Markets

可用市场

Orderly Network supports two asset categories:
Orderly Network支持两类资产：

Cryptocurrency Perpetuals (169+ pairs)

加密货币永续合约（169+交易对）

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
可交易主流加密货币和山寨币的永续期货：
  • 主流资产：BTC、ETH、SOL、AVAX、MATIC、NEAR、OP、ARB
  • DeFi代币：UNI、AAVE、SUSHI、CRV、COMP
  • Layer-1/Layer-2：ATOM、DOT、ADA、FTM、MATIC
  • 符号格式：
    PERP_<TOKEN>_USDC
    （例如：
    PERP_BTC_USDC
    、
    PERP_ETH_USDC
    ）
  • 支持简写：可使用
    "BTC"
    代替
    "PERP_BTC_USDC"
    ——工具会自动扩展

RWA Commodities (Launched Dec 2025)

RWA商品（2025年12月上线）

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.
可进行永续期货交易的现实世界资产商品：
  • 黄金：
    $XAU
    或
    PERP_XAU_USDC
    ——追踪实物黄金价格
  • 白银：
    $XAG
    或
    PERP_XAG_USDC
    ——追踪实物白银价格
  • 杠杆：最高支持20倍杠杆
  • 定价：机构级预言机喂价确保与现实世界价格一致
  • 非代币化：直接链上敞口，无需封装或代币化
使用
orderly_futures()
获取所有可用工具的实时完整列表。

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.
交易前，钱包策略必须处于激活状态。加载wallet-policy技能并提交标准通配符策略（禁止密钥导出 + 允许
*
）。该策略覆盖所有Orderly操作——USDC存款、金库交互、账户注册和提款签名。

Available Tools (19)

可用工具（19种）

Public Tools (read-only, no auth)

公共工具（只读，无需授权）

ToolDescription
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
工具描述
orderly_system_info
系统维护状态
orderly_futures
期货工具信息（最小变动价位、合约规模、最大杠杆）
orderly_funding
资金费率（当前+历史）
orderly_volume
交易量统计（24小时交易量、持仓量）
orderly_orderbook
订单簿快照（买卖盘及规模）
orderly_kline
OHLCV蜡烛图数据
orderly_market
市场概览（工具+近期交易）
orderly_chain_info
链和经纪商配置

Private Tools (require Ed25519 auth)

私有工具（需Ed25519授权）

ToolDescription
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
工具描述
orderly_account
账户信息（手续费、等级、状态）
orderly_holdings
资产余额（可用、冻结）
orderly_positions
未平仓头寸（规模、入场价、盈亏）
orderly_orders
订单列表（未完成/已完成/已取消）
orderly_trades
交易/成交历史
orderly_liquidations
强平历史

Trading Tools (require Ed25519 auth)

交易工具（需Ed25519授权）

ToolDescription
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
工具描述
orderly_order
创建订单（限价/市价/IOC/FOK/只做市）
orderly_modify
编辑现有订单（价格/数量）
orderly_cancel
通过ID取消订单
orderly_cancel_all
取消所有订单（可按符号筛选）
orderly_leverage
更新指定符号的杠杆

Tool Usage Examples

工具使用示例

Check System Status

检查系统状态

orderly_system_info()
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
orderly_futures()                          # 所有工具（加密货币+RWA）
orderly_futures(symbol="BTC")              # BTC永续合约详情
orderly_futures(symbol="XAU")              # 黄金永续合约详情
orderly_futures(symbol="XAG")              # 白银永续合约详情

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
orderly_orderbook(symbol="BTC")
orderly_orderbook(symbol="ETH", max_level=10)
orderly_orderbook(symbol="XAU")            # 黄金订单簿
orderly_orderbook(symbol="XAG", max_level=5)  # 白银订单簿

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
orderly_kline(symbol="BTC", interval="1h", limit=100)
orderly_kline(symbol="ETH", interval="4h", limit=200)
时间间隔：
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
orderly_funding(symbol="BTC")                       # 当前费率
orderly_funding(symbol="BTC", history=true)          # 当前+历史费率

Check Account Info

查看账户信息

orderly_account()
orderly_account()

Check Holdings

查看资产余额

orderly_holdings()
orderly_holdings()

Check Positions

查看未平仓头寸

orderly_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.
orderly_order(symbol="BTC", side="buy", quantity=0.01, price=95000)
orderly_order(symbol="XAU", side="buy", quantity=1, price=2800)  # 以2800美元买入1盎司黄金
orderly_order(symbol="XAG", side="sell", quantity=10, price=32)  # 以32美元卖出10盎司白银
下达一个GTC（撤销前有效）限价买单，以95000美元买入0.01 BTC。

Place a Market Order

下达市价订单

orderly_order(symbol="ETH", side="sell", quantity=0.1, order_type="MARKET")
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).
orderly_order(symbol="BTC", side="buy", quantity=0.01, price=94000, order_type="POST_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.
orderly_order(symbol="BTC", side="sell", quantity=0.01, reduce_only=true)
使用
reduce_only=true
确保仅平仓，不会开立新头寸。

Cancel an Order

取消订单

orderly_cancel(symbol="BTC", order_id=12345678)
Get 
order_id
from 
orderly_orders
.
orderly_cancel(symbol="BTC", order_id=12345678)
从
orderly_orders
获取
order_id
。

Cancel All Orders

取消所有订单

orderly_cancel_all()                    # Cancel everything
orderly_cancel_all(symbol="BTC")        # Cancel only BTC orders
orderly_cancel_all()                    # 取消所有订单
orderly_cancel_all(symbol="BTC")        # 仅取消BTC订单

Modify an Order

修改订单

orderly_modify(order_id=12345678, symbol="BTC", side="buy", quantity=0.02, price=94500)
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)
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
orderly_orders()                                        # 所有未完成订单
orderly_orders(symbol="BTC", status="INCOMPLETE")        # BTC未完成订单
orderly_orders(status="COMPLETED", limit=20)             # 近期已成交订单

Check Trade History

查看交易历史

orderly_trades()                                # All recent trades
orderly_trades(symbol="BTC", limit=10)          # Recent BTC trades
orderly_trades()                                # 所有近期交易
orderly_trades(symbol="BTC", limit=10)          # BTC近期交易

Common Workflows

常见工作流

Open a Perp Position

开立永续合约头寸

  1. orderly_market(symbol="BTC")
    — Check current price and instrument details
  2. orderly_leverage(symbol="BTC", leverage=5)
    — Set desired leverage
  3. orderly_order(symbol="BTC", side="buy", quantity=0.01, price=95000)
    — Place limit order
  4. orderly_orders(symbol="BTC", status="INCOMPLETE")
    — Verify order is live
  5. orderly_trades(symbol="BTC")
    — Check if filled
  1. orderly_market(symbol="BTC")
    — 查看当前价格和工具详情
  2. orderly_leverage(symbol="BTC", leverage=5)
    — 设置所需杠杆
  3. orderly_order(symbol="BTC", side="buy", quantity=0.01, price=95000)
    — 下达限价订单
  4. orderly_orders(symbol="BTC", status="INCOMPLETE")
    — 验证订单已生效
  5. orderly_trades(symbol="BTC")
    — 检查是否成交

Close a Perp Position

平仓永续合约头寸

  1. orderly_positions()
    — See current positions and sizes
  2. orderly_order(symbol="BTC", side="sell", quantity=0.01, order_type="MARKET", reduce_only=true)
    — Close with market order
  3. orderly_positions()
    — Verify position is closed
  1. orderly_positions()
    — 查看当前头寸及规模
  2. orderly_order(symbol="BTC", side="sell", quantity=0.01, order_type="MARKET", reduce_only=true)
    — 使用市价订单平仓
  3. orderly_positions()
    — 验证头寸已平仓

Market Research

市场调研

  1. orderly_futures()
    — Scan all available instruments
  2. orderly_funding(symbol="BTC", history=true)
    — Check funding environment
  3. orderly_kline(symbol="BTC", interval="4h", limit=168)
    — 7-day price action
  4. orderly_orderbook(symbol="BTC")
    — Check liquidity depth
  5. orderly_volume()
    — Check aggregate volume stats
  1. orderly_futures()
    — 浏览所有可用工具
  2. orderly_funding(symbol="BTC", history=true)
    — 查看资金费率环境
  3. orderly_kline(symbol="BTC", interval="4h", limit=168)
    — 7天价格走势
  4. orderly_orderbook(symbol="BTC")
    — 查看流动性深度
  5. orderly_volume()
    — 查看总交易量统计

Trading RWA Commodities (Gold/Silver)

RWA商品交易（黄金/白银）

  1. orderly_futures(symbol="XAU")
    — Check Gold instrument details (min order size, tick size, leverage limits)
  2. orderly_market(symbol="XAU")
    — Get current Gold price and recent trades
  3. orderly_kline(symbol="XAU", interval="1h", limit=24)
    — 24-hour Gold price chart
  4. orderly_leverage(symbol="XAU", leverage=10)
    — Set 10x leverage for Gold trading
  5. orderly_order(symbol="XAU", side="buy", quantity=1, price=2800)
    — Buy 1 oz Gold at $2,800
  6. orderly_positions()
    — Check Gold/Silver positions
  7. 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
  1. orderly_futures(symbol="XAU")
    — 查看黄金工具详情（最小订单规模、最小变动价位、杠杆限制）
  2. orderly_market(symbol="XAU")
    — 获取当前黄金价格和近期交易
  3. orderly_kline(symbol="XAU", interval="1h", limit=24)
    — 24小时黄金价格图表
  4. orderly_leverage(symbol="XAU", leverage=10)
    — 为黄金交易设置10倍杠杆
  5. orderly_order(symbol="XAU", side="buy", quantity=1, price=2800)
    — 以2800美元买入1盎司黄金
  6. orderly_positions()
    — 查看黄金/白银头寸
  7. orderly_order(symbol="XAU", side="sell", quantity=1, order_type="MARKET", reduce_only=true)
    — 平仓黄金头寸
RWA交易注意事项：
  • 黄金和白银使用与加密货币永续合约相同的工具
  • 数量单位为金衡盎司（例如：1 = 1盎司黄金，10 = 10盎司白银）
  • 定价通过机构级预言机喂价追踪现实世界现货价格
  • 最高支持20倍杠杆
  • 与所有Orderly永续合约一样，使用USDC结算

Order Types

订单类型

TypeParameterBehavior
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.
类型参数行为
限价（GTC）
order_type="LIMIT"
留在订单簿上直到成交或取消
市价
order_type="MARKET"
立即以最优可用价格成交
IOC
order_type="IOC"
立即成交可用部分，剩余部分取消
FOK
order_type="FOK"
要么全部成交，要么全部取消
只做市
order_type="POST_ONLY"
如果会穿透买卖价差则被拒绝（仅做市）
在任何订单类型中添加
reduce_only=true
可确保仅平仓现有头寸。

Symbol Format

符号格式

Orderly uses structured symbol names. You can use shorthand (just the coin name) and it auto-expands:
You typeExpands 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}
Orderly使用结构化符号名称。你可以使用简写（仅代币名称），系统会自动扩展：
你输入的内容扩展后内容
"BTC"
"PERP_BTC_USDC"
"ETH"
"PERP_ETH_USDC"
"PERP_BTC_USDC"
直接保留
"SPOT_ETH_USDC"
直接保留
完整符号格式：
{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
  • 交易前务必检查头寸 — 了解你的现有敞口和保证金使用情况
  • 开立新头寸前明确设置杠杆
  • 平仓时使用reduce_only 避免意外开立反向头寸
  • 监控资金费率 — 高正资金费率意味着多头持仓成本高
  • 从小规模开始 — 查看工具详情了解最小订单规模
  • 只做市订单 可节省手续费（做市商费率 vs taker费率）
  • 市价订单成交后检查交易记录 — 市价订单可能部分成交

Error Handling

错误处理

ErrorCauseFix
"Orderly API 400"Invalid request parametersCheck symbol name, order type, and required fields
"Orderly API 401"Authentication failedEd25519 key may have expired — restart triggers re-registration
"Orderly error"Business logic rejectionCheck error message for details (insufficient margin, invalid price, etc.)
"Not running on Fly"No wallet accessWallet signing only works on Fly.io deployment
"Orderly account not registered"Registration not completePrivate/trading calls auto-register on first use
"No ethereum wallet found"Missing Privy walletEnsure WALLET_SERVICE_URL is configured and wallet is provisioned
"Policy violation" / signing rejectedWallet policy doesn't allow required methodsLoad the wallet-policy skill and propose the standard wildcard policy (deny key export + allow 
*
)
错误原因修复方案
"Orderly API 400"请求参数无效检查符号名称、订单类型和必填字段
"Orderly API 401"认证失败Ed25519密钥可能已过期 — 重启触发重新注册
"Orderly error"业务逻辑拒绝查看错误消息详情（保证金不足、价格无效等）
"Not running on Fly"无钱包访问权限钱包签名仅在Fly.io部署环境中生效
"Orderly account not registered"注册未完成私有/交易调用会在首次使用时自动注册
"No ethereum wallet found"缺少Privy钱包确保已配置WALLET_SERVICE_URL并已部署钱包
"Policy violation" / 签名被拒绝钱包策略不允许所需操作加载wallet-policy技能并提交标准通配符策略（禁止密钥导出 + 允许
*
）