← Back to XRP-Vault

🤖 XRP-Vault Bot Setup Guide

Complete Step-by-Step Process with Configuration Files

0% Complete
⏱️ Total Estimated Time: 2-3 hours
✅ Progress auto-saved to your browser

📋 What You'll Need Before Starting

Gather these items before you begin. Having everything ready will make the process much smoother:

💡 First Time Tip
Don't worry if you're not technical! Follow each step carefully, and use the AI assistants in Step 1 if you get stuck. Many successful traders started with zero coding experience.

📥 Download Required Configuration Files

Download all these files now. You'll use them in Step 7.

1
🤖 Get AI Help Ready
⏱️ 5 min

Why You Need AI Assistance

These AI tools act like having an expert sitting next to you. They can explain confusing steps, help you troubleshoot errors, and answer questions instantly - 24/7.

Quick Start: Click one of these AI assistants below and keep the chat window open in another tab. When you get stuck on any step, just ask it for help!

Choose Your AI Assistant (Pick One or More)

All of these are free to use. Pick whichever you prefer:

💬 Claude AI 💬 ChatGPT 💬 Grok 💬 Google Gemini 💬 Perplexity

How to Use AI for Help

  • Got an error message? Copy and paste it into the AI chat
  • Don't understand a step? Ask "What does [step] mean in simple terms?"
  • Stuck on a command? Ask "Why isn't [command] working?"
  • Need clarification? Ask "Can you explain [topic] like I'm a beginner?"

💰 Support This Guide (Optional)

If this guide helps you, consider using these referral links when signing up:

📊 TradingView (Affiliate Link) 🌍 Hyperliquid (Referral: XRPVAULT)
✅ Mark Complete When:
You've opened at least one AI assistant in a new tab and it's ready to help.
2
📊 Create TradingView Account
⏱️ 15 min

What is TradingView?

TradingView is where you'll create your trading strategy and send signals to your bot. Think of it as the "brain" that tells your bot when to buy or sell.

Simple Version: Go to TradingView → Click "Get Started" → Create free account → Verify your email

Step-by-Step Setup

  • Go to TradingView.com and click "Get Started"
  • Sign up with your email address
  • Check your email and click the verification link
  • Explore the charts - don't worry about understanding everything yet!
  • Consider upgrading to Pro+ later (needed for webhook alerts to your bot)

Getting a Trading Strategy

Your bot needs a strategy to know when to buy and sell. You have three options:

  • Option 1: Use XRP-Vault Strategies — Contact contact@xrp-vault.com or DM on X for access to our proven strategies
  • Option 2: Find Community Strategies — Go to TradingView → Indicators → Community Scripts → Search for "strategy" → Look for high-rated ones with good backtests
  • Option 3: Build Your Own — Learn Pine Script and create custom strategies (advanced users)
⚠️ Strategy Requirements
Your strategy must have webhook alerts enabled. Free TradingView accounts have limited alerts — consider Pro+ for unlimited webhook alerts.

TradingView Webhook Setup

When you're ready to connect TradingView to your bot, here's exactly how it works:

Step 1: Create Alert on Your Strategy

Right-click on your chart → Add Alert → Select your strategy

Step 2: Configure Webhook URL

In the alert settings, check "Webhook URL" and paste your bot's endpoint:

https://YOUR-SERVER-IP/webhook
Step 3: Set the Message Format (JSON)

In the "Message" field, paste this exact format:

{ "exchange": "hyperliquid", "hyperliquid_account": "sub5", "symbol": "ALGO", "action": "{{strategy.order.action}}", "price": {{close}}, "percentage": {{plot_0}}, "leverage": 5 }
🔍 What Each Field Does:
  • exchange — Always "hyperliquid"
  • hyperliquid_account — Your sub-account name (if using sub-accounts)
  • symbol — The coin to trade (ALGO, XRP, XMR, etc.)
  • action — TradingView fills this automatically (buy/sell)
  • price — Current price when alert triggers
  • percentage — Position size from your strategy
  • leverage — Must match your Hyperliquid settings!
⚠️ Important: Leverage Must Match!
The "leverage" value in your webhook JSON must exactly match what you've set in Hyperliquid for that trading pair. Mismatched leverage can cause unexpected position sizes.
✅ Mark Complete When:
You have a TradingView account and can log in successfully.
3
🏛️ Set Up Coinbase Account
⏱️ 20-30 min

Getting USDC (Stablecoin)

You need USDC to fund your Hyperliquid account. USDC is a "stablecoin" pegged to the US dollar — 1 USDC = $1. Here are the major exchanges where you can buy USDC:

Recommended US Exchanges

  • Coinbase — Most beginner-friendly, great mobile app, instant bank transfers
  • Kraken — Lower fees, good security, supports ACH and wire transfers
  • Gemini — US-regulated, good for larger amounts
  • Bitstamp — Established exchange, competitive fees
💡 Pro Tip
If you already have an account at any of these exchanges, just use that one! The process is similar across all of them.
Simple Version: Go to Coinbase.com → Sign Up → Complete ID verification → Link your bank account → Buy some USDC

Step-by-Step Setup

  • Go to Coinbase.com and click "Get Started"
  • Create account with your email and strong password
  • Verify your email address
  • Complete identity verification (upload photo of your driver's license or passport)
  • Enable 2-Factor Authentication (2FA) using Google Authenticator app
  • Link your bank account (they'll make 2 small test deposits to verify)
  • Once verified, deposit some USD and buy USDC
💵 Purpose of This Account
Coinbase is ONLY for converting USD to crypto and back. You won't do any bot trading here. Think of it as your "money converter" - that's it!
⏰ Verification Wait Time
ID verification usually takes 5-10 minutes, but can take up to 24 hours. Bank linking takes 1-2 business days. Don't worry - this is normal!
✅ Mark Complete When:
Your Coinbase account is verified, bank is linked, and you have some USDC ready to transfer.
4
☁️ Set Up Cloud Server
⏱️ 20-25 min

Why Do I Need This?

Your bot needs to run 24/7, even when your personal computer is off. A cloud server is like renting a computer that never sleeps and has super-fast internet. We'll use Google Cloud because they give you $300 in free credits!

Simple Version: We're going to rent a small computer in the cloud that runs your bot 24/7. Google gives you $300 free to start!

Option A: Google Cloud Platform (Recommended - FREE)

  • Step 1: Go to console.cloud.google.com
  • Step 2: Click "Get Started for Free" (You get $300 free credits!)
  • Step 3: Sign in with your Google account or create one
  • Step 4: Enter credit card info (won't be charged - just for verification)
  • Step 5: Click the menu icon (☰ three lines) in top left
  • Step 6: Find "Compute Engine" → Click "VM Instances"
  • Step 7: Click the blue "Create Instance" button
  • Step 8: Fill in these settings:
    • Name: trading-bot-1 (or anything you'll remember)
    • Region: Choose one close to you (like us-west1 for California)
    • Zone: Leave as default or pick us-west1-a
    • Machine type: Click "E2" then select e2-micro (this is FREE!)
    • Boot disk: Click "Change" → Select "Ubuntu" → Choose "Ubuntu 22.04 LTS" → Click "Select"
    • Firewall: Check both boxes "Allow HTTP traffic" and "Allow HTTPS traffic"
  • Step 9: Click "Create" at the bottom (takes 1-2 minutes)
  • Step 10: Write down your instance name and zone - you'll need these later!
🔍 What You Just Did:
You created a small virtual computer running Linux (Ubuntu) that will run your trading bot 24/7. It's like having a dedicated computer for your bot, but in Google's data center instead of your house!

Run These Commands (After Creating Your Instance)

Click "SSH" next to your instance name, then copy/paste these commands one at a time:

sudo apt update && sudo apt upgrade -y
🔍 What This Does:
Updates all the software on your cloud server to the latest versions. Like updating apps on your phone!
sudo apt install python3-pip python3-venv git docker.io docker-compose nginx -y
🔍 What This Does:
Installs the software tools your bot needs to run: Python (programming language), Docker (container system), and Nginx (web server).
sudo systemctl enable docker sudo systemctl start docker sudo usermod -aG docker $USER
🔍 What This Does:
Starts Docker (the system that runs your bot) and gives you permission to use it. After running this, type exit and then reconnect.
⚠️ Common Issue
If commands don't work, ask your AI assistant! Copy the error message and paste it into Claude or ChatGPT - they'll help you fix it.
✅ Mark Complete When:
Your cloud instance is running, you can connect to it via SSH, and all installation commands completed successfully.
5
🔒 Set Up VPN
⏱️ 15 min

Why Might I Use a VPN? (Optional)

Hyperliquid IS accessible from the US — a VPN is NOT required. However, some traders prefer a VPN for added privacy or if they travel internationally. This step is optional for US-based traders.

Simple Version: VPN is optional. Hyperliquid works fine from the US. Skip this step if you don't need extra privacy.

Recommended VPN Services

  • ExpressVPN - Easiest to set up, very reliable (~$12/month)
  • NordVPN - Good value, works great (~$5-8/month)
  • Surfshark - Most affordable (~$3-5/month)

How to Set Up (Don't Worry - Easier Than It Sounds!)

  • Sign up for one of the VPN services above
  • Download their Linux app (they have setup guides for Ubuntu)
  • Follow their installation instructions (usually just 2-3 commands)
  • Connect to a server in Singapore, Hong Kong, or Europe
  • Test that it's working: type curl ifconfig.me - you should see a different IP address
🔍 What "curl ifconfig.me" Does:
This command shows your current IP address. If the VPN is working, this will show an IP from the country you connected to (not your real location).
🌐 Keep It Running
Your VPN needs to stay connected 24/7 for your bot to work. Set it to "auto-reconnect" if the connection drops.
✅ Mark Complete When:
If using a VPN: It's installed and connects reliably. If not using VPN: Skip to the next step — you're good to go!
6
🌍 Create Hyperliquid Account
⏱️ 15-20 min

What is Hyperliquid?

This is where your bot will actually execute trades. It's a cryptocurrency derivatives exchange - think of it as the "stock market" for crypto trading.

Simple Version: Sign up with email → Deposit $10-20 USDC → Create API keys → Done!

Step 1: Create Account

  • Go to app.hyperliquid.xyz/join/XRPVAULT
  • Click "Connect" button in top right
  • Choose "Email" option (easiest method)
  • Enter your email address
  • Check your email and enter the verification code
  • Hyperliquid creates a wallet for you automatically
  • SAVE YOUR RECOVERY PHRASE! Write it down on paper and keep it safe!
🚨 CRITICAL: Disable Unified Account Mode

Before doing anything else, go to Settings → Portfolio Mode and make sure "Unified Account" is DISABLED.

The bot requires separate sub-accounts for each strategy. Unified mode will break your bot setup!

⚠️ Leverage Must Match Your Webhook JSON

When you set leverage on a trading pair in Hyperliquid (e.g., 5x on ALGO), the "leverage" value in your TradingView webhook JSON must be the same number (5). Mismatched values cause position sizing errors.

🔐 CRITICAL: Save Your Recovery Phrase!
Hyperliquid will show you 12-24 words. Write these down on paper. If you lose your phone/computer, these words are the ONLY way to recover your account and funds. Treat them like cash!

Step 2: Secure Your Account

  • Go to Settings (click your profile icon)
  • Navigate to Security section
  • Enable 2FA (Two-Factor Authentication) using Google Authenticator or Authy

Step 3: Deposit USDC (Required Before Creating API)

💡 Why You Need to Deposit First
Hyperliquid requires you to have funds in your account before you can create API keys. Just $10-20 is enough to start.
  • In Hyperliquid, click "Deposit" button
  • Copy your Hyperliquid deposit address
  • Open Coinbase in another tab
  • Buy $20-50 worth of USDC
  • Send USDC from Coinbase to your Hyperliquid address:
    • Choose "Arbitrum" network (lower fees!)
    • Paste your Hyperliquid address
    • Double-check the address is correct
    • Send the USDC
    • Wait 2-5 minutes for confirmation
⚠️ Double Check Addresses!
Always verify the wallet address before sending crypto. If you send to the wrong address, the funds are gone forever! Copy-paste don't type manually.

Step 4: Create API Keys (After Deposit Arrives)

  • Once your USDC deposit shows in your account, go to Settings
  • Click "API Management"
  • Click "Create New API Key"
  • Enable ONLY "Trading" permissions (NOT withdrawals for security!)
  • Click Create
  • IMMEDIATELY copy both the API Key and API Secret
  • Save them somewhere safe (you'll need them in Step 7)
🔐 Critical Security
Your API keys can control your funds! Never share them with anyone, never post them online, never save them in unencrypted files. Treat them like your bank password!
✅ Mark Complete When:
You have a Hyperliquid account, have deposited USDC, and have created API keys (saved securely).
7
⚙️ Install Your Bot
⏱️ 30-40 min

What We're Doing Here

This is where we upload your bot files to your cloud server and get everything configured. Don't worry - we'll take it step by step!

Simple Version: Upload files to cloud server → Add your API keys → Start the bot → Check it's running!

Step 1: Create Bot Folder on Server

Open your computer's terminal/command prompt and type:

📡 Connect to your server:
gcloud compute ssh YOUR-INSTANCE-NAME --zone=YOUR-ZONE
📁 Create the bot folder:
mkdir ~/tradingview_webhook
🚪 Exit back to your computer:
exit
🔍 What This Does:
Connects to your cloud server and creates a folder called "tradingview_webhook" where your bot will live.
💡 Replace These Values:
YOUR-INSTANCE-NAME: The name you chose in Step 4 (like "trading-bot-1")
YOUR-ZONE: The zone you selected (like "us-west1-a")

Step 2: Upload Your Bot Files

From the folder where you downloaded the config files earlier, run these commands:

1️⃣ Upload main.py
gcloud compute scp main.py YOUR-INSTANCE-NAME:/home/YOUR-USERNAME/tradingview_webhook/ --zone=YOUR-ZONE
2️⃣ Upload docker-compose.yml
gcloud compute scp docker-compose.yml YOUR-INSTANCE-NAME:/home/YOUR-USERNAME/tradingview_webhook/ --zone=YOUR-ZONE
3️⃣ Upload Dockerfile
gcloud compute scp Dockerfile YOUR-INSTANCE-NAME:/home/YOUR-USERNAME/tradingview_webhook/ --zone=YOUR-ZONE
4️⃣ Upload requirements.txt
gcloud compute scp requirements.txt YOUR-INSTANCE-NAME:/home/YOUR-USERNAME/tradingview_webhook/ --zone=YOUR-ZONE
🔍 What "scp" Does:
"SCP" stands for "Secure Copy" - it's like copying files from one folder to another, except one folder is on your cloud server instead of your computer!

Step 3: Add Your API Keys

Connect back to your server and edit the configuration:

gcloud compute ssh YOUR-INSTANCE-NAME --zone=YOUR-ZONE cd ~/tradingview_webhook

Now open the docker-compose.yml file and add your actual API keys:

  • Replace 0x_YOUR_API_KEY_HERE with your Hyperliquid API key
  • Replace 0x_YOUR_WALLET_HERE with your Hyperliquid wallet address
  • Do this for all three accounts (main, sub1, sub2) if you have multiple
  • Save the file
🔐 Keep These Secret!
Never share your docker-compose.yml file with anyone after you add your real API keys - it contains sensitive information!

Step 4: Start Your Bot!

Run these commands one at a time:

# Stop any existing containers (if running) docker compose down
# Remove old image if it exists docker rmi -f tradingview_webhook-trading-bot
# Build fresh image docker compose build --no-cache
🔍 What "build" Does:
This creates a "container" (think of it like a sealed box) that has everything your bot needs to run. It's like installing an app, but for servers!
# Start the bot (runs 24/7 in background) docker compose up -d
🔍 What "-d" Means:
The "-d" means "detached" - it runs your bot in the background so it keeps running even after you close the terminal. Like minimizing an app instead of closing it!

Step 5: Check It's Running

# See if your bot is running docker ps

You should see a container named "tradingview_webhook_bot" with status "Up"

# View the last 50 lines of logs docker compose logs --tail=50
🔍 What Logs Are:
Logs are like a diary your bot keeps. They show you what it's doing, any errors, and confirm it's working properly!
✅ Mark Complete When:
Your bot is running (shows "Up" in docker ps), and logs show no critical errors.
8
🧪 Test Your Bot
⏱️ 30-60 min

Why Testing is Critical

Never trade real money until you've tested! We'll run your bot with tiny amounts first to make sure everything works correctly.

Simple Version: Test webhook → Watch for 24 hours with small amounts → Fix any issues → Then scale up!

Test Your Webhook Connection

curl http://YOUR_SERVER_IP:8080/webhook
🔍 What This Tests:
This sends a test signal to your bot to make sure it can receive messages from TradingView. If it responds, your connection is working!

Watch It Run for 24-48 Hours

  • Start with very small position sizes ($5-10)
  • Check logs every few hours: docker compose logs -f
  • Watch for trades on Hyperliquid - do they match TradingView signals?
  • Look for any error messages
  • Make sure VPN stays connected

Useful Monitoring Commands

# Watch logs in real-time (Ctrl+C to exit) docker compose logs -f
# See last 100 lines docker compose logs --tail=100
# Check if container is still running docker compose ps
# See how much CPU/memory your bot uses docker stats
🚨 If Something Goes Wrong
Don't panic! Copy any error messages and paste them into your AI assistant. They'll help you troubleshoot. Common issues: VPN disconnected, API keys incorrect, or TradingView webhook URL wrong.
✅ Mark Complete When:
Bot has run successfully for 24-48 hours with small test trades executing correctly and no critical errors.
9
🚀 Go Live & Scale Up
⏱️ Ongoing

You Made It! Now Let's Scale Safely

Your bot is working! Now we'll gradually increase your trading capital over time. The key word is GRADUALLY - don't rush!

Simple Version: Start with 10-20% of your capital → Watch for 1-2 weeks → Gradually increase if profitable → Keep learning!

Safe Scaling Strategy

  • Week 1-2: Trade with 10-20% of your total planned capital
  • Week 3-4: If profitable and stable, increase to 30-40%
  • Month 2: If still profitable, increase to 50-70%
  • Month 3+: Full capital deployment if everything is working well

When You Need to Update Your Bot

If you need to update your strategy or bot code, here's the full process:

1️⃣ Upload updated files
gcloud compute scp main.py YOUR-INSTANCE-NAME:/home/YOUR-USERNAME/tradingview_webhook/ --zone=YOUR-ZONE
2️⃣ Connect to server
gcloud compute ssh YOUR-INSTANCE-NAME --zone=YOUR-ZONE
3️⃣ Go to bot folder
cd ~/tradingview_webhook
4️⃣ Stop the bot
docker compose down
5️⃣ Remove old version
docker rmi -f tradingview_webhook-trading-bot
6️⃣ Rebuild with changes
docker compose build --no-cache
7️⃣ Start updated bot
docker compose up -d
8️⃣ Check it's running
docker compose logs --tail=50
🔍 What This Process Does:
This is like updating an app on your phone - stop the old version, install the new version, restart it!

Ongoing Maintenance Checklist

  • Check bot logs daily for the first month
  • Monitor your Hyperliquid balance regularly
  • Keep trading journal - note what works and what doesn't
  • Withdraw profits monthly (don't let account grow unchecked)
  • Update server packages monthly: sudo apt update && sudo apt upgrade
  • Adjust strategy based on market conditions
  • Keep VPN subscription active and renewed
💰 Critical Risk Management Rules
  • Never risk more than you can afford to lose
  • Start with small amounts - don't get greedy!
  • Always use stop losses
  • Don't use maximum leverage - keep it conservative (2-3x)
  • Diversify your strategies - don't put all eggs in one basket
  • If something feels wrong, STOP and investigate
✅ Mark Complete When:
You've scaled to your target capital amount and have a solid maintenance routine in place.

🎉 Congratulations!

Your crypto trading bot is now running independently on Hyperliquid!

You have full control and ownership of your automated trading system.

Remember: Keep learning, stay disciplined, and manage your risk wisely!