> For the complete documentation index, see [llms.txt](https://2435ghj424g6j.gitbook.io/gm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://2435ghj424g6j.gitbook.io/gm/application/api-keys.md). # API Keys ### Introduction API keys are essential for accessing our API and ensuring the security and stability of your applications. By following a few simple steps on our platform, you can generate unique API keys tailored to your needs. ### How to manipulate the API Keys This section will help you create and manage your API keys. We will cover how to: * generate an API key * copy it to clipboard * view all keys * deactivate a key To execute any of these actions, please proceed to the API keys section within the Offsetdata Application by following these two steps: 1. Log in to your account on our [platform](https://app.offsetdata.com/). 2. Navigate to the [API Keys ](https://app.offsetdata.com/apikeys)section. All subsequent actions will lead you through the API keys workflows, assuming that you always begin by navigating to the [API Keys](https://app.offsetdata.com/apikeys) section. #### How to generate an API key To generate API keys, please follow these steps: 1. Open the API key creation modal by clicking on the "Create API Key" button. 2. Populate the text field with your API key name. > For example, your API key name could be "pollution-data-api-key". A well-chosen name is descriptive and memorable. > You can generate up to 10 API keys to suit your requirements. 3. Click the "Create" button. > The API key will be generated internally and the hash will appear at the bottom of the modal. #### How to copy an API key To copy an API key hash to clipboard, please follow these steps: 1. Click on the "reveal" icon located on the far left side of the API key record:

Reveal API key record

> This action will unveil the API key hash, displaying the actual hash instead of a series of asterisks. 2. Click the copy icon at the end of the API key hash as shown in the image below:

Copy API key record

> This action will copy the hash to your clipboard, allowing you to paste it wherever needed. #### How to view all API keys To view your API keys collection, simply navigate to the API section. The view section will resemble the image below.

View all API keys

When viewing the list of your API keys, you will see the following information: * **Reveal API key hash toggle button:** The button that allows you to reveal the API key hash in order to be copied to clipboard. * **API key name:** The name that you selected when the key was created. * **API key hash:** This is the unique identifier generated internally by the Offsetdata Application. * **Creation Date:** The date when the key was created. * **Active key status**: Active keys are displayed in green and indicate that they are currently active and can be used to access our API. * **Revoked (inactive) key status**: Revoked keys are displayed in red and indicate that they are no longer active. These keys have been disabled and cannot be used to access our API. #### How to revoke an API key To revoke an API key click on the green toggle button located on the far right of the API key record, as shown in the image below.

Before revoking an API key

The toggle button will change to red, and the status "Revoked" will be indicated on the API key card, as demonstrated in the image below.

After revoking an API key

### Customizing API Keys We understand the importance of easy identification and organization. That's why we allow you to customize your API keys with descriptive names. By assigning meaningful names, you can easily identify each key and reflect the purpose of your Web3 project. ### Key Security and Revocation It is crucial to maintain the security of your API keys. Please adhere to the following guidelines: * **Do not share your API keys**: We strongly recommend that you do not display your keys to anyone. Sharing your keys can compromise the security of your applications and may result in unexpected billing. * **Revoke keys when necessary**: You have full control over your API keys and can revoke them at any time. If you suspect unauthorized access or need to restrict access for any reason, you can revoke a key to disable it immediately. ### TL;DR API keys are a fundamental aspect of accessing Offsetdata's API securely. By following the guidelines outlined in this documentation, you can generate, customize, and manage your API keys effectively. Remember to keep your keys secure and use them only for their intended purposes to prevent misuse. If you have any further questions or need assistance, please refer to our additional documentation or contact our support team. --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://2435ghj424g6j.gitbook.io/gm/application/api-keys.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.