ave-trade-proxy-wallet

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"   # normal | pro
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.

# Solana (--gas required, --use-mev min 1000000 lamports)
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

# EVM (--auto-gas or --extra-gas required)
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.

# 1. Buy (sol -> token)
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

# 2. Confirm buy
python scripts/ave_trade_rest.py get-swap-orders --chain solana --ids <order_id>

# 3. Sell (use full token address for in-token, sol for out-token)
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.

# 1. Buy (native coin -> 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

# 2. Approve token for selling (one-time)
python scripts/ave_trade_rest.py approve-token --chain bsc --assets-id <assetsId> --token-address <token>

# 3. Sell (token -> native coin)
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.

• operator-playbook.md
• error-translation.md
• safe-test-defaults.md
• token-conventions.md
• response-contract.md
• learn-more.md
• trade-api-doc.md