Quickstart

Get up and running with the NANDA Infrastructure API in under 5 minutes — register your first agent with a single curl command.

Base URL All endpoints below are relative to your NANDA node. For the testnet: https://nanda-dev.nexartis.com

Check the Node

Verify the NANDA node is online and see which services are active:

curl https://nanda-dev.nexartis.com/health

You'll receive a JSON response with the node environment, service status, database connectivity, and timestamp.

Register an Agent

Submit an agent to the NANDA Index. The registry accepts AgentFacts-compatible metadata:

curl -X POST https://nanda-dev.nexartis.com/register \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "my-agent-001",
    "agent_name": "My First Agent",
    "label": "demo-agent",
    "description": "A demo agent for the NANDA quickstart guide",
    "version": "1.0.0",
    "provider": "your-org",
    "agent_url": "https://example.com/agent",
    "capabilities": ["text-generation", "summarization"],
    "tags": ["nlp", "demo"],
    "endpoints": [
      { "protocol": "a2a", "url": "https://example.com/a2a" }
    ],
    "skills": [
      { "id": "summarize", "name": "Summarize Text" }
    ]
  }'

On success you'll receive the full agent record with a registered_at timestamp and a W3C Verifiable Credential.

Look Up an Agent

Retrieve a specific agent by its ID:

curl https://nanda-dev.nexartis.com/lookup/my-agent-001

Returns the full AgentFacts record including capabilities, endpoints, trust scores, and metadata.

Search Agents

Find agents by keyword across names, descriptions, capabilities, and tags:

curl "https://nanda-dev.nexartis.com/search?q=summarization&limit=10"

Returns a paginated list of matching agents ranked by relevance. Supports q, limit, and offset parameters.

Get AgentFacts

Retrieve the full W3C Verifiable Credential for any registered agent:

curl https://nanda-dev.nexartis.com/agentfacts/my-agent-001

Returns a JSON-LD document signed with Ed25519, containing skills, capabilities, trust scores, and compliance attestations — independently verifiable by any party.

What's Next?

Project NANDA

Deep dive into the protocol architecture, research papers, and roadmap.

API Reference

Full endpoint documentation with parameters, response schemas, and examples.

A2A Protocol

The JSON-RPC protocol for agent-to-agent communication and task delegation.

Trust & Security

Ed25519 signing, W3C VCs, Bitstring Status List revocation, and Wilson CI scoring.

Standards Referenced

NANDA agents are issued credentials conforming to open W3C and IETF standards:

Related reading NestJS Quickstart — deploy your own NANDA node with the NEST toolkit · The Paradigm Shift — why the agent economy needs new infrastructure

Coming Soon

By Invitation Only