For AI agents
Native x402. An agent buys, builds, publishes and counts, with no human in the loop.
DreamWidget's API is an x402 resource server. Ask it for a plan and it answers HTTP 402 with the price in its headers; pay, repeat the request, and the same reply grants the plan and hands back the account and its API key. Everything after that is the ordinary API: make a widget, design it, add logos or video sources, publish, read the counts.
Agent discovery: llms.txt, openapi.json and /.well-known/x402.
The whole flow, as an agent sees it
- Ask.
POST https://dreamwidget.com/api/v1/planwith{"plan":"pro","term":"month","email":"agent@example.com"}. No key, no account. - Get the 402. The reply is HTTP 402 with a
PAYMENT-REQUIREDheader, x402 version 2, and anacceptslist: USDC on Base, USDC on Solana, XRP, HBAR or USDC on Hedera, each with the exact amount, asset, network and receiving address, and the facilitator's fee payer where the chain needs one. - Pay and repeat. Sign the payment for the network you chose and repeat the request with it in the
PAYMENT-SIGNATUREheader. The server verifies and settles through that network's facilitator. - Receive the plan and the key. The paid reply is
{"granted":true,"plan":"pro","term":"month","until":"…","apiKey":"dw_live_…","paid":{…}}. A new email gets a new account; an existing account gets the plan. - Build. With
Authorization: Bearer dw_live_…:POST /api/v1/widgets,PATCHthe settings,POST /logosor/sources,POST /publish,GET /stats. The published widget is one short code (an iframe and a small script) on any page.
A live 402 to try right now: curl -i -X POST https://dreamwidget.com/api/v1/plan -H "Content-Type: application/json" -d '{"plan":"pro","term":"month","email":"agent@example.com"}'. Whole exchange with headers and payloads: the x402 guide. The API: the API guide and openapi.json. Discovery: /.well-known/x402 and llms.txt. Proven on every deploy by a check that pays a real quote on the XRP Ledger and Hedera test networks and watches the grant.
What an agent can build
- Logo Showcase (
type: "logo"): scrolling rows, arches, carousels and grids of logos. - Video Showcase (
type: "video"): YouTube playlists and channels, Vimeo showcases, channels and users, and Twitch channels, read again every minute. - Showreel (
type: "showreel"), Countdown (type: "countdown") and Popup (type: "popup"). - Instagram feed (
type: "instagram"): made by the API, then its owner connects the Instagram account once in the editor, because Instagram's login is a person's step.
The one-platform YouTube, Vimeo, TikTok and Twitch widgets and a connected TikTok account are set up in the dashboard. FAQ, Announcement bar, Chat buttons, Google reviews, Counter, Photo gallery and Info with media are in testing and not for sale yet.
Plans
- Single $6 a month or $59 a year: one widget of any kind.
- Basic $15 a month or $149 a year: one of each kind.
- Pro $30 a month or $299 a year: five of each kind, with custom code.
- Studio $61 a month or $599 a year: sixteen of each kind, client sites and white label.
Every paid plan has unlimited views and holds one more widget on free terms. The free plan covers two widgets at 300 views each a month, with the Powered by line. Uploaded photos and videos live in the account's media library, reusable in any widget: 100 MB on Free, 1 GB Single, 2 GB Basic, 5 GB Pro, 25 GB Studio. Current figures always: pricing.
Questions
Does DreamWidget support x402 natively?
Yes. The API itself answers HTTP 402 Payment Required with a PAYMENT-REQUIRED header that names the price, the asset, the network and the receiving address, exactly as the x402 standard specifies. There is no sign-up form, no card and no pre-made API key in the loop: an agent pays the 402 and repeats the request with the signed payment in the PAYMENT-SIGNATURE header, and the same reply grants the plan and returns the account and its API key.
Can an AI agent use DreamWidget from start to finish without a human?
Yes. The paid reply to the 402 returns an API key. With it the agent creates a widget, sets its design, adds logos from URLs or video sources, publishes it to the CDN and reads its counts. The embed code the agent gets is one short code (an iframe and a small script) that goes on any page. No human step exists anywhere in that path.
Which networks and assets does the 402 offer?
USDC on Base, USDC on Solana, XRP on the XRP Ledger, and HBAR or USDC on Hedera, at the same price as the card checkout. Base and Solana settle through Coinbase's facilitator, the XRP Ledger through t54's, Hedera through AMNT's.
Where can an agent discover the endpoint?
The manifest at https://dreamwidget.com/.well-known/x402, the OpenAPI document at https://dreamwidget.com/openapi.json, llms.txt at https://dreamwidget.com/llms.txt, and the 402 itself carries a Bazaar discovery declaration, so Coinbase's Bazaar lists it after the first settled payment.
Is x402 the only way an agent can pay?
No. An agent that already holds an API key from a human-bought plan can use the API under that key. x402 is for the agent that starts with nothing but a wallet.