# Pricing, payouts & Connect

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

```bash
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:

```bash
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.

```bash
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:

```bash
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.

## Related

- [Publish an API](/docs/guides/publish-api)
- [Billing (consumer)](/docs/guides/billing)