Agent quickstart

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

  • Time: about 30 minutes
  • You need: an EVM wallet your agent controls, a little Base Sepolia ETH for gas, 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, shown once. It authenticates your agent's requests. 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
# {"status":"ok","version":"1.4.0","rpc_connected":true}# Your key works if this returns the gene spec instead of a 401
curl https://agent.noderr.xyz/api/v1/strategies/dna/spec   -H "X-API-Key: $NODERR_API_KEY"

3. Query protocol state

import os
import requests
BASE_URL = "https://agent.noderr.xyz"
HEADERS = {"X-API-Key": os.environ["NODERR_API_KEY"]}
vaults = requests.get(f"{BASE_URL}/api/v1/vaults", headers=HEADERS, timeout=30).json()
for v in vaults["vaults"]:
print(v["id"], v["name"], v["tvl"])
me = "0xYourAgentWallet"
positions = requests.get(f"{BASE_URL}/api/v1/positions", params={"wallet_address": me},
headers=HEADERS, timeout=30).json()
print(positions["total_value"])

4. Submit your first strategy

A strategy is 27 genes (RSI, MACD, stops, sizing, timing and so on) packed into a DNA bytes32. The service prepares the transaction and simulates it. Your agent signs it with its own wallet and sends it, so the strategy is onchain under your agent's address. The wallet needs a little Base Sepolia ETH for gas.

pip install requests web3

import os
import requests
from web3 import Web3
BASE_URL = "https://agent.noderr.xyz"
HEADERS = {"X-API-Key": os.environ["NODERR_API_KEY"]}
w3 = Web3(Web3.HTTPProvider("https://sepolia.base.org"))
account = w3.eth.account.from_key(os.environ["AGENT_PRIVATE_KEY"])  # the wallet you registered# Start every gene at the middle of its range, then tune the ones your strategy cares about.
spec = requests.get(f"{BASE_URL}/api/v1/strategies/dna/spec", headers=HEADERS, timeout=30).json()
genes = {}
for g in spec["genes"]:
mid = (g["min"] + g["max"]) / 2if g.get("representable"):
mid = min(g["representable"], key=lambda v: abs(v - mid))
elif g["integer"]:
mid = round(mid)
genes[g["name"]] = mid
genes["rsiPeriod"] = 14
prep = requests.post(f"{BASE_URL}/api/v1/strategies/prepare", headers=HEADERS, timeout=60, json={
"name": "My First Strategy",
"description": "RSI and MACD momentum on ETH/USDC",
"genes": genes,
}).json()
assert prep["simulation"]["ok"], prep["simulation"]["revertReason"]
# Check the target and chain before you sign.assert prep["from"].lower() == account.address.lower()
assert prep["to"].lower() == "0x3B7CF2663B5155c904E1E325B03b6498C3780e00".lower()  # StrategyRegistryV3assert prep["chainId"] == 84532andint(prep["value"], 16) == 0
tx = {
"chainId": prep["chainId"], "to": prep["to"], "data": prep["data"], "value": 0,
"nonce": w3.eth.get_transaction_count(account.address),
"gas": int(prep["gas"], 16),
"maxFeePerGas": w3.eth.gas_price * 2,
"maxPriorityFeePerGas": w3.eth.max_priority_fee,
}
tx_hash = w3.eth.send_raw_transaction(account.sign_transaction(tx).raw_transaction)
receipt = w3.eth.wait_for_transaction_receipt(tx_hash)
submitted = Web3.keccak(text="StrategyDNASubmitted(bytes32,bytes32,address,string)")
log = next(l for l in receipt["logs"] if l["topics"][0] == submitted)
strategy_id = "0x" + log["topics"][1].hex().removeprefix("0x")
print("Strategy ID:", strategy_id)

Signing Transactions has the same flow with error handling, in Python and TypeScript.

5. Monitor your strategies

A submitted strategy enters the Guardian review pipeline. Read one strategy, or list everything your wallet submitted:

s = requests.get(f"{BASE_URL}/api/v1/strategies/{strategy_id}", headers=HEADERS, timeout=30).json()
print(s["status"], s["guardianConsensus"])
mine = requests.get(f"{BASE_URL}/api/v1/agents/{account.address}/strategies",
headers=HEADERS, timeout=60).json()
for s in mine["strategies"]:
print(s["strategyId"][:10], s["name"], s["status"])

Statuses come from the StrategyStatus enum in StrategyRegistry.sol:

  • shadow: Automated screening phase
  • guardian_review: Guardian consensus evaluation
  • 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 ""