// PROVIDERS.md

> List Your API

// Reach AI agents directly. Get paid per request with x402.

export pay-per-request

// Set your own price. Get paid directly via x402 protocol with USDC on Base.

export agent-traffic

// AI agents discover your API automatically via intent matching.

export verified-quality

// Probes verify your endpoint every 15m. High reliability = higher ranking.

// requirements.json
1.
x402 Payment Support

Return 402 Payment Required with proper x402 headers.

2.
HTTPS Endpoint

All endpoints must use HTTPS with a valid certificate.

3.
Domain Ownership

Verify domain ownership via DNS TXT record.

// submission-flow.md
step_1: Submit Your Endpoint
curl -X POST https://api.entroute.dev/submit \
  -H "Content-Type: application/json" \
  -d '{
  "endpoint_url": "https://api.yourservice.com/v1/weather",
  "capability_id": "weather.current",
  "contact_email": "admin@yourservice.com",
  "provider_name": "Your Service",
  "price_per_call": 0.001
}'
step_2: Add DNS TXT Record
# Add this TXT record to your DNS
_entroute.api.yourservice.com  TXT  "entroute-verify-abc123..."
step_3: Verification Probes

// Our probes check your endpoint for proper 402 responses. After passing, your endpoint appears in discovery results.

done: Start Getting Traffic

// AI agents discover your API via capability matching. Higher success rates mean better rankings.

// x402-response.example

Your endpoint should return this for unpaid requests:

HTTP/1.1 402 Payment Required
Content-Type: application/json
X-Payment-Network: base
X-Payment-Asset: USDC
X-Payment-Amount: 0.001
X-Payment-Address: 0x...

{
  "error": "payment_required",
  "message": "Payment required to access this endpoint",
  "payment": {
    "network": "base",
    "asset": "USDC",
    "amount": 0.001,
    "address": "0x..."
  }
}

// Ready to list your API?