| name | ave-trade-proxy-wallet |
| version | 2.4.0 |
| description | Execute server-managed proxy-wallet DEX trades via the AVE Cloud Bot Trade API.
Use this skill for proxy-wallet market and limit orders, TP/SL or trailing exits,
proxy wallet lifecycle actions, EVM token approvals, delegate transfers, order-history
queries, and live order-status watching over WebSocket.
Requires API_PLAN=normal or pro. Proxy wallets are managed by Ave; no local signing.
Do not use this skill for self-custody trading, on-chain data queries, or price/tx/kline streams.
|
| license | MIT |
| metadata | {"openclaw":{"primaryEnv":"AVE_API_KEY","requires":{"env":["AVE_API_KEY","AVE_SECRET_KEY","API_PLAN"],"bins":["python3"]}}} |
ave-trade-proxy-wallet
Server-managed proxy-wallet DEX trading via the AVE Cloud Bot Trade API. This is the default AVE trading path when the user has not explicitly asked for self-custody. For shared trade-path rules and current PROD quirks, see operator-playbook.md.
Trading fee: 0.8% | Rebate to feeRecipient: 25%
Route Cues
| EN | ZH |
|---|
| "buy this token", "swap X for Y" | "买这个币", "换成X" |
| "place a limit order", "set a buy limit" | "挂限价单", "设置限价买入" |
| "set take-profit", "set stop-loss" | "设置止盈", "设置止损" |
| "auto-sell", "trailing stop" | "自动卖出", "追踪止损" |
| "use proxy wallet", "place bot order" | "用代理钱包", "下机器人订单" |
| "watch my order", "check order status" | "看我的订单", "查询订单状态" |
Setup
export AVE_API_KEY="your_api_key_here"
export AVE_SECRET_KEY="your_secret_key_here"
export API_PLAN="normal"
pip install -r scripts/requirements.txt
Get keys at https://cloud.ave.ai/register. Proxy Wallet API must be activated on your account.
Rate Limits
API_PLAN | Write TPS |
|---|
normal | 5 |
pro | 20 |
Supported Chains
bsc, eth, base, solana
Preview or query order state first when useful, and do not treat the initial submission acknowledgement as final execution status.
Common Pitfalls
- Solana native token: Use
sol (not So11111111111111111111111111111111111111112) for --in-token / --out-token. The full mint address is rejected.
- Solana requires
--gas: Market and limit orders on Solana require --gas (lamports). With --use-mev, minimum is 1000000 (0.001 SOL). Or use --auto-gas high.
- EVM requires gas: Use
--auto-gas average or --extra-gas (wei) for EVM chains.
- Minimum swap value: Orders below ~$0.10 USD are rejected with
swap value too small.
- EVM sell needs approval: Before selling ERC-20 tokens, approve them with
approve-token. Native coin buys do not need approval.
- Verify order status:
market-order returns an order ID, not a tx hash. Always call get-swap-orders to confirm the order was filled.
Operations
Wallet management
List, create, or delete delegate proxy wallets.
python scripts/ave_trade_rest.py list-wallets [--assets-ids id1,id2]
python scripts/ave_trade_rest.py create-wallet --name "my-wallet" [--return-mnemonic]
python scripts/ave_trade_rest.py delete-wallet --assets-ids id1 id2
Market order
Place an immediate proxy-wallet swap order.
python scripts/ave_trade_rest.py market-order --chain solana --assets-id <assetsId> --in-token sol --out-token <token> --in-amount 10000000 --swap-type buy --slippage 1000 --use-mev --gas 1000000
python scripts/ave_trade_rest.py market-order --chain bsc --assets-id <assetsId> --in-token 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --out-token <token> --in-amount 1000000000000000 --swap-type buy --slippage 1000 --auto-gas average
--auto-sell supports default TP/SL rules plus one trailing rule.
Limit order
Place a limit order that waits for the target USD price.
python scripts/ave_trade_rest.py limit-order --chain <chain> --assets-id <assetsId> --in-token <token> --out-token <token> --in-amount <amount> --swap-type buy|sell --slippage 500 --limit-price <usd> [--expire-time 86400]
Query orders
Get market or limit order status by ID or filter.
python scripts/ave_trade_rest.py get-swap-orders --chain <chain> --ids id1,id2
python scripts/ave_trade_rest.py get-limit-orders --chain <chain> --assets-id <assetsId> [--status waiting] [--token <token>] [--page-size 20] [--page-no 0]
Cancel limit order
Cancel waiting limit orders.
python scripts/ave_trade_rest.py cancel-limit-order --chain <chain> --ids id1 id2
Approval
Approve ERC-20 token spending for EVM proxy-wallet trading.
python scripts/ave_trade_rest.py approve-token --chain bsc --assets-id <assetsId> --token-address <token>
python scripts/ave_trade_rest.py get-approval --chain bsc --ids approval_id1,approval_id2
Transfer
Move assets from a delegate proxy wallet.
python scripts/ave_trade_rest.py transfer --chain <chain> --assets-id <assetsId> --from-address <from> --to-address <to> --token-address <token> --amount <amount>
python scripts/ave_trade_rest.py get-transfer --chain <chain> --ids transfer_id1
Watch orders
Stream live proxy-wallet order updates; use REST order queries as the source of truth for final status.
python scripts/ave_trade_wss.py watch-orders
Workflow Example
Solana buy + sell flow
Buy a token, confirm, then sell back.
python scripts/ave_trade_rest.py market-order --chain solana --assets-id <assetsId> --in-token sol --out-token <token> --in-amount 10000000 --swap-type buy --slippage 1000 --use-mev --gas 1000000
python scripts/ave_trade_rest.py get-swap-orders --chain solana --ids <order_id>
python scripts/ave_trade_rest.py market-order --chain solana --assets-id <assetsId> --in-token <token_address> --out-token sol --in-amount <received_amount> --swap-type sell --slippage 1000 --use-mev --gas 1000000
EVM buy + sell flow
Buy a token, approve for selling, then sell. Approval is one-time per token.
python scripts/ave_trade_rest.py market-order --chain bsc --assets-id <assetsId> --in-token 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --out-token <token> --in-amount 1000000000000000 --swap-type buy --slippage 1000 --auto-gas average
python scripts/ave_trade_rest.py approve-token --chain bsc --assets-id <assetsId> --token-address <token>
python scripts/ave_trade_rest.py market-order --chain bsc --assets-id <assetsId> --in-token <token> --out-token 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --in-amount <received_amount> --swap-type sell --slippage 1000 --auto-gas average
Reference
Use shared references for current PROD quirks, test caps, token conventions, error wording, response shape, and fuller trade API details.