x402 Protokol: Jak HTTP 402
Payment Required mění internet
pro AI agenty a Web3

Proč byl HTTP 402 mrtvý 34 let — a proč ho AI a Web3 křísí

Byl rok 1991. Tim Berners-Lee a tým IETF psali specifikaci HTTP a do ní zahrnuli status kód 402 Payment Required. Záměr byl elegantní: server řekne klientovi „nejdřív zaplať, pak dostaneš data." Internet-native mikroplatby přímo v protokolu.

Kód 402 byl označen jako „rezervováno pro budoucí použití" a zůstal tak celých 34 let. Proč? Protože chyběla infrastruktura. Žádná platební síť nedokázala přesunout 0,001 USD přes API endpoint s poplatkem nižším, než je samotná platba. Banky, PayPal, Stripe — všichni navrženi pro transakce v řádech dolarů, ne mikrocentů.

2024–2025. Dvě technologie konečně dozrály. Za prvé: L2 blockchainové sítě (Base od Coinbase, Optimism, Arbitrum) zpracují transakci 0,001 USD s gas fee pod 0,0001 USD — ekonomika mikroplateb funguje. Za druhé: autonomní AI agenti (LangChain, AutoGPT, Anthropic agent frameworks) potřebují platit za API data v reálném čase — ale nemají kreditní kartu. Mají pouze wallet adresu.

Proto tým z Coinbase navrhl x402 — oživení HTTP 402 pro 21. století, Internet-Native Payments Standard. A internet se začíná měnit.

Jak x402 technicky funguje — kompletní anatomie

x402 není nový blockchain ani nová kryptoměna. Je to konvence na vrstvě HTTP — standardizovaná sada hlaviček a JSON struktury, která definuje, jak server komunikuje platební požadavek a jak klient (nebo AI agent) reaguje. Technologicky agnostické, implementačně jednoduché.

HTTP 402 — stavový kód s novou silou

Když server narazí na request bez platby, vrátí HTTP 402 Payment Required s JSON payloadem popisujícím podmínky:

HTTP/1.1 402 Payment Required

Content-Type: application/json



// Platební instrukce pro klienta nebo AI agenta

{

  "x402Version": 1,

  "accepts": [

    {

      "scheme": "exact",

      "network": "base",             // Base L2 mainnet

      "maxAmountRequired": "1000",    // 0.001 USDC (6 decimals)

      "asset": "0x833589fCD6eDb...",  // USDC contract na Base

      "payTo": "0x742d35Cc6627..."   // adresa příjemce platby

    }

  ],

  "error": "Payment required for Weather API access"

}

EIP-3009 — elegantní srdce protokolu

Klíčová technologie za x402 je EIP-3009 (Transfer With Authorization) — Ethereum standard pro podpis tokenového převodu bez nutnosti okamžité on-chain transakce. Klient podepíše převod svým private key a pošle podpis jako HTTP hlavičku:

GET /api/weather?lat=50.08&lng=14.42 HTTP/1.1

Host: weather-api.example.com

X-Payment: "eyJwYXltZW50UGF5bG9hZCI6eyJmcm9tIjoiMHg0M..."



// X-Payment je base64(JSON) obsahující:

// - from: adresa plátce

// - to: adresa příjemce (server)

// - value: 1000 (0.001 USDC)

// - validAfter, validBefore: časové okno

// - nonce: replay-attack protection

// - v, r, s: ECDSA podpis plátce

Ultimátní implementační průvodce — od nuly k prvnímu x402 endpointu

Ukážeme kompletní implementaci v Node.js/Express a Python. Klíčový insight: veškerá platební logika žije v middleware vrstvě — vaše business logika zůstane čistá.

Node.js / Express — serverová implementace

import { paymentMiddleware, Network } from "x402-express";

import express from "express";



const app = express();



// ── Jeden řádek = kompletní x402 ochrana všech endpointů ──

app.use(

  paymentMiddleware(

    "0x742d35Cc...",    // vaše přijímací wallet adresa

    {

      "/api/weather": {

        price: "$0.001",

        network: Network.Base,

        config: { description: "Weather API — single query" }

      },

      "/api/premium/*": {

        price: "$0.05",

        network: Network.Base

      },

      "/api/gpu-render": {

        price: "$0.0008",          // platba za GPU-sekundu

        network: Network.Base

      }

    }

  )

);



// Váš endpoint — bez JEDINÉHO řádku platební logiky!

app.get("/api/weather", (req, res) => {

  res.json({ temp: 18.5, humidity: 62, city: "Prague" });

});



app.listen(3000, () => console.log("x402 server běží"));

Python / FastAPI — serverová implementace

from fastapi import FastAPI

from x402.fastapi import x402_middleware



app = FastAPI()



# Middleware přidá x402 ochranu na vybrané endpointy

app.add_middleware(

    x402_middleware,

    pay_to="0x742d35Cc...",

    routes={

        "/weather": {"price": "$0.001", "network": "base"},

        "/premium/{slug}": {"price": "$0.05", "network": "base"}

    }

)



# Endpoint — čistá business logika, nulová platební logika

@app.get("/weather")

async def get_weather(lat: float, lng: float):

    return {"temp": 18.5, "humidity": 62, "city": "Prague"}

AI agent klient (Python + LangChain)

from x402.client import X402Client

from eth_account import Account

import os



# Wallet agenta — private key bezpečně v env, nebo HSM

wallet = Account.from_key(os.environ["AGENT_PRIVATE_KEY"])

client = X402Client(wallet=wallet, max_per_request="$0.10")



# Agent volá API — x402 client zpracuje platbu AUTOMATICKY:

# 1. Pošle GET request

# 2. Dostane 402 → přečte instrukce

# 3. Podepíše EIP-3009 → pošle retry s X-Payment

# 4. Vrátí finální data  →  vše za ~400ms

response = await client.get(

    "https://weather-api.io/v1/current",

    params={"lat": 50.08, "lng": 14.42}

)



print(response.json())

# {"temp": 18.5, "humidity": 62}

# Zaplaceno: 0.001 USDC · tx: 0xfe3a...b91c

x402 a autonomní AI agenti — zrod Machine-to-Machine ekonomiky

Toto je místo, kde se x402 mění z „zajímavého standardu" na potenciálně transformativní infrastrukturu. Zde je ten skutečný háček:

Agent-to-Agent ekonomika — agenti platí agentům

Nejprovokativnější aspekt x402 není AI-to-server platba. Je to agent-to-agent ekonomika: orchestrátor agent deleguje dílčí úkoly specializovaným sub-agentům a platí jim v USDC za výsledky. Každý sub-agent má vlastní wallet. Platby jsou on-chain auditovatelné automaticky.

# Orchestrátor agent řídí 3 specializované sub-agenty

# Každý sub-agent má vlastní x402 wallet a monetizuje své výpočty



class EnergyOptimizerOrchestrator:

    def __init__(self):

        self.weather_agent = X402Client(wallet=WEATHER_AGENT_WALLET)

        self.price_agent   = X402Client(wallet=PRICE_AGENT_WALLET)

        self.grid_agent    = X402Client(wallet=GRID_AGENT_WALLET)



    async def optimize(self, locations: list):

        # Paralelní requesty — každý platí sub-agent svým walletem

        weather, prices, grid = await asyncio.gather(

            self.weather_agent.get("https://weather.io/bulk",

                                   json={"locations": locations}),

            self.price_agent.get("https://energy-market.eu/spot"),

            self.grid_agent.get("https://grid-data.cz/realtime")

        )

        # Celkem zaplaceno: ~0.003 USDC za kompletní datový snímek

        # Auditní trail: 3 on-chain záznamy, automaticky

        return self._optimize_dispatch(weather, prices, grid)

Toto je zárodek Agentic Economy — ekonomického systému, kde autonomní softwaroví agenti jsou plnohodnotnými ekonomickými aktéry se svými příjmy, výdaji a daňovými záznamy. x402 poskytuje platební primitiva pro tento svět.

Výhody vs. nevýhody x402 — bez marketingového lesku

x402 přináší reálné výhody. Ale intelektuální poctivost vyžaduje pojmenovat i existující výzvy:

Tři konkrétní use cases — x402 v praxi budoucnosti

Skutečná síla nastane, když se tyto use cases kompozičně propojí: AI agent platí za GPU výpočty (use case #3), které zpracovávají data zaplacená přes x402 (use case #1), jejichž výstupy jsou publikovány na platformě monetizované pay-per-read (use case #2). Celá ekonomická vrstva funguje autonomně, on-chain, bez bankovního prostředníka. Toto je příslib Composable Money Lego.

x402 na českém trhu — kontext, regulace a komunita

Implementovat x402 v Česku v roce 2025 znamená pohybovat se na úplné hraně technologie, kde dokumentace teprve vzniká a komunita je globálně malá. Na domácím trhu je situace ještě vyhraněnější: zázemí pro Web3 platební standardy je minimum a znalost lokálního regulatorního kontextu je klíčová.

Dva aspekty jsou pro českou implementaci kritické. Za prvé: MiCA regulace (Markets in Crypto-Assets), která vstoupila v platnost pro stablecoiny v červnu 2024, definuje, jak mohou být USDC platby provozovány v EU prostředí. Za druhé: ČNB stanoviska k virtuálním aktivům — nutné pro jakýkoliv projekt obsluhující české nebo slovenské zákazníky.

Nejčastější otázky o x402 protokolu

Závěr: HTTP 402 byl před svou dobou — ta doba právě přišla

Roku 1991 byl Tim Berners-Lee vizionář, který viděl budoucnost, pro kterou ještě neexistovala infrastruktura. Status kód 402 byl správnou myšlenkou ve špatném čase.

L2 blockchainy vyřešily ekonomiku mikroplateb. Stablecoiny jako USDC vyřešily volatilitu. EIP-3009 vyřešil latenci. Autonomní AI agenti vytvořili poptávku, která celému systému dává smysl. Protokol x402 tyto čtyři linie svazuje do standardizovaného, interoperabilního platebního primitiva pro nový internet.

Nejde o to, zda x402 uspěje. Otázka je, jak rychle se stane standardem — a jestli budete mezi prvními, kdo ho implementují, nebo mezi posledními, kdo budou dohánět konkurenci.