Skip to main content

Get wallet

GET 
/wallet

Returns the authenticated player's wallet.

Behavior:

  • If wallet exists, it is returned.
  • If wallet does not exist yet, backend auto-creates an empty wallet (gems = 0) and returns it.

Request​

Responses​

Successful Response

Response shape​

{
  "id": 10,
  "user_id": 42,
  "gems": 1250,
  "created_at": "2026-04-15T10:30:00Z",
  "updated_at": "2026-04-15T12:45:00Z"
}

cURL example​

curl -X GET "http://localhost:8001/wallet" \
  -H "x-client-id: <client-id>" \
  -H "x-client-secret: <client-secret>" \
  -H "Authorization: Bearer <access-token>"