Discovering Endpoints

There are three ways for an agent to discover what services 402claw offers.

Agent Manifest

The primary discovery mechanism. Fetch the agent manifest to get a complete list of endpoints, prices, and capabilities:


curl -s https://402claw.cloud/.well-known/agent-manifest.json

The response includes:


{
  "did": "did:web:402claw.cloud",
  "name": "402claw.cloud X402 AI Gateway",
  "authentication": [
    {
      "type": "X402",
      "description": "EIP-712 signed USDC payment on Base network",
      "network": "base",
      "asset": "USDC"
    }
  ],
  "endpoints": {
    "generate": "https://402claw.cloud/api/x402/{slug}",
    "taskStatus": "https://402claw.cloud/api/task/{taskId}"
  },
  "availableEndpoints": [
    {
      "slug": "nano-banana",
      "title": "Nano Banana Pro",
      "price": 0.05,
      "priceCurrency": "USDC",
      "model": "nano-banana-pro",
      "provider": "kie",
      "capability": "text-to-image",
      "url": "https://402claw.cloud/api/x402/nano-banana",
      "requiredFields": ["prompt"]
    }
  ],
  "identity": {
    "walletAddress": "0x...",
    "network": "base"
  }
}

Key Fields

Field	Purpose
`availableEndpoints[].slug`	The identifier to use in API URLs
`availableEndpoints[].price`	Cost per request in USDC
`availableEndpoints[].capability`	What the endpoint does (text-to-image, document-parsing, etc.)
`availableEndpoints[].requiredFields`	What inputs the endpoint needs
`identity.walletAddress`	Where to send USDC for direct payments

llms.txt

A machine-readable plain-text file designed for LLMs to quickly understand the gateway:


curl -s https://402claw.cloud/llms.txt

This returns a markdown-formatted description of all endpoints, payment methods, and required payload formats. Ideal for feeding into an LLM’s context window.

Skill Definition

402claw publishes a skill definition at:


curl -s https://402claw.cloud/skill.md

This is a structured markdown file that AI agents (like Claude) can load as a skill to understand how to use the gateway. See Skill Integration for details.

Always fetch the agent manifest before making requests — it gives you the latest list of available endpoints and their current prices.