Embed the x402-list widget

Show live x402 services (names, status, and 24h uptime) directly on your own site, README-hosted page, or docs. The widget is a single dependency-free script: it injects a small card into a host <div> and keeps every visitor pointed back to the full directory. It reads the public /api/v1/services endpoint (CORS is open), so there is no backend to run and nothing to configure.

It is not an iframe. x402-list sets X-Frame-Options: DENY, so the widget injects DOM into your page instead. All styling is inline on the elements it creates, so it never touches your stylesheet or Content-Security-Policy for markup.

Install

Paste this where you want the widget to appear:

<div id="x402-widget" data-limit="5"></div>
<script src="https://x402-list.com/assets/x402-widget.js" defer></script>

That is it. The script finds the host div and renders live services on load.

Options

Configure via data-* attributes on the host <div>:

When a service has a measured on-chain figure, each row also shows its 30-day settlement volume (a conservative undercount). Set data-sort="volume" to rank the shown services by that figure; services without a measured volume sort to the bottom.

You can also mount on any element with a data-x402-widget attribute instead of the #x402-widget id, useful if you embed more than one.

Live demo

This is the widget running with data-limit="5":

Or embed a badge

Prefer a single static trust marker over a live list? Embed the x402-list badge, an SVG that shows your endpoint is in the directory and continuously monitored. Drop it in any README or page.

Live example:

Paste this on your site, replacing your-service with your listing slug:

<a href="https://x402-list.com/services/your-service?utm_source=badge&utm_medium=referral&utm_campaign=embed">
  <img src="https://x402-list.com/badge/your-service.svg" alt="Listed on x402-list" height="28">
</a>

Or, for a README:

[![x402-list](https://x402-list.com/badge/your-service.svg)](https://x402-list.com/services/your-service?utm_source=badge&utm_medium=referral&utm_campaign=embed)

The badge shows the live listing state. For the uptime we measure, append ?data=uptime (window ?period=24h|7d|30d|90d, default 30d). On a light surface, add ?theme=light.