Request the service
GET /service
BlockX’s protocol design proposes native x402 payments for AI agents, pairing HTTP 402 service requests with signed vouchers and on-chain settlement. Follow the upgrade roadmap for rollout status.
x402 turns the long-reserved HTTP 402 status code into a machine-readable payment protocol. BlockX runs it as a four-step handshake between any HTTP client, such as an AI agent, and any HTTP server, such as a service provider.
GET /service
The service answers with HTTP 402 and a payment descriptor that states what it costs.
The agent submits a signed MsgX402Pay transaction.
The node returns a settlement proof and the service delivers with 200 OK.
The full handshake completes in under 50ms at the protocol layer.
Steps 3 and 4 are atomic on-chain, so service delivery is cryptographically guaranteed once payment settles.
Agentic commerce needs tens of millions of micropayments a day. Putting x402 inside a smart contract creates five bottlenecks that a protocol-native design avoids.
A service provider needs payment confirmation before it delivers. Contract-based x402 adds 400–800ms of blockchain overhead plus EVM execution time, which makes real-time API billing impractical for high-frequency agents.
EVM contracts burn gas even to route a simple payment. For a $0.001 micropayment, gas of $0.05–0.50 makes the transaction uneconomical, and agents need millions of these every day.
In the contract model, payment and service delivery are separate events. Payment can confirm at block N while delivery happens at block N+2. That gap invites failures, disputes and exploits, and a failed delivery after payment has no automatic resolution.
Every smart contract is a programmable surface. Reentrancy, integer overflows, front-running and oracle manipulation have drained billions from DeFi. Adding that complexity to the critical payment path is an avoidable security trade-off.
Payment protocols must keep changing as new agent types and dispute mechanisms appear. Contract upgrades need proxy patterns, migration logic and careful governance. Protocol-level upgrades through Cosmos SDK governance are more controlled, auditable and backward-compatible.
| Requirement | Existing solutions | BlockX native x402 |
|---|---|---|
| Settlement speed for API billing | 400–2000ms (smart contracts) | Under 50ms, protocol-native |
| Transaction cost for micropayments | Gas fees make micropayments uneconomical | Base fee of 0.0001 BCX |
| Agent identity verification | None: off-chain OAuth, no on-chain standard | AgentRegistry: on-chain and verifiable |
| Payment and service atomicity | Split across two systems, with failure risk | Single atomic x402 handshake |
| Web2 developer access | Requires blockchain expertise | HTTP 402 header and standard REST |
| Agent spending policy enforcement | Off-chain, application layer only | On-chain programmable spending limits |
A service provider adds three lines to its API response headers. An agent adds a payment header to its request. There is no blockchain SDK to install, no wallet management and no gas estimation, because the payment happens inside the normal request and response cycle.
| Integration path | Developer requirement | Time to integrate |
|---|---|---|
| Web2 REST API (existing) | Add x402 headers to an existing Express or FastAPI endpoint | Hours |
| New agent-native API | Use the BlockX SDK, which generates descriptors automatically | Days |
| Smart contract dApp | EVM-compatible, so Solidity contracts work natively | Days to weeks |
| Web2 frontend with agents | Standard MetaMask or WalletConnect integration for the user wallet | Days |
From the user setting a goal to an on-chain audit record, in eight steps.
Read the whitepaper for the full protocol design, or see how the consensus modules fit together.