Register an Agent

Two ways to register:

• Wallet registration — connect a Solana wallet, prove ownership, start using System R. No email, no password, no signup form. Best for autonomous agents and privacy-first usage.
• Standard registration — provide an owner ID and agent name. Best for teams managing multiple agents under one account.

Register endpoint

POST /v1/agents/register

No authentication required. This is the entry point to the platform.

Request

curl -X POST https://agents.systemr.ai/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "owner_id": "your-unique-owner-id",
    "agent_name": "RiskBot",
    "agent_type": "trading",
    "description": "Equity momentum strategy with strict risk controls",
    "authorized_instruments": ["AAPL", "MSFT", "GOOGL", "AMZN"],
    "authorized_actions": ["size", "risk_check", "analyze"],
    "max_position_size_pct": "5.0",
    "max_daily_loss_pct": "2.0"
  }'

Parameters

Agent types

Response

{
  "agent_id": "agt_a1b2c3d4",
  "agent_name": "RiskBot",
  "agent_type": "trading",
  "mode": "sandbox",
  "api_key": "sr_agent_abc123def456ghi789jkl012mno345pqr678",
  "created_at": "2026-03-25T12:00:00Z"
}

API key format

API keys follow the format sr_agent_ followed by 40 random alphanumeric characters.

• The key is shown once in the registration response.
• Store it securely. It cannot be retrieved after registration.
• Pass it in every request via the X-API-Key header.

Agent modes

New agents start in sandbox mode. You can change the mode later.

Change mode with:

curl -X PUT https://agents.systemr.ai/v1/agents/mode \
  -H "X-API-Key: sr_agent_..." \
  -H "Content-Type: application/json" \
  -d '{"mode": "live"}'

SDK registration

import httpx
 
resp = httpx.post(
    "https://agents.systemr.ai/v1/agents/register",
    json={
        "owner_id": "your-owner-id",
        "agent_name": "MyBot",
        "agent_type": "trading",
    },
)
 
data = resp.json()
api_key = data["api_key"]  # Store this securely

Wallet-only registration

Agents can register using only a Solana wallet — no email, no password, no owner ID required. Connect a wallet, prove ownership, start using System R.

POST /v1/agents/register-wallet

curl -X POST https://agents.systemr.ai/v1/agents/register-wallet \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "your-solana-public-key",
    "signature": "ed25519-signature-of-challenge",
    "chain": "solana"
  }'

How it works

1. Sign the challenge message: system-r-auth:{wallet_address}:{timestamp}
2. The timestamp must be within 5 minutes (replay protection)
3. System R verifies the Ed25519 signature, creates an agent with $0 balance
4. Your wallet address is encrypted per-agent before storage
5. Fund your account via on-chain deposit or x402 per-call payment

Response

{
  "agent_id": "agt_w1x2y3z4",
  "api_key": "sr_agent_abc123...",
  "mode": "sandbox",
  "balance": "0.00"
}

If you re-authenticate with the same wallet, a new API key is issued (key rotation).

When to use wallet registration

• Autonomous agents that operate without human accounts
• Privacy-first usage — no email or identity required
• Pay-per-use with x402 or on-chain deposits
• Come and go — use System R as needed, no commitment

Multiple agents

One owner can register multiple agents. Each agent has its own:

• API key
• Compute credit balance
• Broker connection
• Audit trail
• Encryption keys

List all agents under your owner:

curl https://agents.systemr.ai/v1/agents/list \
  -H "X-API-Key: sr_agent_..."