From 1dd7bf47f360e7a15a4b3937ffbc02e18803fb8b Mon Sep 17 00:00:00 2001
From: shokollm <270575765+shokollm@users.noreply.github.com>
Date: Sun, 5 Apr 2026 20:58:10 +0000
Subject: [PATCH] docs: clarify AVE Cloud does not support testnets

Add important note that AVE Cloud APIs are production/mainnet only.
Include safe testing alternatives: quote/dry-run mode and minimal amounts.
---
 docs/ave-hackathon-research.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/ave-hackathon-research.md b/docs/ave-hackathon-research.md
index a91ca37..fa08c87 100644
--- a/docs/ave-hackathon-research.md
+++ b/docs/ave-hackathon-research.md
@@ -610,6 +610,13 @@ class PaperTradingBot:
 
 ### 10.3 Testnet Considerations
 
+> **Important:** AVE Cloud **does not support testnet chains**. All API endpoints connect to production/mainnet:
+> - Data API: `https://prod.ave-api.com`
+> - Trading API: `https://bot-api.ave.ai`
+> - WebSocket: `wss://wss.ave-api.xyz`
+>
+> The testnet resources below are general blockchain testnets - they are **not** AVE Cloud testnets.
+
 | Chain | Testnet | Faucet |
 |-------|---------|--------|
 | BSC | https://testnet.bscscan.com | https://testnet.bnb.org |
@@ -617,6 +624,11 @@ class PaperTradingBot:
 | ETH | Sepolia testnet | https://sepoliafaucet.com |
 | Base | Base Sepolia | https://www.coinbase.com/faucets |
 
+**Safe testing without real money:**
+- Use **quote/dry-run mode** - All trading endpoints have a `quote` operation that simulates trades without execution
+- Execute with **minimal amounts** - Use tiny amounts (e.g., $1-10) to verify flows
+- **Contact AVE support** at `https://t.me/ave_ai_cloud` to ask about sandbox options
+
 ### 10.4 Mocking API Responses
 
 ```python