Mystery Pack API

A B2B API that lets partners sell mystery card packs to their end-users: list tiers and odds, purchase packs (custodially or with the user's own wallet), reveal on-chain items, offer instant buybacks, and redeem cards for physical shipment — all attributed to your partner key.

Base URLs

Environment	Origin	Notes
Sandbox (staging)	https://staging-service.rip.fun	Base Sepolia — what the "Try it" runners in these docs call
Production	https://service.rip.fun	Base mainnet

All endpoints live under the /api/v1 base path and require an X-API-Key. All money is USDC with 6 decimals: balances are integer micros returned as strings ("12500000" = 12.5 USDC), plus a *_usdc decimal string for display.

Two custody models

• Custodial (default) — the end-user deposits USDC into a credit balance rip.fun holds; one POST debits it and a relayer buys on-chain. The user never signs anything.
• Non-custodial — the API returns unsigned calldata (prepare), the end-user signs and broadcasts it from their own wallet, and you record the tx (submit). rip.fun never touches their funds.

Living documentation

Every endpoint page in the API Reference embeds a live runner: tweak the request inputs, press Run, and see the real staging response (status + latency), plus a ready-to-copy curl snippet that tracks your inputs. The partner API key stays on this demo's server — the browser only ever talks to a whitelisted proxy.

For the full product experience — connect a wallet, buy a pack, reveal the card, sell it back or redeem it physically — open the Storefront demo.

Quick start

1. Get a partner API key from rip.fun (see Authentication).
2. List tiers and odds to render your shop.
3. Purchase: custodial or non-custodial prepare → user signs → submit.
4. Poll purchase status (or use webhooks) until FULFILLED, then show the revealed items.
5. Offer a buyback or a physical redemption.

The three multi-party sequences (who signs what, which webhooks fire) are spelled out in End-to-end flows.

Get testnet funds (Base Sepolia)

To actually run the sandbox flows — buy a pack, sell it back, redeem it — your test wallet needs a little Base Sepolia ETH for gas plus USDC to pay for packs. Staging's payment token is Circle's native Base Sepolia USDC at 0x036CbD53842c5426634e7929541eC2318f3dCF7e — the same token Circle's faucet dispenses.

• USDC — Circle faucet: select Base Sepolia; ~20 USDC per address every 2 hours, no account needed.
• Gas ETH — Coinbase Developer Platform faucet (up to 0.1 ETH per 24h; also dispenses USDC), or Alchemy's Base Sepolia faucet (free account, 1 claim per 24h).
• Fuller list: the Base docs network-faucets page.

Tier 1 on staging costs $1 USDC, so a single Circle claim covers ~20 test purchases.