Skip to main content

Get wallet history

GET 
/wallet/history

Returns wallet transactions for the authenticated player.

Behavior:

  • If wallet exists, returns transaction list ordered newest first.
  • If wallet does not exist, returns 404 Wallet not found.

Amount semantics:

  • positive amount = gems credited
  • negative amount = gems debited
  • balance_after = resulting wallet balance after that transaction

Request​

Responses​

Successful Response

Response shape​

{
  "transactions": [
    {
      "id": 301,
      "wallet_id": 10,
      "amount": -150,
      "balance_after": 1250,
      "description": "Store redemption: Amazon INR 100",
      "created_at": "2026-04-15T12:45:00Z",
      "updated_at": "2026-04-15T12:45:00Z"
    },
    {
      "id": 300,
      "wallet_id": 10,
      "amount": 200,
      "balance_after": 1400,
      "description": "Daily streak reward",
      "created_at": "2026-04-15T09:00:00Z",
      "updated_at": "2026-04-15T09:00:00Z"
    }
  ]
}

cURL example​

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