> For the complete documentation index, see [llms.txt](https://mimic-api.gitbook.io/mimic-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mimic-api.gitbook.io/mimic-api-docs/wallets-management/wallets-eoa-1.md).

# /wallets/eoa

Create a new custodial EOA wallet, generating and storing a new keypair managed by Mimic.

```json
{"openapi":"3.1.0","info":{"title":"Mimic API","version":"0.0.1-rc"},"tags":[{"name":"Wallets management","description":"Create and manage wallets. For Safe wallets, compute EIP-712 data to sign via `POST /wallets/safe/prepare`, then submit the signature via `POST /wallets/safe/{id}/execute`. For custodial EOA wallets, create directly via `POST /wallets/eoa`."}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"API key for your Mimic account. Required for every operation except the public reference-data endpoints."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"description":"Client-generated key that makes this request safe to retry. Retrying with the same key returns the original response, or processes the request if the original request failed. Use a value with enough entropy to be unique per request, such as a UUID v4. Keys are scoped to the caller's account and retained for 24 hours, after which the same key may be reused. Reusing a key with a different request body is rejected.","schema":{"type":"string","maxLength":255}}},"schemas":{"Chain":{"type":"string","description":"Identifier of a chain supported by the API.","pattern":"^[a-z0-9-]+$"},"ExternalId":{"type":"string","description":"Client-supplied identifier for a wallet. Use it to reference a wallet by an ID from your own system, such as your user's ID.","maxLength":128},"Address":{"type":"string","description":"A valid address on the relevant chain. Format depends on the chain: 0x-prefixed 20-byte hex for EVM chains, base58 for other chains (e.g. Solana, Tron)."},"Error":{"type":"object","properties":{"message":{"type":"string"}}}},"responses":{"BadRequest":{"description":"Bad request — invalid parameters or body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Unauthorized — missing or invalid credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Conflict":{"description":"Conflict — the `Idempotency-Key` was reused with a different request body, or a request with the same key is still in flight.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/wallets/eoa":{"post":{"tags":["Wallets management"],"description":"Create a new custodial EOA wallet, generating and storing a new keypair managed by Mimic.","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["chain"],"properties":{"chain":{"allOf":[{"$ref":"#/components/schemas/Chain"}],"description":"Chain for which to create the wallet."},"externalId":{"$ref":"#/components/schemas/ExternalId"}}}}}},"responses":{"200":{"description":"The newly created EOA wallet.","content":{"application/json":{"schema":{"type":"object","required":["chain","address"],"properties":{"chain":{"allOf":[{"$ref":"#/components/schemas/Chain"}],"description":"Chain this wallet was created for."},"address":{"allOf":[{"$ref":"#/components/schemas/Address"}],"description":"Address of the created EOA wallet, in the format used by the requested chain."},"externalId":{"$ref":"#/components/schemas/ExternalId"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"409":{"$ref":"#/components/responses/Conflict"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://mimic-api.gitbook.io/mimic-api-docs/wallets-management/wallets-eoa-1.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.