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.
three.ws Premium — the monthly Data API pass
Premium is one on-chain payment that replaces per-call micropayments for 30 days. Instead of answering an x402 challenge on every archive search, you buy a pass once a month — the AIXBT model — and call the Data API with an API key (servers, agents) or a wallet signature (browsers).
Three tiers, paid on Solana only — every tier is payable in $THREE (20% off — the platform coin is always the cheapest way in), native SOL, or USDC (parity):
| Tier | Price / 30 days | Rate limit | Licence |
|---|---|---|---|
| Developer | $19.99 (≈ $15.99 in $THREE) | 120 req/min | Personal + evaluation |
| Pro | $99 (≈ $79.20 in $THREE) | 600 req/min | Commercial use |
| Enterprise | $499 (≈ $399.20 in $THREE) | 2,000 req/min | Commercial + priority support + bulk corpus arrangements |
$THREE mint: FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump. Prices in SOL
and $THREE are locked for 10 minutes when you request a quote, so the amount
you sign is exactly the amount that's verified. Live per-tier, per-asset
pricing: GET https://three.ws/api/premium/plans.
What every tier unlocks today: unmetered search on the
crypto-news archive
(GET /api/news/archive) at your tier's rate limit — versus the free tier's
60 searches/day and the $0.001-per-search x402 rail. Corpus stats, month
index, and trending are free for everyone regardless. More premium surfaces
join the same pass over time; your key starts working on them automatically.
Buying a higher tier while a pass is active upgrades your key's rate limit
immediately and appends the new period to the end.
Buying a pass
From the dashboard (recommended)
Open /dashboard/data-api, pick an asset, and
confirm one transaction in your Solana wallet. When it confirms, the page
shows your x402_live_… API key once — copy it then. Renewing later
appends 30 days to the end of your current pass; no days are lost by renewing
early.
From the API (no account needed)
# 1. Quote — lock the price, get the unsigned transaction (base64)
# plan: developer (default) | pro | enterprise
curl -X POST https://three.ws/api/premium/quote \
-H 'content-type: application/json' \
-d '{"asset":"THREE","wallet":"<your-solana-address>","plan":"pro"}'
# → { "quote": { "id", "amount_atomics", "expires_at", … }, "tx_base64": "…" }
# 2. Sign tx_base64 with the quoted wallet and send it (any Solana client).
# 3. Redeem — verify the landed payment and receive the pass + API key
curl -X POST https://three.ws/api/premium/subscribe \
-H 'content-type: application/json' \
-d '{"quote_id":"<quote.id>","tx_signature":"<signature>"}'
# → { "pass": { "expires_at", … }, "api_key": "x402_live_…" } (key shown once)
A 202 { pending: true } means the transaction hasn't confirmed yet — poll
subscribe again with the same body; redeeming is idempotent, and
re-submitting an already-redeemed signature returns the existing pass.
Live per-asset pricing for all three tiers, free and keyless:
curl -s https://three.ws/api/premium/plans
Pass state for any wallet: GET https://three.ws/api/premium/status?wallet=….
Using the pass
Servers and agents — API key. Send the key as a header on any premium endpoint; the request bypasses the x402 payment entirely:
curl "https://three.ws/api/news/archive?q=mt+gox&start_date=2018-01-01&end_date=2019-12-31" \
-H "X-API-Key: x402_live_…"
Browsers — wallet signature (SIWX). The wallet that bought the pass holds a signature grant until the pass expires. On /markets/archive, when the payment dialog appears, choose sign with wallet instead of paying — no key, no charge.
Managing keys
On /dashboard/data-api (signed in) you can rotate (revoke + reissue; new plaintext shown once) or revoke your key. Key management is tied to the account that was signed in at purchase time — passes bought wallet-only over the raw API authenticate with the key itself and can be re-keyed by renewing. Your purchase history and subscriptions live at /dashboard/billing.
The dashboards ride two raw endpoints you can also call directly:
POST /api/premium/keys with { action: "rotate" | "revoke", id }
(session + CSRF; rotate returns the fresh plaintext exactly once, and the
route is metered at 20 key operations per account per hour) and
GET /api/premium/mine (session-authenticated; your passes and keys,
including passes bought directly by any Solana wallet linked to your account).
"Linked" means a wallet you have signed in with: connecting a Solana wallet once (SIWS) attaches it to the account, and every pass that wallet ever bought, including ones bought before you had an account, shows up on the billing page from then on. Nothing links by typing an address, so nobody else's purchases can be claimed.
Rules and edge cases
- A quote is redeemable for 30 minutes; after that, request a fresh one (the transaction's blockhash expires far sooner anyway).
- Verification checks the landed transaction: the quoted wallet must be a signer and the treasury balance delta must cover the quoted amount. Someone else's transaction signature can't redeem your quote.
- One transaction signature redeems exactly one pass, forever (database UNIQUE). Failed or reverted transactions redeem nothing.
- Renewal periods stack end-to-end (
new start = old expiry); buying a higher tier retiers the key's rate limit immediately. - Ops can tune pricing without a deploy:
PREMIUM_PRICE_DEVELOPER/PREMIUM_PRICE_PRO/PREMIUM_PRICE_ENTERPRISE(USD),PREMIUM_RATE_LIMIT_DEVELOPER/_PRO/_ENTERPRISE(req/min),PREMIUM_PASS_THREE_DISCOUNT,PREMIUM_PASS_DAYS.
Related: API reference — news archive, the x402 per-call rail that Premium sits on top of, and the free tiers that remain free (news feed, digest, archive stats/trending).