Paid: Unlock a premium avatar cosmetic

Pay once in USDC to unlock a premium avatar cosmetic (skin or emote) for an account, wearable across /play and /walk. Price varies by rarity ($0.25–$3.00). Wallets that already purchased re-confirm for free via SIWX (CAIP-122).

get/api/x402/cosmetic-purchase

Request

  • Base URL: https://three.ws
  • URL: https://three.ws/api/x402/cosmetic-purchase
  • Auth: none required

Query parameters

idstring required

Premium cosmetic id from /api/cosmetics/catalog.

accountstring required

Solana wallet address or guest id (g_…) the cosmetic is granted to.

Response

Ownership grant JSON

okboolean required
idstring required
namestring required
slotstring required
raritystring required
accountstring required
ownedboolean required
newlyOwnedboolean
payerstring nullable
networkstring nullable
amountAtomicsstring nullable
assetstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.