Get Customer Wallets

Retrieve wallet addresses for a customer. Returns all wallets associated with the specified customer, including wallet address, currency details, and blockchain network.

Sample API Request: GET

URL: https://caas-staging.coinme.com/services/wallets

Headers:
{
  "Authorization": "asdfghj", //required, authorization token
  "User-Agent": "partnerapi" //required
}

Request Body:
{
  "customerId": "c1234-a56b-78c9-d012-345678901234", //unique identifier for the customer, required
}

Sample API Response:

Successful Response:
{
  "walletAddresses": [
    {
      "walletAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
      "currencyName": "Bitcoin",
      "currencySymbol": "BTC",
      "assetId": "btc-main",
      "chain": "BTC"
    },
    {
      "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD3e",
      "currencyName": "Ethereum",
      "currencySymbol": "ETH",
      "assetId": "eth-main",
      "chain": "ETH"
    }
  ],
  "errorResponse": null
}

Failure Response:
{
  "walletAddresses": null,
  "errorResponse": {
    "httpStatus": "200",
    "timestamp": "2025-01-09T14:30:00.000Z", //UTC
    "path": "/services/wallets GET",
    "errorData": [
      {
        "errorCode":"123-123-123-123",//The error code is just a sample showing the structure of the error code.
        "message":"Customer Id not found"
      }
    ]
  }
}

Error Codes


Error CodeDescription
198-400-202-304No wallets for %s