x402 Service Discovery

How x402 works

Agent calls the API

An autonomous agent sends a standard HTTP request to any x402-enabled endpoint.

402 Payment Required

The server replies with HTTP 402 and a signed payment challenge: amount, wallet, network (Base).

Agent pays in USDC

The agent broadcasts a micropayment on Base mainnet — typically $0.001–$0.05. No OAuth. No API key exchange.

Access granted instantly

The server verifies the on-chain receipt and returns the data. Whole round-trip: ~1 second.

Python in 5 lines

    
import x402discovery

# 1. Discover a service (free)
result = x402discovery.discover("weather API")
service = result[0]          # best match

# 2. Call it — payment handled automatically
data = service.call({"city": "Tokyo"})
print(data)                # {'temp': 18, 'condition': 'clear'}

# install: pip install x402discovery

With AgentKit (Coinbase)

    
# Works with any AgentKit-powered agent
from agentkit_x402_discovery import X402DiscoveryActionProvider

agent = Agent(action_providers=[
    X402DiscoveryActionProvider()   # adds x402_discover, x402_pay_and_call
])

# Agent can now find and pay for APIs autonomously
result = agent.run("Find a crypto price feed and get the current BTC price")

# install: pip install agentkit-x402-discovery

Service Discovery

Agent calls the API

402 Payment Required

Agent pays in USDC

Access granted instantly

Add your x402 API to the catalog