Back to Browse
three.ws Cosmetic Purchase
x402
three.ws Cosmetic Purchase is a paid API for AI agents from three.ws, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-15).
Purchases a premium cosmetic item for a 3D AI agent avatar and grants ownership to a specified account via micropayment
Price / call$0.5
Success—
StatusUnknown
How this service works
Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.
Output
Returns a JSON object confirming the purchase: cosmetic ID, name, slot type, rarity, the account it was granted to, the paying wallet address, whether it was newly acquired, the payment amount in atomics, the network used, and creator revenue split details (creator wallet, basis points, payout transaction).
Example use cases
Example prompt
“Buy the 'Midnight' legendary skin cosmetic (id: skin-midnight) for my three.ws AI agent account g_5f3c9a21b8 — charge 0.5 USDC and grant ownership to that guest account.”
Technical details
Endpoint
GEThttps://three.ws/api/x402/cosmetic-purchaseWhen to prefer
Use this endpoint when you need to programmatically purchase and grant a premium cosmetic to a specific 3D AI agent avatar account on three.ws, paying via x402 USDC micropayment. Prefer this over manual storefront flows when automating avatar customization or building agent onboarding pipelines that include cosmetic unlocks.
Side effects
- Cosmetic ID not found in catalog — returns error if 'id' does not match a valid premium cosmetic
- Account not found or invalid — returns error if account string is malformed or unrecognized
- Payment failure — insufficient USDC balance or x402 payment authorization fails
- Cosmetic already owned — endpoint may return owned:true but newlyOwned:false if already purchased
- Invalid account format — account must be a valid Solana wallet address or g_… guest ID
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"id": "skin-midnight",
"ok": true,
"name": "Midnight",
"slot": "skin",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"owned": true,
"payer": "wwwPqsM4N7T9J69tB82nLyzxqsH159j4orftLTQfUGV",
"rarity": "legendary",
"account": "g_5f3c9a21b8",
"network": "solana",
"newlyOwned": true,
"amountAtomics": "3000000"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"