# Earnings and payouts

> How provider earnings arise, when they become available, and how to withdraw USD to a bank account or BTC over Lightning and on-chain.

Source: https://0.0.0.0:3000/docs/providers/earnings
Documentation index: https://0.0.0.0:3000/docs/llms.txt

Every request you serve credits your earnings at your published prices. Earnings start as pending, become available after a holding period, and can then be withdrawn. USD and BTC are separate balances from start to finish.

## How earnings arise

When a request settles, the customer is charged and your **pending** earnings are credited at your published prices for the request's usage. The platform fee is charged to customers when they buy credits; it isn't deducted from your earnings. See [What customers pay](/docs/providers/pricing#what-customers-pay).

| Work | Earns |
| --- | --- |
| A request that delivered output to the customer | Your price for its usage |
| A request that failed before any output reached the customer | Nothing, and the customer pays nothing |
| A request cancelled or interrupted after output started | Your price for the usage the platform accepts for it; provider-caused interruptions may be excluded |
| Platform checks | Nothing |

For cloud sources, platform checks still use your upstream account.

## From pending to available

Earnings become available after a holding period, and a portion may be held in reserve. Your dashboard shows the holding period and reserve that apply to you; the reserve isn't part of your available balance.

The platform may extend holds, withhold or reverse earnings, and review any withdrawal, including while suspected misrepresentation or abuse is investigated. Misrepresenting a model, its capabilities, its usage or its data handling leads to suspension and to withholding or reversal of earnings.

Earnings belong to the personal or organization account that owns the provider. In an organization, only owners and administrators can see payout setup and request withdrawals.

## Viewing earnings

| Where | What you see |
| --- | --- |
| Dashboard, [Provider › Earnings](/dashboard/provider/payouts) | A **Balances** table per currency with **Available**, **Pending**, **Withdrawing** and **To bank**, payout setup and withdrawal history |
| Dashboard, your provider's page | **Earned · 7 UTC days**: that provider's earnings over the last 7 UTC days, each currency apart |
| [Provider › Logs](/dashboard/provider/logs) | Individual request usage and settlement details; summary earnings are shown on Earnings |
| Terminal UI **Earnings** | Pending and available USD and BTC, payout availability and withdrawals |
| [Desktop app](/docs/providers/desktop) **Earnings** | Available and pending balances, daily earnings for the last 7, 30 or 90 UTC days, earnings by source and model, period totals and withdrawals |

The CLI has read-only views:

```bash
numes provider earnings --profile NAME
numes provider withdrawals --profile NAME
```

The CLI, terminal UI and desktop app can't start withdrawals; the desktop app's **Withdraw** opens the dashboard. A payout method that isn't available shows as unavailable with the reason `rail_disabled`. Counters labelled local in the terminal UI or desktop app are session observations, never earnings.

## Currencies are never mixed

USD and BTC earnings are never added together, compared, converted or used to cover each other. A USD-indexed Bitcoin offer earns satoshis: the dollar price is converted at the reference rate locked for each request, and the satoshis keep any later change in Bitcoin's price. Bitcoin amounts are shown in satoshis, for example `₿42,000`; very small amounts show as `<₿1` rather than zero.

## USD payouts through Stripe

You withdraw USD to a bank account through a Stripe connected account. Stripe collects and keeps your identity, business, tax and bank details; the platform asks only for your country.

:::steps
### Set up your payout account

Open [Provider › Earnings](/dashboard/provider/payouts), choose **Set up payouts with Stripe**, pick your payout country and choose **Continue to Stripe**. Complete Stripe's onboarding and return to the dashboard.

Stripe may require verification for card payments as part of payout setup, even if you only receive earnings. This applies across supported payout countries.

Bank withdrawals also need an approved provider. Until both are done, the US dollars row under **Balances** says what's missing, with the next step beneath it. Once both are done, it shows **Bank payouts ready**.

Use **Update details on Stripe** to change details later. Updating verified details can pause withdrawals until Stripe reviews them.

### Request a withdrawal

Choose **Withdraw to bank**, enter the amount and choose **Review terms**. The preview shows what you receive in USD, and a **Withdrawal fee** line when a fee applies. Choose **Submit for approval**.

The amount moves from available to withdrawing. You can **Cancel request** while it awaits approval.

### Approval and payout

The platform reviews each bank withdrawal before approving it; the reviewer can't change the amount or the destination. After approval, the USD is transferred to your connected account and Stripe pays it out to your bank.
:::

Withdrawal limits are shown in the dashboard and in each preview. Payout countries are offered from the United States, Canada, the United Kingdom, Switzerland and the European Economic Area. Stripe decides whether your country, account and business are eligible.

If your bank account uses another currency, Stripe converts the USD transfer. Your earnings and the withdrawal stay in USD on the platform, so the exact local amount isn't known in advance.

## Bitcoin withdrawals

You withdraw BTC earnings over Lightning or on-chain from [Provider › Earnings](/dashboard/provider/payouts).

1. Choose **Withdraw Bitcoin** and enter the amount you want to receive, in whole satoshis.
2. Enter a Bitcoin address, or a Lightning invoice for exactly that amount. The invoice must state a whole-satoshi amount, be for the Bitcoin network shown in the dashboard and not be expired.
3. Choose **Review**. The quote shows the amount you receive, the network fee, any platform fee and the total deducted from your available earnings.
4. Choose **Submit for approval**. Your earnings are reserved while the request waits for review.
5. Our team reviews it independently of the person who requested it. Approval queues the Bitcoin payment; rejection returns the reserved earnings. You can cancel before sending begins.

Quotes are short-lived; if one expires before you submit the request, request a new one. A Lightning invoice can be quoted only once, so create a new invoice if you need fresh terms. Limits apply to the amount received, exclude fees and are shown in the dashboard. Every Bitcoin withdrawal requires approval. If its quote has expired when an approved payment is sent, the payment can proceed only when the recipient amount, destination, fees and speed still match the terms you accepted. Changed terms return the reserved earnings and require a new request.

A daily limit shared across all accounts also applies to Bitcoin withdrawals, including network fees. The budget renews at midnight UTC, but unresolved payments continue to count against it until their outcome is known.

If the fee quote fails, no withdrawal has been submitted. Choose **Edit destination**
to review your details. If quotes keep failing, contact support before trying again.

Withdrawals need a recent sign-in. If yours is too old, the dialog asks you to **Sign in again** and then returns you to the same withdrawal.

## Deleted providers

Deleting a provider or endpoint never deletes earnings or withdrawal history. If your provider was approved when you deleted it, you can still withdraw, subject to account permissions and any holds.

## Next steps

:::cards
- {coins} [Pricing your models](/docs/providers/pricing) Set prices that earn after upstream costs.
- {gauge} [Measurements and quality](/docs/providers/measurements) Win more traffic.
- {bitcoin} [Bitcoin](/docs/account/bitcoin) How Bitcoin balances and payments work on Numes.
- {console} [CLI reference](/docs/providers/cli#platform-views) Read-only earnings and withdrawal commands.
:::