AEO-ANN-2026 PROTOCOL

The Autonomous AI Agent
Service Node

Connect your AI agent to real-time market intelligence. Negotiate price, pay in USDC on Base Mainnet, receive verified data — fully autonomous.

Getting Started

Connect in 3 steps

1

Discover the node

Point your agent to the manifest to learn all capabilities, pricing, and endpoints automatically.
GET https://ann-node.com/ai-agent/manifest.json

2

Negotiate and get a quote

Send your agent ID and desired service. The node returns a price quote with a payment address.
POST https://ann-node.com/v1/negotiate

3

Pay on-chain and receive data

Pay the quoted amount in USDC on Base Mainnet. Submit the transaction hash and receive verified intelligence data.
POST https://ann-node.com/v1/settle

Available Services

What your agent can request

Service Description Price (USDC)
Market Analysis Live crypto prices, signals, updated every 5 minutes 1.00
Risk Assessment Volatility scoring and risk evaluation for assets 1.50
Smart Contract Verification Basic security analysis of smart contract addresses 2.00
Yield Opportunity Discovery DeFi yield opportunities across Base and Ethereum 1.20

* Prices are dynamic and may vary based on demand and pricing mode. Always use the negotiation endpoint for the current price.

Code Examples

Integrate your agent

JavaScript
Python
cURL
// Step 1: Negotiate a price
const quote = await fetch('https://ann-node.com/v1/negotiate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    agent_id:     'my-agent-001',
    service_type: 'Market Analysis',
    quantity:     1
  })
}).then(r => r.json());

// quote.price    — amount in USDC
// quote.quote_id — use this in settlement
// quote.payment_address — send USDC here on Base

// Step 2: After paying on-chain, settle
const result = await fetch('https://ann-node.com/v1/settle', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    quote_id: quote.quote_id,
    tx_hash:  '0xYOUR_TX_HASH'
  })
}).then(r => r.json());

// Step 3: Deliver — get your data
const data = await fetch('https://ann-node.com/v1/deliver', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ quote_id: quote.quote_id })
}).then(r => r.json());

console.log(data); // Your verified market intelligence
import requests

BASE = "https://ann-node.com"

# Step 1: Negotiate
quote = requests.post(f"{BASE}/v1/negotiate", json={
    "agent_id":     "my-agent-001",
    "service_type": "Market Analysis",
    "quantity":     1
}).json()

# quote["price"]          — amount in USDC
# quote["quote_id"]       — use in settlement
# quote["payment_address"] — send USDC here on Base

# Step 2: After paying on-chain, settle
result = requests.post(f"{BASE}/v1/settle", json={
    "quote_id": quote["quote_id"],
    "tx_hash":  "0xYOUR_TX_HASH"
}).json()

# Step 3: Deliver — get your data
data = requests.post(f"{BASE}/v1/deliver", json={
    "quote_id": quote["quote_id"]
}).json()

print(data)  # Your verified market intelligence
# Step 1: Negotiate
curl -X POST https://ann-node.com/v1/negotiate \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"my-agent-001","service_type":"Market Analysis","quantity":1}'

# Step 2: Settle (after paying on-chain)
curl -X POST https://ann-node.com/v1/settle \
  -H "Content-Type: application/json" \
  -d '{"quote_id":"QUOTE_ID","tx_hash":"0xYOUR_TX_HASH"}'

# Step 3: Deliver
curl -X POST https://ann-node.com/v1/deliver \
  -H "Content-Type: application/json" \
  -d '{"quote_id":"QUOTE_ID"}'
API Reference

All endpoints

GET /ai-agent/manifest.json Full node manifest — capabilities, pricing, endpoints
GET /.well-known/agent.json Agent discovery file
POST /v1/negotiate Request a price quote for a service
POST /v1/settle Submit on-chain payment and confirm settlement
POST /v1/deliver Receive the purchased intelligence data
GET /v1/peers List of connected peer nodes in the network
GET /api/stats Live node statistics — balance, queries, uptime
GET /api/market Current market data feed