> For the complete documentation index, see [llms.txt](https://relationlabs.gitbook.io/relation-one-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://relationlabs.gitbook.io/relation-one-api/api/profile/bind-address.md).

# Bind Address

## <mark style="color:green;">POST</mark> /api/v1/bindAddress

* Note: It is for a user to bind a new address.
* Header

| Field           | Type   | Remarks                                                                                                                                                                                                 |
| --------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ApiKey          | String | [ApiKey](/relation-one-api/guide/glossary.md#apikey) acquired from the admin                                                                                                                            |
| Authorization   | String | Bearer ${unifiedAuthToken} , in which the unifiedAuthToken is the result returned by /api/v1/auth                                                                                                       |
| I-Authorization | String | Bearer ${addressAuthToken},in which the addressAuthToken is signed by the private key of address**to be binded** and subsequently acquired with the signature authenticationprocess through the JS-SDK. |

* Request Example

```shell
curl POST 'https://api.relationlabs.ai/api/v1/bindAddress' \
--header 'I-Authorization: Bearer eyJ0eXA1iOiJKV1QiLCJhbGciOiJFUzI1NiJ9.eyJleHAiOjE2NzA4ODk0NDEsImlhdCI6MTY2MDgwOTQ0MSwiaXNzIjoicmVsYXRpb25sYWJzLmFpIiwic3ViIjoiMHgxZTU2MmFhYzRiZWFjNDUwYWI5OGQzNzlhYjBkMWQxYjQ0YzMyNWIzIiwid2FsbGV0TmFtZSI6Im1ldGFt1YXNrIiwiY2hhaW5OYW1lIjoiZXRoIn0.2wFJmR2D3inHMItBugoaVE3MOSLnG1ylJEyU38WU0Gg1LIqajhzvcYYHC5ah3r7-FFBhbWGk9WW3KxN_h5K1zZA' \
--header 'ApiKey:  <ApiKey>' \
--header 'Authorization: bearer eyJhbG1ciOiJFUzI1NiJ9.eyJqdGkiOiJhMzE2ZWZiMGM1Njg0Nj1QyOWNjNTliZDRiNjJiZTMwZiIsImlzcyI6InJlbGF0aW9ubGFicy5haSIsImlhdCI6MTY2MTMyMzM5NCwic3ViIjoiYmFmMzQta2lhYWEtYWFhYWstYWNnamEtY2FpIiwiZXhwIjoxNjYxOTI4MTk0fQ.xFTZ7iledMt8ZRepm64EiY6eajGGJQ5YhwCLM-gC5qpABCEsji282WP72e92ZmBlUJwVAZ-K81TUmaNcCbc-lYg'
```

* Response Parameters

| Field | Type   | Remarks            |
| ----- | ------ | ------------------ |
| code  | String | the Return Code    |
| desc  | String | the Return Message |
| data  | Object | the Data           |

* Response Body

```json
{
    "code": "0",
    "desc": "success",
    "data": null
}
```

* Return Code

| code  | desc                       | Remarks                           |
| ----- | -------------------------- | --------------------------------- |
| 0     | success                    | the flag for a successful request |
| 11201 | address is already binded. | The address is already binded.    |