# Generating a new address

The first step to be able to send and receive Hycon is by creating a new wallet.

**Request Body - `Content-Type: application/json;charset=utf-8`**

| Parameter  | Type   | Required | Description                                                                      |
| ---------- | ------ | -------- | -------------------------------------------------------------------------------- |
| `mnemonic` | string | No       | A 12- to 24-word BIP39 phrase to seed your wallet's private key                  |
| `language` | string | No       | Regional language to generate your wallet's mnemonic phrase (*Default: English*) |

Please check *Appendix > Language Support* for more information. **$language** is not case-sensitive.

**Response - `200 OK, application/json`**

| Parameter    | Type   | Description                                                     |
| ------------ | ------ | --------------------------------------------------------------- |
| `mnemonic`   | string | A 12- to 24-word BIP39 phrase to seed your wallet's private key |
| `privateKey` | string | The generated private key from the mnemonic                     |
| `address`    | string | The generated Hycon wallet address                              |

**Response Error Table**

| Status | Error               | Message                                              |
| ------ | ------------------- | ---------------------------------------------------- |
| 400    | `INVALID_PARAMETER` | mnemonic or language is invalid/mismatched           |
| 404    | `NOT_FOUND`         | the resource cannot be found / currently unavailable |

POST/api/v1/wallet

**Example request body**

```
{
	"mnemonic": "someone window crucial magic shoulder latin satisfy total siege curtain candy trip",
	"language": "english"
}
```

**Example request**

```
$ curl -X POST http://localhost:2442/api/v1/wallet \
    -H 'Content-Type: application/json;charset=utf-8' \
    -d '{
	  "mnemonic": "someone window crucial magic shoulder latin satisfy total siege curtain candy trip",
	  "language": "english"
    }'
```

**Response (Success)**

```
{
    "mnemonic": "someone window crucial magic shoulder latin satisfy total siege curtain candy trip",
    "privateKey": "7bf8ec7059c3f5237ec2651dbb1997f0288a260e1f9335ecf33df49b148b0710",
    "address": "H34kywGZSMUdPSCa3rqJLeHaRqigS3Bnt"
}
```


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://teamhycon.gitbook.io/docs/api-v1-4/address-management/generating-a-new-address.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
