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

# API Key

## Acquire API Keys

In order to use our API directly first need to generate API Keys

In order to do so please **Connect wallet** and select option `API Keys` to prove you are address owner.

<figure><img src="https://600351671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw1jHAO4sbMgo151ZR1RW%2Fuploads%2FGZ2fj8kbPFXQMI6yKIw1%2Fimage.png?alt=media&amp;token=dcd70f67-41d4-4c64-9e6c-44a613010675" alt=""><figcaption><p>Connect Wallet Button</p></figcaption></figure>

<figure><img src="https://600351671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw1jHAO4sbMgo151ZR1RW%2Fuploads%2FOOrnqdXlq2pZbGDD2UBr%2Fimage.png?alt=media&amp;token=b99e671d-9f1d-40ed-b936-7a03b088d7a4" alt=""><figcaption><p>Select API Keys once wallet is connected</p></figcaption></figure>

<img src="https://beravote.gitbook.io/~gitbook/image?url=https%3A%2F%2F688931668-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fz4Hkkmcf9fSfCFmzRZ7W%252Fuploads%252FpSjA6QaykbHA8tGMJd3U%252FScreenshot%2520from%25202025%252003%252004%252020%252032%252055.png%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=a50cbcee&#x26;sv=2" alt="Sign the text that includes your address and timestamp" height="771" width="386">

<img src="https://beravote.gitbook.io/~gitbook/image?url=https%3A%2F%2F688931668-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fz4Hkkmcf9fSfCFmzRZ7W%252Fuploads%252FBlGWB6XDEN6N9wwFRGlT%252FScreenshot%2520from%25202025%252003%252004%252020%252017%252058.png%3Falt%3Dmedia&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=c2232138&#x26;sv=2" alt="Copy API key for the required domain" height="723" width="497">

## Using API Key

After you received and copied the API key you must add it in **Authorization** header like `Authorization: Bearer xxxx`

where xxxx is your API Key.

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer xxxx`      |

## Limits

Rate limit is **20 request per minute**, in case you get over the limit you would get value **in seconds** when you could retry the next request in `Retry-After` or `X-RateLimit-Reset` in response headers and error response in **429** status looking similar to that one:

`{`

`error: "Rate limit exceeded", message: Slow down, try again in 22 seconds.`

`}`