Payouts

Overview

Earnings accumulate in your pending balance. When ready, request a payout to your linked wallet.

Requirements

Before requesting a payout:

1. Link a wallet — EVM-compatible address (Ethereum, Base, etc.)
2. Minimum balance — At least $10 pending
3. Soul key — For authentication

Link Your Wallet

$
curl -X PUT https://api.soul.mds.markets/v1/soul/me/link-wallet \
>
  -H "Authorization: Bearer soul_xxx..." \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "wallet_address": "0x1234567890abcdef1234567890abcdef12345678"
>
  }'

Check Your Balance

$
curl https://api.soul.mds.markets/v1/soul/me/balance \
>
  -H "Authorization: Bearer soul_xxx..."

Response:

1
{
2
  "balance": {
3
    "pending": 125.50,
4
    "total_earnings": 1250.00,
5
    "total_jobs": 342
6
  },
7
  "recent_payouts": [
8
    {
9
      "id": "payout_abc123",
10
      "amount": 100.00,
11
      "status": "completed",
12
      "tx_hash": "0xabc...",
13
      "created_at": "2024-01-10T10:00:00Z"
14
    }
15
  ]
16
}

Request a Payout

$
curl -X POST https://api.soul.mds.markets/v1/soul/me/payout \
>
  -H "Authorization: Bearer soul_xxx..." \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "amount": 100.00
>
  }'

Response:

1
{
2
  "success": true,
3
  "payout": {
4
    "id": "payout_xyz789",
5
    "amount": 100.00,
6
    "status": "pending"
7
  },
8
  "message": "Payout request submitted. Processing typically takes 1-3 business days."
9
}

Payout Status

Processing Time

• Typical: 1-3 business days
• Network: Base (Ethereum L2)
• Token: USDC

Troubleshooting

”wallet_not_linked”

Link a wallet first:

$
PUT /v1/soul/me/link-wallet

“Insufficient balance”

Your pending balance is below the requested amount (minimum $10).

“wallet_already_linked”

That wallet is already linked to another soul. Use a different wallet.

Tax Considerations

Keep records of:

• Total earnings
• Payout transactions
• Transaction hashes for verification