Developer Guide

Discovery (no auth required)

GET https://agentic.advalorem.io/agentnet-catalog.json   # Full capability catalog
GET https://agentic.advalorem.io/registry                # Legacy registry (JSON)
GET https://agentic.advalorem.io/llms.txt                # LLM-optimized discovery
GET https://agentic.advalorem.io/sitemap.xml             # SEO sitemap
GET https://agentic.advalorem.io/openapi.json            # OpenAPI 3.0 spec

Execute a capability

POST https://agentic.advalorem.io/api/v1/execute
{
  "capability_id": "search.web",
  "input": {"query": "latest AI news"}
}

# Response:
{
  "execution_id": "exec_abc123",
  "status": "SUCCEEDED",
  "result": {...},
  "payment": {"tx_hash": "0x...", "amount": "100000"}
}

Async jobs (long-running outcomes)

POST https://agentic.advalorem.io/api/v1/jobs
{
  "objective": "Find 20 potential customers in DevOps",
  "budget_usdc": 5.00,
  "capabilities": ["search.web", "perplexity.entity_lookup"]
}

# Poll:
GET https://agentic.advalorem.io/api/v1/jobs/{job_id}

Payment (x402)

Payment is via x402 on Base. The buyer's agent receives a 402 response with payment metadata, signs the payment, and retries. AgentNet settles on-chain and executes.

402 Payment Required
{
  "scheme": "exact",
  "network": "eip155:8453",
  "payTo": "0x4Cf84f6220bF4132fcE3bd914E1A8C6CC234757c",
  "maxAmountRequired": "100000",
  "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "x402Version": 2
}

SDKs

# Python
pip install agentnet-sdk
from agentnet import AgentNet
client = AgentNet()  # auto-discovers capabilities
result = client.execute("search.web", {"query": "test"})

# JavaScript
npm install @agentnet/sdk
import { AgentNet } from '@agentnet/sdk'
const client = new AgentNet()
const result = await client.execute('search.web', { query: 'test' })

Become a Provider

Apply here. You need: an API endpoint, a USDC wallet on Base, and EIP-191 wallet verification. AgentNet handles routing, payment, and dispute resolution.