GuardX402
Documentation
The policy and audit layer for AI agents making x402 payments.
OWS handles
- ๐ Secure private key storage
- โ๏ธ Transaction signing
- ๐ 9 chains supported
- ๐ฆ Wallet creation & management
GuardX402 handles
- ๐ Spend policy enforcement
- ๐ฐ Budget tracking & alerts
- ๐ Tamper-evident audit logs
- ๐ฅ Team access controls
Payment flow
Quick Start
Up and running in under 5 minutes.
Sign up at guardx402.com
Create a free account, register your first agent, and copy your API key from the dashboard.
Install OWS (recommended)
npm install @open-wallet-standard/core
Add to your agent
import { createWallet, signMessage } from '@open-wallet-standard/core'; const wallet = createWallet('my-agent'); const check = await fetch('https://guardx402.com/api/guard/check', { method: 'POST', headers: { 'Content-Type': 'application/json', 'x-api-key': 'ng_your_key_here' }, body: JSON.stringify({ endpoint: 'https://api.perplexity.ai/chat', amount: 0.002, chain: 'BASE', owsSigned: true }) }); const { approved, auditId } = await check.json(); if (!approved) throw new Error('Blocked'); // OWS signs the payment const sig = await signMessage(wallet, 'evm', canonicalMessage); await fetch('https://guardx402.com/api/guard/confirm', { method: 'POST', headers: { 'x-api-key': 'ng_your_key_here' }, body: JSON.stringify({ auditId, txHash: sig, owsSigned: true }) });
/api/guard/check
Check a payment against policy before executing. Call before every x402 payment.
Required header: x-api-key: ng_your_key_here
Request body
{
"endpoint": "https://api.perplexity.ai/chat",
"amount": 0.002,
"chain": "SOL",
"owsSigned": true
}| Field | Type | Description |
|---|---|---|
| endpoint | string | Full URL being paid |
| amount | number | USDC amount from 402 response |
| chain | SOL | BASE | Chain for payment |
| owsSigned | boolean | Whether OWS will handle signing |
Response
{
"approved": true,
"agentId": "agent-abc123",
"budgetRemaining": 4.998,
"budgetLimit": 5.00,
"auditId": "audit-xyz789",
"owsSigned": true,
"owsSignature": "255880b9a220139a..."
}Block reasons
| reason | Description |
|---|---|
| budget_exceeded | Would exceed daily/weekly/monthly USDC limit |
| per_call_max | Single call exceeds per-call maximum |
| domain_blocked | Domain not in allowed list (Pro) |
| velocity_exceeded | Too many calls per hour (Pro) |
| agent_paused | Agent paused by team owner |
/api/guard/confirm
Log the on-chain transaction hash after payment settles. Always call this to complete the audit record.
Request body
{
"auditId": "audit-xyz789",
"txHash": "0xabc123...",
"owsSigned": true
}Response
{ "success": true, "auditId": "audit-xyz789" }Policy Options
Configure per-agent spend policies from the dashboard or via the policy API.
| Setting | Free | Premium | Pro | Description |
|---|---|---|---|---|
| Budget limit | โ | โ | โ | Max USDC per period |
| Per-call max | โ | โ | โ | Max USDC per payment |
| Alert threshold | โ | โ | โ | % of budget to trigger alert |
| Webhook alerts | โ | โ | โ | POST alerts to your endpoint (Premium+) |
| CSV export | โ | โ | โ | Download audit log as CSV (Premium+) |
| Velocity controls | โ | โ | โ | Max calls per hour (Pro) |
| Domain allowlist | โ | โ | โ | Only pay approved domains (Pro) |
Built on Open Wallet Standard
GuardX402 is built on the Open Wallet Standard by MoonPay. OWS handles the wallet; GuardX402 handles the rules.
OWS role
- ๐ Encrypted key storage at
~/.ows/ - โ๏ธ Signs transactions โ private keys never leave the device
- ๐ Supports 9 chains including Solana and Base
- ๐ฆ Simple SDK:
createWallet,signMessage
GuardX402 role
- ๐ Policy enforcement before every payment
- ๐ฐ Budget tracking in real time
- ๐ Alert your team at threshold
- ๐ 90-day tamper-evident audit log (Pro)
import { createWallet } from '@open-wallet-standard/core'; // Encrypted at ~/.ows/ โ keys never in env vars or code const wallet = createWallet('my-agent-name'); // EVM (Base): 0xb6E4641B6deCd8D8133C74DA00D5C021d4Bd8Da7 // Solana: 8HG7kQEsb28LW4ngRZTdmenHWfJfTGPT5Lfzc5RY6cHe
Frameworks
GuardX402 works with any agent framework โ just HTTP POST.
Open Wallet Standard
OWSNative OWS signing. Keys encrypted at rest.
npm install @open-wallet-standard/core
LangChain
PythonAdd as a @tool in any LangChain agent.
pip install langchain requests
CrewAI
PythonWrap as a BaseTool in any CrewAI crew.
pip install crewai
AutoGen
PythonRegister as a function call in AutoGen llm_config.
pip install pyautogen
Custom REST
AnyAny language that can send an HTTP POST request.
curl -X POST https://guardx402.com/api/guard/check \
Plans
Start free. Upgrade when you need more.
Free
$0/mo
- โ 1 agent
- โ 1 team seat
- โ 5,000 checks/mo
- โ 7-day audit history
- โ Budget & per-call limits
- โ Webhook alerts
- โ CSV export
Premium
$15/mo
- โ 5 agents
- โ 3 team seats
- โ 10,000 checks/mo
- โ 30-day audit history
- โ Basic policy controls
- โ Webhook alerts
- โ CSV export
Pro
$35/mo
- โ Unlimited agents
- โ 10 team seats
- โ 50,000 checks/mo
- โ 90-day audit history
- โ Velocity controls
- โ Domain allowlist
- โ Webhook alerts & CSV export
About
"The agentic economy needs guardrails. GuardX402 is the policy layer that makes AI agent payments safe for everyone โ from solo developers to enterprise teams."
Luana Cantu
๐ Miami, FLLead Architect ยท Full-Stack Developer ยท Developer Advocate
Founder of NodusAI โ AI-powered prediction market research oracle. Builder at the intersection of AI, Web3, and SaaS. Previously CMO at KOKODI Games, Creative Director at Flying Rhino Web3 Marketing Agency across 5 regions. Inaugural subject of Avalanche's Proof of Thought #001.
Our Mission
AI agents are moving real money โ autonomously, without guardrails. GuardX402 exists to make sure every x402 payment an AI agent makes is intentional, authorized, and audited. We believe the agentic economy needs the same financial controls that humans take for granted โ budgets, limits, audit trails, and the ability to say no.
Built for the OWS Hackathon
GuardX402 was built for the Open Wallet Standard Hackathon โ three rounds of building on the OWS protocol by MoonPay. The hackathon challenged builders to create real products on top of OWS, the open-source standard that gives AI agents a secure, universal way to hold value and sign transactions.
hackathon.openwallet.sh โBuild timeline
Morning
Concept + architecture + database schema
Afternoon
Core guard check API + Redis + OWS integration
Evening
Dashboard + Crossmint auth + onboarding flow
Night
Docs + GitHub + guardx402.com live
Media Kit
Brand assets, colors, and boilerplate for press and integrations.
Brand name
Tagline
Stop Runaway Agent Spend.
One-liner
GuardX402 is the policy and audit layer for AI agents making x402 payments on Solana and Base. Built on the Open Wallet Standard.
Logo assets

Logo variant 1

Logo variant 2
Brand colors
Brand Blue
#3d88d9Dark Navy
#1a2744Shield Steel
#6b9fd4Energy Violet
#7C3AEDCloud Lavender
#c8d8f0Spark White
#ffffffBackground
#F8F9FBDark Text
#0F172AKey facts
Boilerplate
GuardX402 is an open-source x402 spend control platform for AI agents. Built on the Open Wallet Standard (OWS) by MoonPay, GuardX402 enforces budget policies, blocks overspend, and provides real-time audit logs for every x402 payment on Solana and Base. Free plan available. Premium at $15/mo. Pro plan at $35/mo. Live at guardx402.com. Press contact: X: @luacantu GitHub: github.com/luacantu/guardx402 Built by: Luana Cantu ยท luacantu.com