Pricing, payouts & Connect
Endpoint pricing, take rate, scheduled increases, discounts, and Stripe Connect.
View as Markdown →Providers set per-endpoint prices in US cents. Consumers pay the effective price per successful gateway call.
Take rate
| Provider type | Ozma take | Provider net |
|---|---|---|
| Standard | 10% | 90% |
| Founding provider | 0% | 100% |
Founding status is assigned by Ozma — displayed as a trust badge on provider profiles.
Setting prices
npx @ozma_app/cli provider get api_123 --json # find endpoint ids
npx @ozma_app/cli provider pricing api_123 \
--endpoint-id ep_456 \
--price-cents 5 \
--json
Bulk updates via --file pricing.json. Free endpoints use --price-cents 0.
Price change policy (live APIs)
| Change | Behavior |
|---|---|
| Decrease | Immediate |
| Increase | Scheduled +7 days; email to recent callers; max one increase per endpoint per 30 days |
| Discount | Temporary reduced price (1–90 days) |
Cancel a pending increase:
npx @ozma_app/cli provider pricing-cancel api_123 ep_456
Gateway responses expose effective pricing in meta.price_cents_effective, with optional meta.price_increase or meta.discount objects.
API detail includes pending_increases, active_discounts, and price_history.
Connect payouts
Paid APIs in production require Stripe Connect Express with payouts_enabled and transfers active before publish.
npx @ozma_app/cli provider connect --json
# Check readiness: GET https://api.ozma.app/v1/provider/connect/status
Daily payout job transfers settled provider share. Free-only listings skip Connect.
Check earnings:
npx @ozma_app/cli provider analytics --json
Returns total_gmv_cents (gross) and provider_payout_cents (net after take).
Consumer-facing price transparency
Listing pages and GET /v1/apis/:slug show current and scheduled prices so agents can budget before calling.