Skip to main content
GET
/
user
/
wallet
/
balance
Get wallet balance
curl --request GET \
  --url https://api.skinshark.gg/user/wallet/balance \
  --header 'api-key: <api-key>'
{
  "requestId": "<string>",
  "success": true,
  "data": {
    "balance": 1
  },
  "error": {
    "code": 1500,
    "key": "INSUFFICIENT_BALANCE",
    "message": "Insufficient balance"
  }
}

Authorizations

api-key
string
header
required

Your raw API key. Generate, rotate, and revoke keys from the merchant dashboard. Keys can optionally be bound to one or more allowed source IPs — requests from any other IP are rejected with API_KEY_IP_DENIED.

Headers

On-Behalf-Of
string

Sub-user UUID or the merchant's externalId for that sub-user. Required for sub-user-context routes; rejected (via requireMerchant) on merchant-context routes.

Required string length: 1 - 128

Response

OK.

requestId
string
required
success
boolean
required
data
object

Sub-user wallet shape returned by /user/wallet/balance.

error
object