Money & units
Prices go in as USD dollars; earnings and sales come out as integer cents; balance is dollars — per endpoint.
Everything is USD. There is no other currency anywhere in the API. The unit, however, differs by endpoint — this table is the truth:
| Endpoint | Field | Unit |
|---|---|---|
| POST /drops | price (in) | USD dollars — 0 (free) or 5–750 |
| POST /posts | media[].price (in) | USD dollars — at least 5 when isPaid |
| GET /earnings | everything …Cents (out) | integer cents |
| POST /drops/check-status | saleAmountCents (out) | integer cents, gross |
| GET /balance | all four buckets (out) | USD dollars |
| GET /links | web.tipTemplate {usd} | dollars |
| GET /links | telegram.tipTemplate {cents} | cents |
earnings excludes refunded and charged-back transactions. check-status does not — a refunded sale still reports paid: true. Use earnings for money truth, check-status for fulfilment.
Price limits#
- Drop price: free (
0) or between $5 and $750. - Paid post media: at least $5 per item.
- Tips (via tip links): $5–$750.
Gross vs net#
Dropfans takes a 15% platform fee; the creator keeps 85%. earnings reports both: totalEarningsCents is net (what the creator keeps), grossEarningsCents is what buyers paid, and typeTotals breaks both down by drop / tip / subscription. check-status reports gross only.
Payouts#
Daily payouts on a rolling 14-day release. The minimum payout is $20. GET /balance shows where the money sits: pending (in the release hold), available (payable), processing (in a payout run) and paidOut (lifetime).
Timezones#
earnings buckets by day in the timezone you pass as tz (IANA name; invalid values silently fall back to UTC) — so your "today" can match the creator’s dashboard. See Earnings & balance.
Next: Agencies or Earnings & balance.
Questions? [email protected]