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](../../references/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  --in-token sol --out-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  --in-token 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --out-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  --assets-id  --in-token  --out-token  --in-amount  --swap-type buy|sell --slippage 500 --limit-price  [--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  --ids id1,id2
python scripts/ave_trade_rest.py get-limit-orders --chain  --assets-id  [--status waiting] [--token ] [--page-size 20] [--page-no 0]

Cancel limit order

Cancel waiting limit orders.

python scripts/ave_trade_rest.py cancel-limit-order --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  --token-address 
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  --assets-id  --from-address  --to-address  --token-address  --amount 
python scripts/ave_trade_rest.py get-transfer --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  --in-token sol --out-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 

# 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  --in-token  --out-token sol --in-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  --in-token 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --out-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  --token-address 

# 3. Sell (token -> native coin)
python scripts/ave_trade_rest.py market-order --chain bsc --assets-id  --in-token  --out-token 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee --in-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](../../references/operator-playbook.md)
• [error-translation.md](../../references/error-translation.md)
• [safe-test-defaults.md](../../references/safe-test-defaults.md)
• [token-conventions.md](../../references/token-conventions.md)
• [response-contract.md](../../references/response-contract.md)
• [learn-more.md](../../references/learn-more.md)
• [trade-api-doc.md](../../references/trade-api-doc.md)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: AveCloud
• Source: AveCloud/ave-cloud-skill
• License: MIT

Install and usage instructions live in the source repository linked above.