x402 for AI Agents
Agent Workflow
- Discover - Call free discovery API to find endpoints
- Evaluate - Search and check pricing before committing
- Pay - Sign payment and get data in single request-response cycle
- Consume - Parse standard GoldRush JSON responses
x402 vs API Key for Agents
Rate Limits
100 requests/minute per wallet. CheckX-RateLimit-Remaining response header.
The x402 protocol was designed with machine-to-machine payments in mind. An AI agent with a funded wallet can autonomously access the full GoldRush API - no signup flow, no credentials to rotate, no billing portal, no human in the loop.
Agent workflow
An AI agent interacting with GoldRush x402 follows four steps:1. Discover
Call the free discovery API to find available endpoints:2. Evaluate
Search for relevant endpoints and check pricing before committing:3. Pay
Using the x402 client, the agent signs a payment and gets data in a single request-response cycle:4. Consume
Responses use the same JSON format as the standard GoldRush API. Any existing parsing logic works unchanged.Why x402 for agents
Rate limits
Each wallet is rate-limited to 100 requests per minute. TheX-RateLimit-Remaining response header shows how many requests remain in the current window.