# WalletChat API Reference

## Interactive API docs via Swagger

[Swagger API Docs](https://api.v2.walletchat.fun/docs/index.html) are where you can interact with the API live, all you need is a valid JWT for authentication.  Please read the [docs](https://api.v2.walletchat.fun/docs/index.html) to learn more.

## API Key Holders (Paid Tier)

ADMIN API KEY functions allow vetted customer integrations to streamline the user experience, enhancing the integrated sign-in process.\
To authenticate with an API key, the ADMIN\_API\_KEY must be used in place of the end user JWT.

### Important Note for Security

*We ask API key holders to make these requests in a protected manner, mainly from their own API.*

If the ADMIN API key is used in the client browser, it may be misused by malicious actors.

Below are examples of each API which has an ADMIN API Key overrride. `curl` is just used as example,\
replace with equivalent functionality as needed.

### Example for /v1/name

Update the wallet address to name mapping:

```
curl --location 'https://api.v2.walletchat.fun/v1/name'
--header 'Authorization: Bearer AdminTestKey123'
--header 'Content-Type: text/plain'
--data '{
"name": "Nftz4Life",
"address": "0x14ffE94d2B5Bf47a8d55D713b3d6b35039167cfb"
}'
```

### Example for /v1/update\_settings

Update the email address to wallet address mapping:

```
curl --location 'https://api.v2.walletchat.fun/v1/update_settings'
--header 'Authorization: Bearer MyTestApiKey123'
--header 'Content-Type: text/plain'
--data-raw '{
"email": "savemynft@gmail.com",
"walletaddr": "0x14fcE94d2B5Bf47a8d54D713b3d6b35039167cfb"
}'
```