Credits

Credit management and retrieval

Get user credits

get

https://credits.decentraland.orghttps://credits.decentraland.zone

/users/{address}/credits

Returns all credits for a specific user with their current status. Returns 401 if the user is flagged for multi-accounting or captcha violations.

Path parameters

addressstringRequired

User's Ethereum address

Example: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbPattern: ^0x[a-fA-F0-9]{40}$

Query parameters

statusstring · enumOptional

Filter credits by status. If not provided, returns AVAILABLE and PARTIALLY_USED credits

Example: AVAILABLEPossible values:

Responses

200

User credits retrieved successfully

application/json

totalCreditsnumberRequired

Total available credits amount

400

Bad request - Invalid address format

application/json

401

User is flagged - The user has been flagged for multi-accounting or captcha violations

application/json

404

User not found

application/json

get/users/{address}/credits

HTTPcURLJavaScriptPython

GET /users/{address}/credits HTTP/1.1
Host: credits.decentraland.org
Accept: */*

{
  "credits": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "amount": 1,
      "status": "AVAILABLE",
      "createdAt": "2026-08-07T19:11:12.765Z",
      "expiresAt": "2026-08-07T19:11:12.765Z",
      "signature": "text",
      "seasonId": 1,
      "goalId": "text"
    }
  ],
  "totalCredits": 1
}

Get credits stream (SSE)

get

https://credits.decentraland.orghttps://credits.decentraland.zone

/users/{address}/credits/stream

Server-sent events endpoint for real-time credit balance updates. Provides a persistent connection that streams credit updates as they occur.

Path parameters

addressstringRequired

User's Ethereum address

Example: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbPattern: ^0x[a-fA-F0-9]{40}$

Responses

200

Server-sent events stream

text/event-stream

stringOptional

SSE stream with credit updates in event stream format

404

User not found

application/json

get/users/{address}/credits/stream

HTTPcURLJavaScriptPython

GET /users/{address}/credits/stream HTTP/1.1
Host: credits.decentraland.org
Accept: */*

event: credit_update
data: {"credits": [...], "totalCredits": 100}