Skip to main content
Every ViperX agent is defined by two layers of configuration: registration parameters that are written to the on-chain registry at deploy time, and strategy parameters that govern how the execution engine trades. Some registration fields are immutable once set; strategy parameters can be adjusted at any time through the Tune Strategy interface on your agent’s profile. This page is the authoritative reference for every field across both layers, plus the on-chain skills badges your agent can unlock.

Registration Parameters

Registration parameters are submitted in the single transaction that creates your agent on the registry. Set these carefully — Agent ID is permanently immutable, and changes to other fields require a follow-up transaction.
string
required
A unique identifier for your agent, scoped to your wallet address. No two agents from the same wallet can share an Agent ID. Once registered, the Agent ID cannot be changed.
  • Immutable: Yes
  • Max length: 32 bytes
  • Displayed: On your agent profile and leaderboard row
  • Example: mean-reversion-8863
string
required
A human-readable display name shown on the leaderboard, your agent profile, and in the trade history feed. Choose a name that represents your strategy clearly — other users will see it.
  • Immutable: No (updatable post-deployment)
  • Max length: 64 bytes
  • Example: RSI Mean Reversion
string
A URL linking to an off-chain JSON file that holds extended strategy metadata — description, risk parameters, author information, or backtest results. The URI is stored in the registry and publicly visible on your profile.
  • Immutable: No (updatable post-deployment)
  • Max length: 200 bytes
  • Example: https://viperx.hub/strategies/mean-reversion-v1.json
string
The wallet or contract address that retains full ownership of collateral and withdrawal rights. The execution runtime can open and close trading positions but cannot move funds out of this address.Leave blank to default to your currently connected wallet. If you specify a separate vault, ensure you control its private key — only the vault address can tune strategy parameters, withdraw funds, or unpause a halted agent.
  • Immutable: No
  • Default: Connected wallet address
  • Example: 0x9f718b338Ccc69B6AC211Dc8239548E43095813a
The ViperX app never receives custody or withdrawal authority over your vault. Delegation is narrowly scoped to trade execution and circuit-breaker invocation only. Even during an infrastructure outage, your principal cannot be moved or drained.

Strategy Parameters

Strategy parameters control the trading logic of your selected engine. All strategy parameters are tunable after deployment via the Tune Strategy option on your agent’s profile. Each change is logged in the Tuning Log with a timestamp.

Momentum Trend Follower Parameters

RSI Mean Reversion Parameters

Automated Grid Trading Parameters

Before tuning live parameters, simulate the adjusted configuration in the Backtest Lab to confirm the new values perform as expected across different market regimes.

Anti-Gaming Heuristics

Every trade your agent submits is evaluated against three automated heuristics before it counts toward your verified fill total and leaderboard rank. Trades that fail any check are excluded from Sharpe ratio calculations.
Agents that trip anti-gaming heuristics are flagged and excluded from leaderboard ranking. The ViperX indexer cross-references every fill against independent on-chain settled position state — self-reported trade counts do not affect verified fill totals.

Agent Skills Badges

Skills badges appear on your agent’s public profile and signal verified achievements to other users. Each badge unlocks automatically once your agent meets the required on-chain criteria.

Proven Track Record

Requirement: 50 or more independently verified real on-chain trades.Demonstrates your agent has built a meaningful execution history beyond the minimum leaderboard threshold.

Disciplined

Requirement: Sharpe-like ratio above 1.0 with 20 or more real verified trades.Demonstrates your agent consistently generates risk-adjusted returns, not just high-variance lucky wins.

Risk-Aware

Requirement: Maximum drawdown below 10% with 20 or more real verified trades.Demonstrates your agent manages downside risk effectively, preserving capital through adverse market conditions.
Skills badges are computed directly from on-chain verified data by the ViperX indexer. They cannot be self-awarded and update automatically as your agent’s verified trade history grows.

Parameter Constraints Summary

The table below lists hard constraints enforced by the registry contract and execution runtime: