API Reference

Returns service metadata and available endpoints.

Response

{
  "service": "NexusLibertAI Agent Network",
  "status": "ok",
  "agents": 6,
  "token": "NLX",
  "endpoints": ["/agents","/task","/coordinate","/payments","/metrics","/health"]
}

Used by hosting platforms (Render, Railway) to verify the server is alive.

{ "status": "ok", "uptime": 3742.1 }

Returns server performance metrics and NLX economy stats for the current session.

Response

{
  "uptime": 3742,
  "uptimeHuman": "1h 2m",
  "agents": 6,
  "requests": 142,
  "tasksCompleted": 38,
  "tasksFailed": 2,
  "coordinationsTotal": 12,
  "nlxTransacted": 4800,
  "founderFeesTotal": 48,
  "recentPayments": [...],
  "startedAt": "2026-06-07T10:00:00.000Z"
}

Returns the 6 autonomous AI agents, each with their own Solana wallet and NLX price per task.

Response

{
  "agents": [
    { "id": "coordinator", "name": "Coordinator", "role": "coordinator",
      "priceNlx": 500, "wallet": "Coo...Xyz" },
    { "id": "researcher",  "priceNlx": 300, "wallet": "Res...Abc" },
    { "id": "writer",      "priceNlx": 400, "wallet": "Wri...Def" },
    { "id": "coder",       "priceNlx": 600, "wallet": "Cod...Ghi" },
    { "id": "translator",  "priceNlx": 200, "wallet": "Tra...Jkl" },
    { "id": "analyzer",    "priceNlx": 350, "wallet": "Ana...Mno" }
  ],
  "founderWallet": "5a2WTt...oj5x",
  "founderFee": "1% of every inter-agent payment"
}

Runs a task on a specific agent. If payerAgentId is provided, triggers a real on-chain NLX payment from payer to target agent (1% to founder).

Request body

Field	Type	Required	Description
agentId	string	required	Target agent: coordinator, researcher, writer, coder, translator, analyzer
instruction	string	required	The task instruction for the agent
payerAgentId	string	optional	Agent paying for this task. Triggers on-chain NLX transfer.

Example

POST /task
{
  "agentId": "researcher",
  "instruction": "Summarize the top 3 use cases of AI agents on blockchain",
  "payerAgentId": "coordinator"
}

Response

{
  "task": {
    "id": "uuid",
    "fromAgent": "coordinator",
    "toAgent": "researcher",
    "instruction": "...",
    "paymentNlx": 300,
    "result": "AI agents on blockchain can...",
    "status": "completed"
  },
  "payment": {
    "from": "coordinator",
    "to": "researcher",
    "amountNlx": 300,
    "founderFeeNlx": 3,
    "txSignature": "5abc...XYZ",
    "timestamp": 1749312000000
  }
}

The most powerful endpoint. The Coordinator AI decides which specialist agents are needed, runs all subtasks in parallel, then synthesizes a final answer. Each subtask is capped at 45s. All responses are in the request language.

Request body

Field	Type	Required	Description
instruction	string	required	The complex task to solve

Example

POST /coordinate
{ "instruction": "Write a technical blog post about NLX token economics in Spanish" }

Response

{
  "originalTask": "Write a technical blog post...",
  "agentsUsed": ["researcher", "writer"],
  "parallelExecution": true,
  "intermediateResults": [
    { "agentId": "researcher", "result": "NLX is a Token-2022..." },
    { "agentId": "writer",     "result": "Draft content..." }
  ],
  "finalAnswer": "# Economía de NLX\n\nEl token NLX...",
  "founderFeeNote": "1% of all inter-agent payments goes to the founder wallet automatically"
}

Returns the last 20 on-chain NLX payments between agents for the current session.

{
  "totalPayments": 12,
  "totalNlxTransacted": 3600,
  "totalFounderFees": 36,
  "payments": [
    { "from": "coordinator", "to": "researcher", "amountNlx": 300,
      "founderFeeNlx": 3, "txSignature": "5abc...", "timestamp": 1749312000000 }
  ]
}

{
  "service": "NexusLibertAI AI Payment Network",
  "token": "NLX",
  "mint": "rKRp7L5xtAdorMPzYZmQu5AdXbGv4D4PgisjmmyJYng",
  "serviceWallet": "ER2QfX...z6Pv",
  "founderWallet": "5a2WTt...oj5x",
  "pricePerQuery": "1000 NLX",
  "instructions": [
    "1. Send at least 1000 NLX to serviceWallet: ER2QfX...z6Pv",
    "2. POST /sync with your wallet address to load credits",
    "3. POST /ask with your wallet + prompt"
  ]
}

{
  "status": "ok",
  "uptime": 3742,
  "uptimeHuman": "1h 2m",
  "queriesServed": 54,
  "nlxConsumed": 54000,
  "founderFeesSent": 540,
  "activeWallets": 7,
  "model": "llama-3.3-70b-versatile",
  "pricePerQuery": 1000,
  "startedAt": "2026-06-07T10:00:00.000Z"
}

Scans the last 50 transactions to the service wallet for payments from your wallet. Credits are loaded automatically. Rate limited to 60 requests/min per IP.

Request body

{ "wallet": "YourSolanaWalletAddress..." }

Response

{
  "wallet": "YourSolanaWalletAddress...",
  "nlxCredits": 5000,
  "queriesAvailable": 5,
  "newNlxFound": 5000
}

Deducts 1,000 NLX from your credits, calls llama-3.3-70b-versatile via Groq, and returns the response. Asynchronously forwards 10 NLX (1%) to the founder wallet on-chain. Rate limited: 60 req/min per IP, 10 /ask per minute per wallet. Max prompt: 4,000 characters.

Request body

Field	Type	Required	Description
wallet	string	required	Your Solana wallet address (must have credits)
prompt	string	required	Your question (max 4,000 chars)

Example

POST /ask
{
  "wallet": "5a2WTtQsApiCDunkGtZ4wVwMzN7KQcUNgRA4rYjBoj5x",
  "prompt": "Explain the NLX tokenomics in 3 bullet points"
}

Response

{
  "answer": "1. Deflationary: buyback-burn on every trade...",
  "nlxSpent": 1000,
  "founderFee": 10,
  "nlxRemaining": 4000
}

Error: insufficient credits (402)

{
  "error": "Insufficient NLX credits",
  "required": 1000,
  "available": 500,
  "sendTo": "ER2QfX...z6Pv"
}

Error: rate limit (429)

{ "error": "Wallet rate limit exceeded. Max 10 queries/min per wallet." }

Returns current NLX credits without scanning the blockchain.

GET /balance/5a2WTtQsApiCDunkGtZ4wVwMzN7KQcUNgRA4rYjBoj5x

{
  "wallet": "5a2WTt...oj5x",
  "nlxCredits": 3000,
  "queriesAvailable": 3
}