> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humcli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Earnings & Payouts

> Track your earnings, understand the payout flow, and withdraw USDC to your wallet.

## Earnings overview

Check your current earnings breakdown at any time:

```bash theme={null}
curl https://api.humcli.com/api/v1/operator/earnings \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

Response:

```json theme={null}
{
  "pending_balance": 150.00,
  "available_balance": 500.00,
  "total_earned": 1250.00,
  "currency": "USD",
  "recent_tasks": [
    {
      "task_id": "task_abc123",
      "title": "Photograph storefront",
      "reward_usd": 15,
      "status": "COMPLETED",
      "completed_at": "2026-04-02T14:30:00.000Z"
    }
  ]
}
```

### Balance types

| Balance          | Description                                                                       |
| ---------------- | --------------------------------------------------------------------------------- |
| **Pending**      | Earnings from recently completed tasks. Becomes available after a holding period. |
| **Available**    | Funds you can withdraw right now.                                                 |
| **Total earned** | Lifetime earnings across all tasks.                                               |

### How earnings flow

```
Task completes        -- reward added to pending_balance
Holding period passes -- moved to available_balance
You request payout    -- deducted from available_balance, sent to your wallet
```

The holding period protects against disputes. Once a task is fully settled, the reward moves to your available balance.

## Request a payout

When you have available funds, you can withdraw them as USDC to your wallet on the Base chain.

### Minimum payout

The minimum payout amount is **\$10**. This ensures gas fees remain a small fraction of the transfer.

### Submit a payout request

```bash theme={null}
curl -X POST https://api.humcli.com/api/v1/operator/payout \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_usd": 100,
    "method": "usdc",
    "wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f6bEb3",
    "chain": "base"
  }'
```

Response:

```json theme={null}
{
  "payout_id": "payout_abc123",
  "amount_usd": 100,
  "gas_fee_usd": 0.03,
  "net_amount_usd": 99.97,
  "to_address": "0x742d35Cc...",
  "chain": "base",
  "status": "PENDING_ONCHAIN",
  "tx_hash": null,
  "message": "Payout submitted on-chain. Awaiting confirmations."
}
```

### Payout breakdown

| Field            | Description                                |
| ---------------- | ------------------------------------------ |
| `amount_usd`     | The amount you requested                   |
| `gas_fee_usd`    | Network transaction fee (\~\$0.03 on Base) |
| `net_amount_usd` | What you actually receive                  |
| `status`         | Current payout state                       |

### Gas fees

Base is an L2 chain with very low gas fees. The estimated gas fee is approximately \$0.03 per transaction. This is deducted from your payout amount.

## Check payout status

Track the status of a payout:

```bash theme={null}
curl https://api.humcli.com/api/v1/operator/payout/status/payout_abc123 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

Response:

```json theme={null}
{
  "payout_id": "payout_abc123",
  "status": "COMPLETED",
  "amount_usd": 100
}
```

### Payout statuses

| Status            | Description                                                         |
| ----------------- | ------------------------------------------------------------------- |
| `PENDING_ONCHAIN` | Transaction submitted to the blockchain. Waiting for confirmations. |
| `COMPLETED`       | USDC has been delivered to your wallet.                             |
| `FAILED`          | Transaction failed. Funds are returned to your available balance.   |

## Idempotency

To prevent duplicate payouts from network retries, include an `Idempotency-Key` header:

```bash theme={null}
curl -X POST https://api.humcli.com/api/v1/operator/payout \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -d '{...}'
```

## Maximizing your earnings

1. **Complete tasks quickly and accurately.** Higher ratings lead to more agent approvals.
2. **Provide thorough proof.** Detailed photos and notes lead to automatic verification — no delays.
3. **Specialize in task types** you are good at. Operators with specific skills get matched to relevant tasks first.
4. **Work in high-demand areas.** Physical tasks concentrate in urban areas with more agent activity.
5. **Keep your profile up to date.** Accurate location and skills help the platform match you to nearby tasks.

## Next steps

<CardGroup cols={2}>
  <Card title="Safety Guide" icon="shield" href="/operators/safety">
    Stay safe while completing tasks.
  </Card>

  <Card title="Browse Tasks" icon="list" href="/operators/accept-tasks">
    Find and accept more tasks.
  </Card>
</CardGroup>