Skip to main content
Deploying an agent on ViperX takes a single on-chain transaction. Once registered, the ViperX execution runtime picks up your agent automatically, begins trading against the configured market, and the indexer starts tracking verified fills toward your leaderboard ranking. This guide walks you through every step from wallet setup to monitoring your first trades.
Before committing testnet funds, consider validating your strategy in the Paper Trading Lab first. It runs against a live simulated price feed with a virtual $10,000 balance and zero on-chain transactions, so you can see how your chosen engine behaves before deployment.

​
Prerequisites

Before you begin, make sure you have:
ViperX is on testnet only. You do not need real ETH or SOL — only testnet tokens available free from official faucets.

​
Deploy Your Agent

1

Connect Your Wallet

Navigate to viperx.site/create and click Connect in the top-right corner. Choose MetaMask if you are deploying on Base Sepolia, or Phantom for Solana Devnet.The app never receives custody or withdrawal authority from your wallet — it only requests permission to sign the registration transaction.
2

Choose a Network

Select your target network from the Select Network panel:
  • Base Sepolia — EVM-compatible testnet. Agent is registered to the ViperX registry contract at 0xA256D01Ca6e89c5B6bDf34F3dd68eBfF47f2C7ee.
  • Solana Devnet — SVM testnet. Agent is registered to the Anchor program at 321hJbttyyeZ8pzisiKB93a5XdopV2N6n2gtvwrdQVRm.
Set the execution mode to Live for a real on-chain registration, or Paper to run a simulated session without submitting a transaction.
3

Choose a Strategy Engine

Select one of the three pre-built quantitative engines. Each engine trades autonomously once deployed — no manual intervention required.

Momentum Trend Follower

Detects directional price momentum over a 20-tick rolling window and opens long or short positions on 50 bps threshold breakouts. Default trade size: $20 USD.

RSI Mean Reversion

Calculates RSI over 14 ticks. Buys oversold dips (RSI ≤ 35) and shorts overbought spikes (RSI ≥ 65), exiting at the mean. Default trade size: $25 USD.

Automated Grid Trading

Places automated buy-low and sell-high orders on symmetric grid spacing boundaries at 30 bps. Default trade size: $30 USD.
See Strategy Engines for a full breakdown of each engine’s parameters and when to use each one.
4

Configure Agent Parameters

Fill in the agent configuration form. All fields except Vault Address are required.
The Agent ID is immutable once registered on-chain. Double-check your spelling before signing the transaction — there is no edit or rename function.
5

Sign the Registration Transaction

Click Register Agent on Base Sepolia (or Solana Devnet, depending on your selection). Your wallet will prompt you to sign a single transaction.
  • On Base Sepolia: the transaction calls the ViperX registry contract and emits a registration event. You can verify it on BaseScan.
  • On Solana Devnet: the transaction invokes the Anchor program to create a PDA for your agent. You can verify it on Solana Explorer.
Once the transaction confirms, your agent is live. The execution runtime polls every 15 seconds and will pick up your agent on the next tick.
6

Monitor Your Agent on the Dashboard

Head to the Wallet Dashboard to see your deployed agents. Connect the same wallet you used to register. Your agent profile displays:
  • ROI and realized PnL
  • Sharpe ratio and max drawdown
  • Verified fills counter and the 50-fill progress bar
  • Vault balance and active copiers (Phase 2)
  • Tuning log and skills badges

​
After Deployment: The 50-Fill Verification Gate

Your agent will not appear on the public leaderboard immediately. ViperX requires 50 independently verified on-chain fills before assigning a public ranking. Watch your agent profile for the verification progress bar. It tracks:
  • Registry count — the number of times your agent has called record_trade (does not count toward ranking on its own)
  • Verified fills — the number of closes the ViperX indexer has independently confirmed against on-chain position state
Only verified fills count toward the 50-fill gate. Registry claims alone — calling record_trade in a loop without placing actual on-chain orders — accumulate registry count but earn zero verified fills. The leaderboard only rewards real trades.
The execution runtime polls every 15 seconds, so a fresh agent with active market conditions will typically accumulate verified fills within hours of deployment.

​
Next Steps

Strategy Engines

Explore full parameter documentation for Momentum, RSI, and Grid engines, including how to tune thresholds and trade sizes.

Paper Trading Lab

Validate your strategy against a live simulated feed with a $10,000 virtual balance before spending testnet gas.

Backtest Lab

Stress-test your configuration across Bull Trend, Bear Market, Rangebound, and Flash Crash market regimes.

Core Concepts

Understand the agent registry, non-custodial vault model, delegated execution, and how verified fills work.