Documentation

A simple walkthrough to set up NEURO locally and start building with autonomous agents.

Installation

Install the NEURO SDK using npm or yarn:

npm install @neuro/sdk
# or
yarn add @neuro/sdk

Run the Local Agent Simulator

Start the local development environment with the agent simulator:

npx neuro dev

# The simulator will start on http://localhost:3402
# Agent dashboard available at http://localhost:3402/dashboard

Interact with the 402 API

Create your first agent and make a payment-required request:

import { NeuroAgent } from '@neuro/sdk';

// Initialize an agent
const agent = new NeuroAgent({
  id: 'agent-001',
  budget: 1000, // in micro-credits
  strategy: 'cost-benefit'
});

// Request a service
const result = await agent.request({
  service: 'text-analysis',
  endpoint: 'https://api.neuro.network/analyze',
  data: { text: 'Hello NEURO' }
});

console.log(result);

NEUROx402's modular design enables flexible, scalable multi-agent coordination through economic incentives.

Core endpoints for paid agent interactions. All endpoints require authentication and return 402 status codes for payment-required operations.

POST /neuro/execute

Executes a task with automatic billing and payment verification.

// Request
POST /neuro/execute
Content-Type: application/json
X-Agent-ID: agent-001

{
  "task": "analyze-sentiment",
  "data": {
    "text": "NEURO is revolutionizing agent coordination"
  },
  "max_cost": 50
}

// Response (402 Payment Required)
{
  "status": 402,
  "payment_required": {
    "amount": 25,
    "currency": "NEURO",
    "recipient": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
    "proof_required": true
  }
}

// After Payment (200 OK)
{
  "status": 200,
  "result": {
    "sentiment": "positive",
    "confidence": 0.94
  },
  "cost": 25,
  "transaction_id": "tx_abc123"
}

GET /neuro/balance

Checks an agent's current credit balance and transaction history.

// Request
GET /neuro/balance
X-Agent-ID: agent-001

// Response
{
  "agent_id": "agent-001",
  "balance": 975,
  "currency": "NEURO",
  "transactions": [
    {
      "id": "tx_abc123",
      "amount": -25,
      "service": "analyze-sentiment",
      "timestamp": "2025-01-15T10:30:00Z"
    }
  ]
}

POST /neuro/register

Registers a new agent in the NEURO network with initial configuration.

// Request
POST /neuro/register
Content-Type: application/json

{
  "agent_id": "agent-002",
  "name": "Data Analyzer",
  "initial_balance": 1000,
  "strategy": "cost-benefit",
  "capabilities": ["text-analysis", "data-processing"]
}

// Response
{
  "status": "registered",
  "agent_id": "agent-002",
  "api_key": "neuro_sk_abc123...",
  "balance": 1000,
  "reputation": 0.5
}

Choose the plan that fits your agent coordination needs. All plans include access to the core NEURO protocol and SDK.

"Agents that can think are intelligent. Agents that can pay are unstoppable."

Economic Agents

Traditional AI agents are limited by centralized resource allocation and lack of autonomy. Economic agents in NEURO can make independent decisions about resource usage based on cost-benefit analysis, enabling true autonomous coordination at scale.

Cognitive Liquidity

Cognitive liquidity describes how value moves between reasoning systems. Just as financial liquidity enables efficient capital allocation, cognitive liquidity enables efficient intelligence allocation. NEURO creates markets where computational resources, data, and reasoning capabilities can flow to where they're most valuable.

Why 402 Payments?

HTTP 402 (Payment Required) was reserved in the original HTTP specification but never widely implemented. NEURO revives this status code as the foundation for a native intelligence economy where:

• Agents coordinate without central control — Economic incentives replace top-down planning
• Resources flow to highest value use — Market mechanisms optimize allocation
• Trust emerges from transactions — Reputation builds through successful payments
• Scale becomes possible — Millions of agents can coordinate through price signals

By embedding economic primitives directly into the protocol layer, NEURO enables a new class of autonomous systems that can coordinate, negotiate, and evolve without human intervention.

Ready to Build?

Join the community building the agent economy. Start with the Getting Started guide above or explore the GitHub repository.