/api/v1/mystery/billing packs:readYour receivable balance with rip.fun, settled DAILY — buybacks are fronted from rip.fun’s buyback pool, so send the accrued amount each day to refill it. Two things accrue: BUYBACK_USDC_FRONTED (what the holder was actually paid on each accepted buyback — the offer price NET of the marketplace fee, which is rip.fun’s own take, not your debt; billed per accept) and POOL_ITEM_PULLED (per the partnership agreement, each item pulled out of your pool wallet — detected from on-chain transfers, valued at the item’s market price at pull time; transfers back into rip.fun contracts or rip.fun-operated wallets don’t count — when rip.fun withdraws items or funds from your wallet to collect on the receivable, nothing is billed — and each item is billed ONCE ever: an item that cycles pull → buyback → pull again is free on the re-pull). owed = accrued usage not yet invoiced; invoiced totals are included for reconciliation. A pool.item_pulled webhook also fires per billed pull.
GET /api/v1/mystery/billing {
"success": true,
"data": {
"owed_usdc": "0.000000",
"owed_micros": "0",
"accrued_today_usdc": "0.000000",
"invoiced_usdc": "0.000000",
"by_type": {},
"unpriced_items": 0,
"oldest_uninvoiced_at": null,
"repayment": {
"address": "0x264a97de8D0955512777b10a99A988cf4c772D4A",
"chain": "base",
"token": "USDC",
"total_repaid_usdc": "0.000000",
"unapplied_credit_usdc": "0.000000",
"repayments": 0,
"last_repaid_at": null,
"note": "Send owed_usdc as USDC to 0x264a97de8D0955512777b10a99A988cf4c772D4A, then report the transaction with POST /api/v1/mystery/billing/repayments {\"tx_hash\":\"0x…\"}. The transfer is verified on-chain and owed usage is marked repaid oldest-first (invoice_ref repay:<tx_hash>)."
},
"note": "owed = accrued usage not yet invoiced (BUYBACK_USDC_FRONTED = USDC rip.fun fronted to holders on buyback accepts, billed per accept; POOL_ITEM_PULLED = items pulled out of your pool wallet, each item billed ONCE ever). Settled DAILY — send accrued usage each day to the repayment.address to refill the buyback pool, and report the tx via POST /billing/repayments; invoiced totals shown for reconciliation."
}
}curl -X GET 'https://service.rip.fun/api/v1/mystery/billing' \ -H 'X-API-Key: rip_…'
data)| Field | Description |
|---|---|
owed_usdc / owed_micros | Total accrued and not yet invoiced |
accrued_today_usdc | Today’s accrual (UTC) — the daily settlement amount to send |
by_type | Breakdown per usage type: owed / invoiced totals + item counts |
unpriced_items | Pulls recorded at 0 pending manual pricing — owed UNDERSTATES the receivable until these are priced |
oldest_uninvoiced_at | Age of the oldest accrued row |
repayment.address / chain / token | Where to send the settlement — USDC on Base to this address |
repayment.total_repaid_usdc / repayments / last_repaid_at | Verified repayments received so far |
repayment.unapplied_credit_usdc | Verified USDC not yet matched to usage rows (overpayment credit — consumed automatically as usage accrues) |