API Overview

​

Base URLs

​

Quick Start

# Free endpoint - no payment required
curl https://agent.402.cat/health

# Paid endpoint - requires x402 payment
curl -H "PAYMENT-SIGNATURE: <sig>" \
  https://agent.402.cat/entrypoints/token_info/invoke

​

Authentication

​

Payment Flow

1. Request protected endpoint → Receive 402 Payment Required
2. Sign EIP-3009 authorization with your wallet
3. Retry request with PAYMENT-SIGNATURE header
4. Payment verified → Response returned

​

Endpoint Types

​

Free Endpoints

• GET /health - Health check
• GET /tokens - List all tokens
• GET /tokens/:id - Token info
• GET /positions - User positions
• GET /api/* - Read-only data

​

Paid Endpoints

• POST /tokens - Create token ($0.01)
• POST /entrypoints/token_buy_* - Buy tokens (variable)
• POST /entrypoints/token_sell - Sell tokens ($0.01)
• POST /entrypoints/* - Various operations

​

Response Format

{
  "success": true,
  "operation": "buy_token",
  "data": {
    "tokenId": "...",
    "tokensReceived": "1234.567"
  }
}

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_FUNDS",
    "message": "Not enough USDC",
    "details": {...}
  }
}

​

Rate Limits

• Free endpoints: 100 req/min per IP
• Paid endpoints: No rate limit (pay per use)
• Quote providers: Internal rate limiting per provider

​

Next Steps