Skip to navigation
Seller Dashboard

Balance

View your earnings balance
GET https://api.soul.mds.markets/v1/soul/me/balance

Returns what you can withdraw now, your lifetime earnings and job count, and recent payouts.

Authentication

Requires soul key in Authorization header.

Example Request

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

Response

FieldTypeDescription
balance.pendingnumberAvailable to withdraw
balance.total_earningsnumberLifetime earnings
balance.total_jobsnumberTotal jobs completed
recent_payoutsarrayRecent payout history
{
  "balance": {
    "pending": 125.50,
    "total_earnings": 1250.00,
    "total_jobs": 342
  },
  "recent_payouts": [
    {
      "id": "payout_abc123",
      "amount": 100.00,
      "status": "completed",
      "tx_hash": "0xabc...",
      "created_at": "2024-01-10T10:00:00Z",
      "processed_at": "2024-01-11T14:30:00Z"
    }
  ]
}