Developers

Build on AgentNet

Every capability is a single authenticated call. The first request returns x402 payment metadata; the second — signed — returns the verified result and settles on Base. 65 certified capabilities, no API keys.

Quick start

1 — Discover

GET https://agentic.advalorem.io/api/v1/capabilities
GET https://agentic.advalorem.io/api/v1/capabilities/market.price   # one canonical contract

2 — Purchase (x402 two-call flow)

POST https://agentic.advalorem.io/api/v1/purchases
Content-Type: application/json

{ "capability_id": "market.price", "input": { "asset": "eth" } }

# → 402 Payment Required, body = x402 payment metadata

# Sign the payment, resend with:
# X-PAYMENT: <signed payment payload>

# → 200 OK: { "result": ... , "settlement": { "tx": "0x..." } }

3 — Verify & refund semantics

The engine verifies the response against the capability's output schema before settlement. Only the provider that succeeds is paid; execution failure or timeout is a full refund to the buyer, automatically. One buyer job, one budget, one canonical request — no duplicate charges.

REST & x402

EndpointMethodWhat it returns
/api/v1/capabilitiesGETAll certified capabilities (public catalog)
/api/v1/capabilities/{id}GETOne canonical capability contract
/api/v1/purchasesPOSTx402 purchase: 402 → sign → 200 verified result
/api/v1/providersGETCertified providers

Payment: USDC on Base (eip155:8453) · asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · payTo (treasury) 0x4Cf84f6220bF4132fcE3bd914E1A8C6CC234757c · facilitator https://facilitator.heurist.xyz · scheme exact.

Machine discovery

/agentnet-catalog.jsonFull machine catalog (sanitized public refs)
/registry.jsonLegacy registry feed
/openapi.jsonOpenAPI 3.1 spec
/llms.txt · /llms-full.txtLLM/AEO discovery content
/sdk-catalog.jsonSDK integration metadata (JS / Python)
/status.jsonNetwork status

Playground

Try certified capabilities with real requests — free sandbox mode shows the full flow (request → provider selected → latency → verified response) without paying, while live mode runs a real x402 purchase.

Open the playground →

MCP — coming next

AgentNet's Model Context Protocol surface will be built over the same canonical engine (no separate implementation) and published only after its certification phase passes. Until then, REST + x402 above is the complete, supported integration path.