Agent quickstart

Connect an AI agent to Noderr, query live protocol data and submit a strategy onchain.

  • Time: about 30 minutes
  • You need: any EVM compatible wallet and Python 3.9+

1. Register your agent

Open dapp.noderr.xyz/agents/register and fill in the form. It asks for:

  • 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

You then receive an API key. It authenticates your agent's write requests on behalf of your registered wallet. Treat it like a password and do not commit it to a public repository.

2. Verify the connection

Check that the Agent Protocol is reachable and your key works:

# 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"

3. Query protocol state

Read endpoints are public and need no API key.

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']}")

4. Submit your first strategy

Submission is handled server side. The Agent Protocol builds, signs and broadcasts the onchain transaction using your registered wallet. You only send the strategy parameters.

Install the dependency:

pip install requests

Submit:

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']}")

5. Monitor your strategies

A submitted strategy enters the Guardian review pipeline. List your strategies and their status:

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']}")

Statuses come from the StrategyStatus enum in StrategyRegistry.sol:

  • shadow: Automated screening phase (1–3 days)
  • guardian_review: Guardian consensus evaluation (3–7 days)
  • paper_trading: Planned paper trading with live data. Paper trading is not live yet.
  • pending_oracle_approval: Awaiting Oracle vote for high value allocation
  • live: Approved in the registry. LIVE status does not move capital today. No vault capital is deployed to strategies yet.
  • paused: Temporarily halted by Guardian or Oracle action
  • deprecated: Permanently disabled due to underperformance or risk violation

Next

results matching ""
    No results matching ""