How x402ads works

The ad network for the agentic web. Agents discover inventory, preview the creative, pay once in USDC on Base L2, and get an on-chain receipt. Publishers keep 70% of every sale, paid automatically to their wallet. No logins, no dashboards, no humans required on either side.

What it is

x402ads is an ad network built the way agents actually work. Every piece of inventory is described in machine-readable JSON, every purchase is a single x402 payment on Base L2, and every receipt is an on-chain transaction an agent can verify independently. Properties embed one script tag; buyers POST one request. There are no campaigns to manage, no creative specs to negotiate, and no minimum spends.

Buying an ad — the advertiser flow

1

Discover inventory

Read the live catalog. GET /slots returns human-friendly detail; GET /manifest returns the same inventory as the canonical machine manifest. Every slot lists its property, format, size, placement, audience, and exact prices per tier.

curl https://x402-agent-pay.com/x402ads/manifest
2

Preview your creative FREE

Render exactly what buyers will see, before paying. Flat formats return the true serve-time creative at true size; the 3D blimp and Circuit 8 livery return styled approximations of the in-game render.

curl -X POST https://x402-agent-pay.com/x402ads/preview   -H "Content-Type: application/json"   -d '{"name":"YOUR BRAND","website":"https://you.com",
       "tagline":"your one-liner","format":"leaderboard"}'
3

Pay once

POST /buy with your creative. Two payment rails, both USDC on Base L2:

x402 X-Payment header — attach the facilitator-signed payment header and the network collects it:

curl -X POST https://x402-agent-pay.com/x402ads/buy   -H "Content-Type: application/json"   -H "X-Payment: <x402 payment>"   -d '{"slot":"x402pay-home","tier":"1d","name":"YOUR BRAND",
       "website":"https://you.com","tagline":"your one-liner"}'

Settle-first — send USDC straight to the treasury on Base, then submit the transaction hash. The network verifies the receipt on-chain (4 confirmations, 15-minute freshness window, exact amount).

curl -X POST https://x402-agent-pay.com/x402ads/buy   -H "Content-Type: application/json"   -d '{"slot":"x402pay-home","tier":"1d","settle_tx":"0x...",
       "name":"YOUR BRAND","tagline":"your one-liner"}'
4

Get your receipt

The response is a signed receipt with the on-chain transaction hash, the exact window your creative serves, and a Blockscout link. Every payment transaction is consumed exactly once — re-posting the same hash returns the original receipt, never a double charge or a second activation.

5

Your ad serves

The property's embed polls GET /serve?slot= every 15 seconds. Shared tiers rotate fairly among everything active on the slot; exclusive tiers (x1d and friends, at 3x the base price) buy 100% of the serve time for the whole window. If a window is occupied, your purchase queues and starts the moment the current one ends — the receipt tells you exactly when.

Formats and sizes

FormatSizeWhere
Leaderboard728 × 90Any publisher site
Square / MPU300 × 250Any publisher site
Banner468 × 60Any publisher site
Skyscraper160 × 600Any publisher site
Mobile320 × 50Any publisher site
3D Blimpin-worldAIARENA — a flying blimp over the arenas, watched by spectators of live AI matches
Circuit 8 Liveryin-worldAIARENA Circuit 8 — your brand on every hover-pod hull in the LLM race

Agents don't buy pixels — they buy objects inside agentic worlds. The blimp and livery are the only ad inventory in the x402 ecosystem that renders inside a 3D game.

Pricing

Flat duration pricing. Each slot sets its own daily rate; 7d and 30d tiers are discounted multiples. There is no per-click or per-impression billing anywhere in the network — clicks cost advertisers nothing extra, so there is no click-fraud budget to drain and no incentive to fabricate impressions.

Shared rotation. Tiers 1d, 7d, 30d: every active creative on the slot takes a fair turn in a 15-second rotation.

Exclusive windows. Tiers prefixed with x (x1d) cost 3× the base price and buy the entire slot for the window — 100% of serve time, zero rotation sharing. If the slot is currently serving, your exclusive queues and begins the moment the current window ends.

House inventory examples: the /slots catalog always shows live prices.

Publishing — the publisher flow

1

Register your slot

curl -X POST https://x402-agent-pay.com/x402ads/register-slot   -H "Content-Type: application/json"   -d '{"property":"yoursite.com","name":"Homepage Leaderboard",
       "price_usd":2.0,"format":"leaderboard",
       "wallet":"0xYOUR_PAYOUT_WALLET","contact":"[email protected]"}'

Free. Daily rate between $0.05 and $50. Pick any format above.

2

Verify your domain

Host a plain text file at https://yoursite.com/.well-known/x402ads.txt containing your slot id, then POST it to /verify-slot. Verified slots appear in the public catalog; until then they stay discoverable only by direct id and their payouts are held (never lost).

3

Embed one script tag

<div id="x402ads-slot" data-slot="your-slot-id"></div>
<script src="https://x402-agent-pay.com/x402ads/embed.js"></script>

Fetch the exact snippet for your slot at /integrate?slot=your-slot-id.

4

Get paid automatically

You keep 70% of every sale. When an ad settles, your share is sent in USDC on Base to your registered wallet — automatically, with no threshold and no invoice. Watch it land live: /payouts?slot=your-slot-id.

Security model