GET /api/v1/wallets

Returns wallets 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.

Query parameters

  • paymentMethodType string

    Optional payment method type filter for fiat wallets.

  • networkName string

    Optional network name filter for crypto wallets.

Responses

  • 200 application/json

    Wallets returned successfully

GET /api/v1/wallets
curl \
 --request GET 'https://api.lumetrade.com/api/v1/wallets' \
 --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
  }
]