Lumetrade Staging API
GET /api/v1/wallets/{walletId}

Returns one wallet belonging to the authenticated API key owner.

Headers

  • X-API-KEY string Required

    Public API key issued from the Lumetrade API key management flow.

  • X-API-SECRET string Required

    API secret paired with the public API key.

Path parameters

  • walletId string Required

    Wallet id returned by the wallet list endpoint.

Responses

  • 200 application/json

    Wallet returned successfully

  • 404 application/json

    Wallet was not found for the authenticated user

    Hide response attributes Show response attributes object
    • id string

      Stable wallet id used by external wallet endpoints.

    • currency string

      Wallet currency code.

    • depositDetails object

      Raw withdrawal details stored as JSON object.

      Additional properties are allowed.

      Hide depositDetails attributes Show depositDetails attributes object
      • pojo boolean
      • int boolean
      • double boolean
      • bigDecimal boolean
      • bigInteger boolean
      • nodeType string

        Values are ARRAY, BINARY, BOOLEAN, MISSING, NULL, NUMBER, OBJECT, POJO, or STRING.

      • container boolean
      • short boolean
      • long boolean
      • valueNode boolean
      • missingNode boolean
      • floatingPointNumber boolean
      • integralNumber boolean
      • string boolean
      • boolean boolean
      • object boolean
      • textual boolean Deprecated
      • binary boolean
      • number boolean
      • array boolean
      • empty boolean
      • null boolean
      • float boolean
      • embeddedValue boolean
    • networkName string

      Crypto network name when available.

    • paymentMethodType string

      Fiat payment method type when available.
GET /api/v1/wallets/{walletId} 
curl \
 --request GET 'https://api.lumetrade.com/api/v1/wallets/wal_3Q8M1K' \
 --header "X-API-KEY: string" \
 --header "X-API-SECRET: string"
Response examples (200)
Fiat virtual EFT wallet 
{
  "id": "wal_3Q8M1K",
  "currency": "ZAR",
  "depositDetails": {
    "bankName": "Nedbank",
    "accountName": "Example Customer",
    "accountNumber": "9876543210",
    "accountType": "Current",
    "branchCode": "198765"
  },
  "networkName": null,
  "paymentMethodType": "EFT"
}
Crypto wallet 
{
  "id": "wal_7K9Q2M",
  "currency": "BTC",
  "depositDetails": {
    "address": "bc1qexample...",
    "address_tag": "123456"
  },
  "networkName": "Bitcoin",
  "paymentMethodType": null
}
Response examples (404) 
{
  "id": "wal_3Q8M1K",
  "currency": "BTC",
  "depositDetails": {
    "bankName": "FNB",
    "accountNumber": "1234567890"
  },
  "networkName": "Bitcoin",
  "paymentMethodType": "EFT"
}