Net revenue & your share

GET /api/v1/mystery/revenue packs:read

For partners selling CardOS tiers there is no per-item receivable — CardOS owns the inventory and funds the buyback float, and YOU EARN a share of net revenue: net revenue = gross − sell backs − fees, and your share is that net times your agreed rate, paid to you in USDC every quarter (monthly or another form on enterprise). Rates are per product and negotiated separately: combo tiers are typically 5% of net, instant packs 1% of gross (instant cards come from the CardAllocationPool, so no buyback window exists and there is nothing to deduct). Gross is what your end users paid for QUALIFYING packs — those whose revealed contents included a raw card, read per pull rather than per tier (a tier’s slots only say what a pack could contain, so a purchase qualifies once its reveal lands). It counts SUBMITTED / FULFILLED / PARTIALLY_FULFILLED and excludes REFUNDED / FAILED. Note the definition self-corrects under credit recycling: proceeds a user spends on more packs count as gross again, but the sell back was already deducted, so $25 pack − $20 sell back + $20 re-buy nets to $25. A period where sell backs outrun sales earns nothing rather than clawing back against the next one.

Try it GET /api/v1/mystery/revenue
response
403 17ms preloaded server-side with the default context
object · 3 keys
{
  "success": false,
  "message": "Mystery partner API key required",
  "error": "This endpoint requires an API key linked to a mystery partner account"
}
tracks the inputs above
curl -X GET 'https://service.rip.fun/api/v1/mystery/revenue' \
  -H 'X-API-Key: rip_…'

Request fields

FieldTypeRequiredDescription
from / toquery ISO timestampPeriod bounds; `to` is exclusive. Omit both for all-time

Response fields (data)

FieldDescription
gross_usdcPaid for qualifying packs in the period
sellback_usdcUSDC the pool paid back on cards from those packs
net_usdcgross − sell backs − fees
revenue_share_usdcWHAT YOU EARN — each product’s net at its own rate, summed (floored at zero)
rip_retained_usdcThe remainder CardOS keeps, so the statement reconciles to net
by_producttier and instant, each with its own base, rate and share
qualifying_packsHow many packs contributed to gross
billing_model / revenue_share_bpsYour configured model and rate