Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
<!doctype html>
<html lang="en">
<head>
<script>/* three.ws theme boot — no-flash; runtime in /theme-switcher.js */(function(){document.documentElement.classList.add('js');try{var m=localStorage.getItem('twx_theme');var l=m==='auto'?(window.matchMedia&&window.matchMedia('(prefers-color-scheme: light)').matches):m==='light';document.documentElement.setAttribute('data-theme',l?'light':'dark');}catch(e){document.documentElement.setAttribute('data-theme','dark');}})();</script>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
<title data-i18n="crypto_api.meta_title">Crypto API — one free, keyless API for on-chain data · three.ws</title>
<meta
name="description"
content="One free API for crypto data: DEX pairs, prices, quotes, TVL, on-chain reads, name resolution. No key, no wallet. Generous free tier, pay-per-call only above quota. Live registry, OpenAPI 3.1 spec included."
data-i18n-attr="content:crypto_api.meta_description"/>
<meta name="robots" content="index, follow" />
<link rel="canonical" href="https://three.ws/crypto-api" />
<meta property="og:type" content="website" />
<meta property="og:site_name" content="three.ws" />
<meta property="og:title" content="Crypto API — one free, keyless API for on-chain data · three.ws" data-i18n-attr="content:crypto_api.meta_og_title"/>
<meta
property="og:description"
content="DEX pairs, prices, quotes, TVL, on-chain reads, name resolution — one free API, no key, no wallet. Pay-per-call only above the free quota."
data-i18n-attr="content:crypto_api.meta_og_description"/>
<meta property="og:url" content="https://three.ws/crypto-api" />
<meta property="og:image" content="https://three.ws/api/page-og?s=learn&t=Crypto+API&d=One+free%2C+keyless+API+for+on-chain+and+market+data%3A+DEX+pairs%2C+prices%2C+swap+quotes%2C+TVL%2C+Solana+RPC+reads%2C+and+ENS%2FSNS+name+resolution%3A+CoinGecko%2C+DefiLlama&p=%2Fcrypto-api" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="Crypto API — one free, keyless API for on-chain data · three.ws" data-i18n-attr="content:crypto_api.meta_twitter_title"/>
<meta
name="twitter:description"
content="DEX pairs, prices, quotes, TVL, on-chain reads, name resolution — free, keyless, one fetch."
data-i18n-attr="content:crypto_api.meta_twitter_description"/>
<meta name="twitter:image" content="https://three.ws/api/page-og?s=learn&t=Crypto+API&d=One+free%2C+keyless+API+for+on-chain+and+market+data%3A+DEX+pairs%2C+prices%2C+swap+quotes%2C+TVL%2C+Solana+RPC+reads%2C+and+ENS%2FSNS+name+resolution%3A+CoinGecko%2C+DefiLlama&p=%2Fcrypto-api" />
<link rel="icon" href="/favicon.ico" sizes="any" />
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
<link rel="apple-touch-icon" href="/apple-touch-icon.png" />
<link rel="manifest" href="/manifest.webmanifest" />
<link rel="stylesheet" href="/style.css" />
<link rel="stylesheet" href="/nav.css" />
<link rel="stylesheet" href="/footer.css" />
<link rel="stylesheet" href="/fonts/fonts.css" />
<link rel="stylesheet" href="/mobile.css" />
<script defer src="/footer-newsletter.js"></script>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebAPI",
"name": "three.ws Crypto API",
"description": "Free, keyless aggregator API for crypto/DeFi/on-chain data: DEX pairs, prices, swap quotes, TVL, Solana RPC reads, and ENS/SNS name resolution — bundled from CoinGecko, DefiLlama, Jupiter, DexScreener and Solana RPC behind one bill.",
"url": "https://three.ws/crypto-api",
"documentation": "https://three.ws/openapi.json",
"provider": { "@type": "Organization", "name": "three.ws", "url": "https://three.ws" },
"offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" }
}
</script>
<style>
/* ─────────────────────────────────────────────────────────────
/crypto-api — Crypto API aggregator storefront. All values come
from the design tokens in /tokens.css (loaded via /style.css).
───────────────────────────────────────────────────────────── */
.ca-main { max-width: 1100px; margin: 0 auto; padding: 0 var(--space-lg) var(--space-2xl); width: 100%; }
.ca-main :where(h2) {
font: var(--weight-bold) var(--text-2xl) / var(--leading-tight) var(--font-display);
color: var(--ink-bright); margin: 0 0 var(--space-xs); letter-spacing: -0.01em;
}
.ca-section { padding-block: var(--space-2xl); border-top: 1px solid var(--stroke); }
.ca-section:first-of-type { border-top: 0; }
.ca-section-lede { color: var(--ink-dim); max-width: 62ch; margin: 0 0 var(--space-lg); line-height: var(--leading-normal); }
/* ── Hero ─────────────────────────────────────────────────── */
.ca-hero { position: relative; text-align: center; padding: clamp(var(--space-2xl), 8vw, 6rem) var(--space-lg) var(--space-2xl); max-width: 1100px; margin: 0 auto; overflow: hidden; }
.ca-hero::before {
content: ""; position: absolute; inset: -40% 0 auto 0; height: 70%;
background: radial-gradient(60% 100% at 50% 0%, var(--accent-soft), transparent 70%);
pointer-events: none; z-index: -1;
}
.ca-hero .eyebrow { justify-content: center; display: inline-flex; align-items: center; gap: 0.5ch; margin-bottom: var(--space-md); }
.ca-hero h1 { font: var(--weight-bold) clamp(2rem, 6vw, 3.4rem) / 1.05 var(--font-display); color: var(--ink-bright); letter-spacing: -0.02em; margin: 0 auto var(--space-md); max-width: 20ch; }
.ca-hero h1 em { font-style: normal; color: var(--ink-dim); }
.ca-hero-sub { color: var(--ink-dim); font-size: var(--text-lg); line-height: var(--leading-normal); max-width: 58ch; margin: 0 auto var(--space-lg); }
.ca-hero-cta { display: flex; gap: var(--space-sm); justify-content: center; flex-wrap: wrap; }
.ca-badges { display: flex; flex-wrap: wrap; gap: var(--space-2xs); justify-content: center; margin-top: var(--space-lg); }
.ca-badge { display: inline-flex; align-items: center; gap: 0.5ch; font: var(--weight-medium) var(--text-xs) / 1 var(--font-mono); color: var(--ink-dim); background: var(--surface-1); border: 1px solid var(--stroke); padding: 0.5em 0.85em; border-radius: var(--radius-pill); }
.ca-live-pill { display: inline-flex; align-items: center; gap: 0.55ch; font: var(--weight-semibold) var(--text-2xs) / 1 var(--font-mono); text-transform: uppercase; letter-spacing: 0.08em; padding: 0.5em 0.85em; border-radius: var(--radius-pill); background: var(--surface-2); border: 1px solid var(--stroke); color: var(--ink-dim); }
.ca-dot { width: 7px; height: 7px; border-radius: 50%; background: var(--ink-faint); flex: none; }
.ca-dot--live { background: var(--success); box-shadow: 0 0 0 0 var(--success); animation: ca-pulse 2s infinite; }
.ca-dot--err { background: var(--danger); }
@keyframes ca-pulse { 0% { box-shadow: 0 0 0 0 color-mix(in srgb, var(--success) 55%, transparent); } 70% { box-shadow: 0 0 0 6px transparent; } 100% { box-shadow: 0 0 0 0 transparent; } }
@media (prefers-reduced-motion: reduce) { .ca-dot--live { animation: none; } }
/* ── Code block ───────────────────────────────────────────── */
.ca-code { position: relative; background: var(--bg-1); border: 1px solid var(--stroke); border-radius: var(--radius-lg); overflow: hidden; }
.ca-code pre { margin: 0; padding: var(--space-md) var(--space-md); overflow-x: auto; font: var(--weight-regular) var(--text-sm) / 1.6 var(--font-mono); color: var(--ink); tab-size: 2; }
.ca-code code { font: inherit; color: inherit; background: none; white-space: pre; }
.ca-copy { position: absolute; top: var(--space-2xs); right: var(--space-2xs); font: var(--weight-medium) var(--text-2xs) / 1 var(--font-mono); color: var(--ink-dim); background: var(--surface-2); border: 1px solid var(--stroke); padding: 0.5em 0.75em; border-radius: var(--radius-sm); cursor: pointer; display: inline-flex; align-items: center; gap: 0.5ch; transition: color var(--dur-fast, var(--duration-fast)) var(--ease-standard), border-color var(--dur-fast, var(--duration-fast)) var(--ease-standard); }
.ca-copy:hover { color: var(--ink-bright); border-color: var(--stroke-strong); }
.ca-copy:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
.ca-copy.is-done { color: var(--success); border-color: color-mix(in srgb, var(--success) 40%, var(--stroke)); }
.ca-tok { color: var(--ink-faint); } .ca-str { color: var(--success); } .ca-key { color: var(--accent); } .ca-num { color: var(--warn); } .ca-cmd { color: var(--ink-bright); font-weight: var(--weight-medium); }
/* ── Table ────────────────────────────────────────────────── */
.ca-toolbar { display: flex; align-items: center; gap: var(--space-sm); flex-wrap: wrap; margin-bottom: var(--space-md); }
.ca-toolbar input[type=search] {
flex: 1 1 260px; min-width: 200px; background: var(--surface-1); border: 1px solid var(--stroke-strong);
color: var(--ink); padding: 0.6em 1em; font-size: var(--text-sm); border-radius: var(--radius-pill); outline: none;
font-family: var(--font-body);
}
.ca-toolbar input[type=search]:focus-visible { border-color: var(--accent); outline: 2px solid var(--accent); outline-offset: 1px; }
.ca-toolbar .ca-count { color: var(--ink-faint); font-size: var(--text-xs); font-family: var(--font-mono); margin-left: auto; }
.ca-table-wrap { border: 1px solid var(--stroke); border-radius: var(--radius-lg); overflow-x: auto; background: var(--surface-1); }
table.ca-table { width: 100%; border-collapse: collapse; min-width: 760px; font-size: var(--text-sm); }
.ca-table th { text-align: left; font: var(--weight-semibold) var(--text-2xs) / 1 var(--font-mono); text-transform: uppercase; letter-spacing: 0.08em; color: var(--ink-faint); padding: var(--space-sm) var(--space-md); border-bottom: 1px solid var(--stroke); white-space: nowrap; }
.ca-table td { padding: var(--space-sm) var(--space-md); border-bottom: 1px solid var(--stroke); vertical-align: top; }
.ca-table tr:last-child td { border-bottom: 0; }
.ca-table tbody tr { transition: background var(--dur-fast, var(--duration-fast)) var(--ease-standard); }
.ca-table tbody tr:hover { background: var(--surface-2); }
.ca-provider { font-weight: var(--weight-semibold); color: var(--ink-bright); }
.ca-purpose { color: var(--ink-dim); }
.ca-meth { display: inline-block; font: var(--weight-semibold) var(--text-2xs) / 1 var(--font-mono); color: var(--ink); background: var(--surface-2); border: 1px solid var(--stroke); padding: 0.35em 0.55em; border-radius: var(--radius-sm); margin-right: 0.5ch; }
.ca-path { font: var(--weight-regular) var(--text-xs) / 1.4 var(--font-mono); color: var(--ink-dim); word-break: break-all; }
.ca-free { color: var(--success); font-weight: var(--weight-semibold); font-family: var(--font-mono); font-size: var(--text-xs); white-space: nowrap; }
.ca-price { font-family: var(--font-mono); font-size: var(--text-xs); color: var(--ink-dim); white-space: nowrap; }
/* ── States ───────────────────────────────────────────────── */
.ca-empty, .ca-err { padding: 3.5rem 1.25rem; text-align: center; color: var(--ink-dim); border: 1px dashed var(--stroke-strong); border-radius: var(--radius-lg); }
.ca-err { color: #fecaca; border-color: rgba(248,113,113,0.35); border-style: solid; background: rgba(248,113,113,0.05); }
.ca-err .ca-err-title { font-weight: var(--weight-semibold); margin-bottom: var(--space-2xs); color: #fecaca; font-family: var(--font-display); font-size: var(--text-lg); }
.ca-err .ca-retry {
margin-top: var(--space-md); background: var(--accent); color: var(--bg-0, #0b0b0b); border: none;
padding: 0.6em 1.3em; font-size: var(--text-sm); border-radius: var(--radius-md); cursor: pointer; font-weight: var(--weight-semibold);
}
.ca-err .ca-retry:hover { filter: brightness(1.1); }
.ca-err .ca-retry:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
.ca-skel-row td { padding: var(--space-sm) var(--space-md); }
.ca-skel { background: linear-gradient(90deg, var(--surface-1) 25%, var(--surface-2) 50%, var(--surface-1) 75%); background-size: 200% 100%; animation: ca-shimmer 1.4s ease-in-out infinite; border-radius: var(--radius-sm); height: 0.9em; }
@keyframes ca-shimmer { 0% { background-position: 200% 0; } 100% { background-position: -200% 0; } }
@media (prefers-reduced-motion: reduce) { .ca-skel { animation: none; } }
/* ── CTA cards ────────────────────────────────────────────── */
.ca-cta-grid { display: grid; gap: var(--space-md); grid-template-columns: repeat(3, 1fr); }
@media (max-width: 860px) { .ca-cta-grid { grid-template-columns: 1fr; } }
.ca-cta-card { display: flex; flex-direction: column; gap: var(--space-2xs); background: var(--surface-1); border: 1px solid var(--stroke); border-radius: var(--radius-lg); padding: var(--space-lg); text-decoration: none; color: inherit; transition: transform var(--dur-fast, var(--duration-fast)) var(--ease-standard), border-color var(--dur-fast, var(--duration-fast)) var(--ease-standard), background var(--dur-fast, var(--duration-fast)) var(--ease-standard); }
.ca-cta-card:hover { transform: translateY(-2px); border-color: var(--stroke-strong); background: var(--surface-2); }
.ca-cta-card:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
.ca-cta-tag { font: var(--weight-semibold) var(--text-2xs)/1 var(--font-mono); text-transform: uppercase; letter-spacing: 0.08em; color: var(--accent); }
.ca-cta-card h3 { font: var(--weight-bold) var(--text-lg)/1.2 var(--font-display); color: var(--ink-bright); margin: 0.15rem 0; }
.ca-cta-card p { color: var(--ink-dim); font-size: var(--text-sm); line-height: var(--leading-normal); margin: 0; }
.ca-cta-card .ca-cta-go { margin-top: auto; padding-top: var(--space-sm); color: var(--ink-bright); font: var(--weight-medium) var(--text-sm)/1 var(--font-body); display: inline-flex; align-items: center; gap: 0.4ch; }
.ca-anchor { color: inherit; text-decoration: none; border-bottom: 1px solid var(--stroke-strong); }
.ca-anchor:hover { color: var(--ink-bright); border-color: var(--ink-dim); }
</style>
<meta property="og:locale" content="en_US" />
<meta property="og:image:alt" content="Crypto API — three.ws" />
<meta name="twitter:site" content="@trythreews" />
</head>
<body>
<a href="#ca-endpoints" class="h-skip-link" data-i18n="crypto_api.skip_to_endpoints">Skip to endpoints</a>
<header><div id="nav-container"></div></header>
<script src="/nav.js"></script>
<main id="main-content">
<!-- ── HERO ────────────────────────────────────────────────── -->
<section class="ca-hero">
<div class="eyebrow"><span class="ca-dot ca-dot--live"></span><span data-i18n="crypto_api.crypto_api_free_forever">Crypto API · Free forever</span></div>
<h1 data-i18n-html="crypto_api.one_free_api_for_crypto_data_agents">One free API for crypto data — <em>agents, not applications</em></h1>
<p class="ca-hero-sub" data-i18n="crypto_api.dex_pairs_prices_swap_quotes_tvl_on">
DEX pairs, prices, swap quotes, TVL, on-chain reads, name resolution — one bill for
CoinGecko, DefiLlama, Jupiter, DexScreener and Solana RPC. No key, no wallet. A generous
free tier, pay-per-call in USDC only above quota.
</p>
<div class="ca-hero-cta">
<a class="btn btn--primary btn--lg" href="#ca-quickstart" data-i18n="crypto_api.copy_the_quickstart">Copy the quickstart</a>
<a class="btn btn--secondary btn--lg" href="#ca-endpoints" data-i18n="crypto_api.browse_the_live_catalog">Browse the live catalog</a>
</div>
<div class="ca-badges">
<span class="ca-badge" data-i18n="crypto_api.free_tier_no_key">Free tier — no key</span>
<span class="ca-badge" data-i18n="crypto_api.byok_pass_through">BYOK pass-through</span>
<span class="ca-badge" data-i18n="crypto_api.x402_pay_per_call">x402 pay-per-call</span>
<span class="ca-badge" data-i18n="crypto_api.coingecko_defillama_jupiter_dexscreener_sola">CoinGecko · DefiLlama · Jupiter · DexScreener · Solana RPC</span>
<span class="ca-live-pill" id="ca-live-count" data-i18n-html="crypto_api.loading_live_registry"><span class="ca-dot"></span><span id="ca-live-count-text">Loading live registry…</span></span>
</div>
</section>
<div class="ca-main">
<!-- ── QUICKSTART ─────────────────────────────────────── -->
<section class="ca-section" id="ca-quickstart">
<div class="eyebrow">Quickstart</div>
<h2 data-i18n="crypto_api.one_call_real_data_back">One call, real data back</h2>
<p class="ca-section-lede" data-i18n-html="crypto_api.every_endpoint_is_a_plain_http_call">
Every endpoint is a plain HTTP call under <code>/api/v1/x/<provider>/<endpoint></code>.
No auth header, no SDK, no signup — the free tier serves real JSON immediately. Here's
a live SOL price from CoinGecko.
</p>
<div class="ca-code" id="ca-quickstart-code"><!-- filled by JS --></div>
<p class="ca-try-note" style="margin-top:var(--space-sm); color:var(--ink-faint); font-size:var(--text-xs)" data-i18n-html="crypto_api.base_url_discovery_index_machine_spec">
Base URL: <code>https://three.ws/api/v1/x</code> · discovery index:
<a class="ca-anchor" href="/api/v1/x" target="_blank" rel="noopener"><code>GET /api/v1/x</code></a> ·
machine spec: <a class="ca-anchor" href="/openapi.json" target="_blank" rel="noopener"><code>openapi.json</code></a>
</p>
</section>
<!-- ── LIVE ENDPOINT TABLE ────────────────────────────── -->
<section class="ca-section" id="ca-endpoints">
<div class="eyebrow">Live registry</div>
<h2 data-i18n="crypto_api.every_endpoint_rendered_from_production">Every endpoint, rendered from production</h2>
<p class="ca-section-lede" data-i18n-html="crypto_api.this_table_is_not_hand_written_it">
This table is not hand-written — it's fetched from <code>GET /api/v1/x</code> at page
load, so it always matches exactly what's deployed. New providers appear here the
moment they ship, with zero edits to this page.
</p>
<div class="ca-toolbar">
<input type="search" id="ca-search" placeholder="Filter by provider, endpoint, or summary…" aria-label="Filter endpoints" />
<span class="ca-count" id="ca-count"></span>
</div>
<div id="ca-table-host"><!-- filled by JS: skeleton → table / error / empty --></div>
</section>
<!-- ── CTA ────────────────────────────────────────────── -->
<section class="ca-section" id="ca-build">
<div class="eyebrow">Reference</div>
<h2 data-i18n="crypto_api.read_the_docs_or_pay_for_scale">Read the docs, or pay for scale</h2>
<p class="ca-section-lede" data-i18n="crypto_api.the_free_tier_is_real_production_data">
The free tier is real production data with zero setup. When your agent needs more —
its own upstream key, a three.ws plan, or scripted pay-per-call — the same URLs
upgrade in place.
</p>
<div class="ca-cta-grid">
<a class="ca-cta-card" href="/docs">
<span class="ca-cta-tag" data-i18n="crypto_api.docs">Docs</span>
<h3 data-i18n="crypto_api.full_api_reference">Full API reference</h3>
<p data-i18n="crypto_api.every_provider_every_billing_lane_and_the">Every provider, every billing lane, and the free-tier quota table in one page.</p>
<span class="ca-cta-go" data-i18n="crypto_api.read_the_docs">Read the docs →</span>
</a>
<a class="ca-cta-card" href="/openapi.json" target="_blank" rel="noopener">
<span class="ca-cta-tag" data-i18n="crypto_api.openapi_3_1">OpenAPI 3.1</span>
<h3 data-i18n="crypto_api.machine_readable_spec">Machine-readable spec</h3>
<p data-i18n="crypto_api.generated_live_from_the_same_registry_as">Generated live from the same registry as this page — feed it to any codegen or agent tool.</p>
<span class="ca-cta-go" data-i18n="crypto_api.open_openapi_json">Open openapi.json →</span>
</a>
<a class="ca-cta-card" href="/docs/x402">
<span class="ca-cta-tag" data-i18n="crypto_api.x402">x402</span>
<h3 data-i18n="crypto_api.pay_per_call_programmatically">Pay-per-call, programmatically</h3>
<p data-i18n="crypto_api.how_the_http_402_challenge_works_and">How the HTTP 402 challenge works, and how an agent settles USDC to keep calling past the free tier.</p>
<span class="ca-cta-go" data-i18n="crypto_api.read_the_x402_docs">Read the x402 docs →</span>
</a>
</div>
</section>
</div>
</main>
<div id="footer-container"></div>
<script src="/footer.js"></script>
<script type="module">
/* ── /crypto-api: the live table, quickstart, and status pill all
render from GET /api/v1/x — the real production registry. Nothing
here is hand-enumerated; a new provider/endpoint shows up with
zero edits to this file. ─────────────────────────────────────── */
const REGISTRY_URL = '/api/v1/x';
const QUICKSTART_URL = '/api/v1/x/coingecko/price?ids=solana';
const esc = (s) => String(s).replace(/[&<>]/g, (c) => ({ '&': '&', '<': '<', '>': '>' }[c]));
const el = (tag, cls, html) => { const n = document.createElement(tag); if (cls) n.className = cls; if (html != null) n.innerHTML = html; return n; };
function formatUsd(atomics) {
const n = Number(atomics) / 1e6;
if (!Number.isFinite(n)) return '$0.00';
let s = n.toFixed(6).replace(/0+$/, '').replace(/\.$/, '');
const dec = s.includes('.') ? s.split('.')[1] : '';
if (!s.includes('.')) s += '.00';
else if (dec.length < 2) s += '0'.repeat(2 - dec.length);
return `$${s}`;
}
function copyIcon() {
return '<svg viewBox="0 0 24 24" width="13" height="13" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>';
}
function codeBlock(innerHtml) {
const wrap = el('div', 'ca-code');
const btn = el('button', 'ca-copy', copyIcon() + '<span>Copy</span>');
btn.type = 'button';
const pre = el('pre'); const code = el('code'); code.innerHTML = innerHtml; pre.appendChild(code);
wrap.append(btn, pre);
btn.addEventListener('click', async () => {
try {
await navigator.clipboard.writeText(code.textContent);
btn.classList.add('is-done'); btn.querySelector('span').textContent = 'Copied';
setTimeout(() => { btn.classList.remove('is-done'); btn.querySelector('span').textContent = 'Copy'; }, 1600);
} catch { btn.querySelector('span').textContent = 'Press ⌘C'; }
});
return wrap;
}
/* ── Quickstart code block ────────────────────────────────── */
function renderQuickstart() {
const html =
`<span class="ca-cmd">curl</span> <span class="ca-str">"https://three.ws${esc(QUICKSTART_URL)}"</span>`;
const host = document.getElementById('ca-quickstart-code');
host.replaceChildren(codeBlock(html));
}
renderQuickstart();
/* ── Live registry: skeleton → table / error / empty ─────── */
const tableHost = document.getElementById('ca-table-host');
const searchInput = document.getElementById('ca-search');
const countEl = document.getElementById('ca-count');
const livePill = document.getElementById('ca-live-count');
const liveText = document.getElementById('ca-live-count-text');
let ROWS = [];
function skeletonRows(n = 8) {
const wrap = el('div', 'ca-table-wrap');
const table = el('table', 'ca-table');
table.innerHTML = '<thead><tr><th>Provider</th><th>Endpoint</th><th>Method & path</th><th>Free tier</th><th>x402 price</th></tr></thead>';
const tbody = el('tbody');
for (let i = 0; i < n; i++) {
const tr = el('tr', 'ca-skel-row');
for (let c = 0; c < 5; c++) {
const td = el('td');
td.appendChild(el('div', 'ca-skel'));
tr.appendChild(td);
}
tbody.appendChild(tr);
}
table.appendChild(tbody);
wrap.appendChild(table);
return wrap;
}
function renderTable(rows) {
const wrap = el('div', 'ca-table-wrap');
const table = el('table', 'ca-table');
table.innerHTML = '<thead><tr><th>Provider</th><th>Endpoint</th><th>Method & path</th><th>Free tier</th><th>x402 price</th></tr></thead>';
const tbody = el('tbody');
if (rows.length === 0) {
tableHost.replaceChildren(emptyState());
countEl.textContent = '';
return;
}
for (const r of rows) {
const tr = el('tr');
tr.innerHTML =
`<td class="ca-provider">${esc(r.providerName)}</td>` +
`<td class="ca-purpose">${esc(r.summary)}</td>` +
`<td><span class="ca-meth">${esc(r.method)}</span><span class="ca-path">${esc(r.path)}</span></td>` +
`<td class="ca-free">${r.free ? `${r.free.perMin}/min · ${r.free.perDay}/day` : '—'}</td>` +
`<td class="ca-price">${esc(formatUsd(r.price_usdc_atomics))} / call</td>`;
tbody.appendChild(tr);
}
table.appendChild(tbody);
wrap.appendChild(table);
tableHost.replaceChildren(wrap);
countEl.textContent = `${rows.length} endpoint${rows.length === 1 ? '' : 's'}`;
}
function emptyState() {
const wrap = el('div', 'ca-empty');
wrap.innerHTML = '<div style="font-size:1.5rem;margin-bottom:.5rem">🗂️</div><div><b>No endpoints match.</b> Clear the filter to see the full live registry, or check <a class="ca-anchor" href="/docs">the docs</a>.</div>';
return wrap;
}
function errorState(err) {
const wrap = el('div', 'ca-err');
wrap.innerHTML =
`<div class="ca-err-title">Couldn't load the live registry</div>` +
`<div>${esc(err?.message || 'Network error')} — the catalog is served from <code>GET /api/v1/x</code>. Retry, or hit it directly.</div>`;
const retry = el('button', 'ca-retry', 'Retry');
retry.type = 'button';
retry.addEventListener('click', loadRegistry);
wrap.appendChild(retry);
return wrap;
}
function applyFilter() {
const q = searchInput.value.trim().toLowerCase();
const filtered = q
? ROWS.filter((r) =>
r.providerName.toLowerCase().includes(q) ||
r.summary.toLowerCase().includes(q) ||
r.path.toLowerCase().includes(q),
)
: ROWS;
renderTable(filtered);
}
searchInput.addEventListener('input', applyFilter);
async function loadRegistry() {
tableHost.replaceChildren(skeletonRows());
countEl.textContent = '';
liveText.textContent = 'Loading live registry…';
try {
const res = await fetch(REGISTRY_URL, { headers: { accept: 'application/json' } });
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const body = await res.json();
const providers = body?.data?.providers;
if (!Array.isArray(providers)) throw new Error('malformed registry response');
ROWS = [];
for (const p of providers) {
for (const e of p.endpoints || []) {
ROWS.push({
providerName: p.name,
summary: e.summary || '',
method: e.method,
path: e.path,
free: e.free || null,
price_usdc_atomics: e.price_usdc_atomics,
});
}
}
applyFilter();
const dot = livePill.querySelector('.ca-dot');
if (ROWS.length > 0) {
dot.classList.remove('ca-dot--err'); dot.classList.add('ca-dot--live');
liveText.textContent = `${ROWS.length} endpoint${ROWS.length === 1 ? '' : 's'} live across ${providers.length} provider${providers.length === 1 ? '' : 's'}`;
} else {
dot.classList.remove('ca-dot--live');
liveText.textContent = 'Registry is live but empty right now';
}
} catch (err) {
tableHost.replaceChildren(errorState(err));
countEl.textContent = '';
const dot = livePill.querySelector('.ca-dot');
dot.classList.remove('ca-dot--live'); dot.classList.add('ca-dot--err');
liveText.textContent = 'Live registry unreachable — retry below';
}
}
loadRegistry();
</script>
<!-- Runtime i18n: detects locale, swaps annotated copy, mounts <lang-switcher>. -->
<script type="module" src="/i18n.js"></script>
</body>
</html>