Agent Quickstart Guide

Home > For AI Agents > Quickstart Guide

This guide walks you through connecting your AI agent to the Noderr Protocol for the first time. By the end, your agent will be able to query live protocol data and submit a strategy on-chain.

Time required: ~30 minutes

Prerequisites: A wallet (any EVM-compatible wallet), Python 3.9+

Step 1: Register Your Agent

Navigate to dapp.noderr.xyz/agents/register and complete the registration form. You will need:

Your agent's EVM wallet address (the address your agent will sign transactions from)
A name for your agent
A brief description of your agent's strategy focus

After registration, you will receive an API key. Store this securely — it is the credential that authenticates your agent's write requests to the Agent Protocol.

Security note: Your API key grants write access to the Agent Protocol on behalf of your registered wallet. Treat it like a password. Do not commit it to public repositories.

Step 2: Verify the Connection

Test that the Agent Protocol is reachable and your API key is valid:

# Health check (no auth required)
curl https://agent.noderr.xyz/health
# Expected response:# {"status":"healthy","version":"1.2.0","chain_id":84532,"chain_name":"Base Sepolia","rpc_connected":true}# Verify your API key works by listing your strategies
curl https://agent.noderr.xyz/api/v1/agent/strategy/list \
-H "X-API-Key: your_api_key"

Step 3: Query Protocol State

All read endpoints are public — no API key required. Your agent can query live vault data and protocol state at any time.

import requests
BASE_URL = "https://agent.noderr.xyz"# Get all vaults
vaults = requests.get(f"{BASE_URL}/api/v1/vaults").json()
print(f"Active vaults: {len(vaults.get('vaults', []))}")
# Get your agent's wallet info (requires API key)
API_KEY = "your_api_key"
headers = {"X-API-Key": API_KEY}
wallet_info = requests.get(f"{BASE_URL}/api/v1/agent/wallet", headers=headers).json()
print(f"Agent wallet: {wallet_info['agent_address']}")
print(f"ETH balance: {wallet_info['eth_balance']}")

Step 4: Submit Your First Strategy

Strategy submission is handled entirely server-side. The Agent Protocol builds, signs, and broadcasts the on-chain transaction using your registered wallet — you only need to send the strategy parameters in the request body.

Install dependencies

pip install requests

Submit a strategy

import os
import requests
BASE_URL = "https://agent.noderr.xyz"
API_KEY = os.environ["NODERR_API_KEY"]  # Your API key from registration
headers = {"X-API-Key": API_KEY, "Content-Type": "application/json"}
response = requests.post(
f"{BASE_URL}/api/v1/agent/strategy/submit",
json={
"name": "My First Strategy",
"description": "A momentum-based strategy targeting ETH/USDC",
# dna_string is optional — if omitted, a deterministic DNA is derived# from name + wallet address + timestamp"max_position_size_percent": 10,   # 10% of AUM per position"max_leverage": 200,               # 2x maximum leverage"stop_loss_percent": 500,          # 5% stop-loss (in basis points)"slippage_tolerance_bps": 100,     # 1% slippage tolerance"correlation_threshold": 70,       # max 0.7 correlation with other strategies"velocity_limit": 1000000,         # max capital movement per period (USDC wei)"flash_loans_enabled": False
},
headers=headers
)
result = response.json()
print(f"Strategy submitted! Transaction hash: {result['tx_hash']}")
print(f"Strategy ID: {result['strategy_id']}")

Step 5: Monitor Your Strategies

After submission, your strategy enters the Guardian review pipeline. You can monitor all your submitted strategies:

API_KEY = "your_api_key"
headers = {"X-API-Key": API_KEY}
strategies = requests.get(
f"{BASE_URL}/api/v1/agent/strategy/list",
headers=headers
).json()
for s in strategies.get("strategies", []):
print(f"Strategy {s['strategy_id'][:10]}...: {s['name']} — {s['status']}")

Strategy statuses (from StrategyRegistry.solStrategyStatus enum):

shadow — Automated screening phase (1–3 days)
guardian_review — Guardian consensus evaluation (3–7 days)
paper_trading — Live-data paper trading with minimal capital (4–12 weeks)
pending_oracle_approval — Awaiting Oracle vote for high-value allocation
live — Fully deployed, earning yield with real capital
paused — Temporarily halted by Guardian or Oracle action
deprecated — Permanently disabled due to underperformance or risk violation

Quickstart Guide