---
updatedAt: 2025-07-26T14:29:17.000Z
agentTools:
  projectIndex: https://docs.metakeep.xyz/llms.txt
---

# Get User Wallet (Batch)

This API allows you to get user wallets for a list of users.

For user privacy and security, and to prevent abuse, this API has a few restrictions:

1. You can only query wallets for `up to 50 users` at a time.
2. You can only query wallets for users that have been `queried previously` using the [User Wallet](https://docs.metakeep.xyz/reference/v3getwallet) API. The API response will be missing wallets for users that have not been queried previously.
3. The API only returns `ethAddress` and `solAddress` for now. If you need other addresses, please get in touch with us.
4. This API is only designed for dashboard use cases and has more restrictive rate limits. If you are performing an operation on a user's wallet, please use the [User Wallet](https://docs.metakeep.xyz/reference/v3getwallet) API instead.

```json Sample Request
{
  "users": [
    {
      "email": "dave@gmail.com"
    },
    {
      "email": "john@gmail.com"
    },
    {
      "email": "alice@gmail.com"
    }
  ]
}
```
```json Sample Response
{
  "status": "SUCCESS",
  "wallets": [
    {
      "user": {
        "email": "dave@gmail.com"
      },
      "wallet": {
        "ethAddress": "0xff8DCF9bAa09cA271619751c352de92A15F57FF8",
        "solAddress": "GVhpewzamLhgEGGGGTTAeymhXiL1Tk1GmjjL3hT7chHo"
      }
    },
    {
      "user": {
        "email": "john@gmail.com"
      },
      "wallet": {
        "ethAddress": "0x6B40cA2814198A37BA5798B0C5EE1A2E029b997f",
        "solAddress": "Hccs9W3PpZzfdd7Y92CKwZ3nL4GDeuM76XC8W6wJDrgX"
      }
    },
    {
      "user": {
        "email": "alice@gmail.com"
      },
      "wallet": {
        "ethAddress": "0x8dc572d9FefB6A8d6c76897AF11dDf1dEbCEAfd0",
        "solAddress": "Ggh19W3PpZzfdd7Y92CKwZ3nL4GDeuM76XC8W6wJDrgX"
      }
    }
  ]
}
```

> 🚧 API Error Status
>
> You can find error status returned by the api [here](https://docs.metakeep.xyz/reference/api-error-status#v3getwalletmultiple).

© Copyright 2024, Passbird Research Inc.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "production",
    "version": "3.4"
  },
  "servers": [
    {
      "url": "https://api.metakeep.xyz/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v3/getWallet/multiple": {
      "post": {
        "summary": "User Wallet (Batch)",
        "description": "",
        "operationId": "v3getwalletmultiple",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "users"
                ],
                "properties": {
                  "users": {
                    "type": "array",
                    "description": "List of user identifiers.",
                    "items": {
                      "properties": {
                        "email": {
                          "type": "string",
                          "description": "Email address of the user",
                          "default": "dave@example.com"
                        }
                      },
                      "type": "object"
                    }
                  }
                }
              },
              "examples": {
                "Request Example": {
                  "value": {
                    "users": [
                      {
                        "email": "dave@example.com"
                      },
                      {
                        "email": "dave@example.com"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"status\": \"SUCCESS\",\n  \"wallets\": [\n    {\n      \"user\": {\n        \"email\": \"dave@gmail.com\"\n      },\n      \"wallet\": {\n        \"ethAddress\": \"0xff8DCF9bAa09cA271619751c352de92A15F57FF8\",\n        \"solAddress\": \"GVhpewzamLhgEGGGGTTAeymhXiL1Tk1GmjjL3hT7chHo\"\n      }\n    },\n    {\n      \"user\": {\n        \"email\": \"john@gmail.com\"\n      },\n      \"wallet\": {\n        \"ethAddress\": \"0x6B40cA2814198A37BA5798B0C5EE1A2E029b997f\",\n        \"solAddress\": \"Hccs9W3PpZzfdd7Y92CKwZ3nL4GDeuM76XC8W6wJDrgX\"\n      }\n    },\n    {\n      \"user\": {\n        \"email\": \"alice@gmail.com\"\n      },\n      \"wallet\": {\n        \"ethAddress\": \"0x8dc572d9FefB6A8d6c76897AF11dDf1dEbCEAfd0\",\n        \"solAddress\": \"Ggh19W3PpZzfdd7Y92CKwZ3nL4GDeuM76XC8W6wJDrgX\"\n      }\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "SUCCESS"
                    },
                    "wallets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "user": {
                            "type": "object",
                            "properties": {
                              "email": {
                                "type": "string",
                                "example": "dave@gmail.com"
                              }
                            }
                          },
                          "wallet": {
                            "type": "object",
                            "properties": {
                              "ethAddress": {
                                "type": "string",
                                "example": "0xff8DCF9bAa09cA271619751c352de92A15F57FF8"
                              },
                              "solAddress": {
                                "type": "string",
                                "example": "GVhpewzamLhgEGGGGTTAeymhXiL1Tk1GmjjL3hT7chHo"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"status\": \"INVALID_EMAIL\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "INVALID_EMAIL"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "403",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"status\": \"FORBIDDEN\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "FORBIDDEN"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```