> For the complete documentation index, see [llms.txt](https://coat.gitbook.io/tokeninfo.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coat.gitbook.io/tokeninfo.ai/airdrop-csv-template-documentation.md).

# Airdrop CSV Template Documentation

### Overview

To facilitate the processing and management of airdrop data, TokenInfo.AI requires a specific CSV format for the airdrop parsing endpoint. This document provides detailed instructions on how to prepare the CSV file to ensure seamless integration and accurate data handling.

### CSV Template Structure

The CSV file must adhere to the following structure, with each row containing specific data fields:

#### Rows Description

1. **Address**:
   * **Description**: The recipient's wallet address.
   * **Example**: `0xD88394136da1f712b7eccd74bdb0a39c4a4af348`
2. **Amount**:
   * **Description**: The amount of tokens to be airdropped.
   * **Example**: `30`
3. **Start Date**:
   * **Description**: The start date of the airdrop in ISO 8601 string format.
   * **Example**: `2024-07-15T17:31:14.036Z`
4. **Cliff Period**:
   * **Description**: The cliff period in number of days.
   * **Example**: `10`
5. **Interval Setting**:
   * **Description**: An array specifying the percentage of tokens to distribute and the interval in days.
   * **Example**: `[50, 20]`

#### Sample CSV

Below is an example of how the CSV file should be structured:

```
0xD88394136da1f712b7eccd74bdb0a39c4a4af348, 30, 2024-07-15T17:31:14.036Z, 10, [50,20]
```

#### Detailed Explanation

1. **Address**:
   * This is the Ethereum wallet address of the recipient who will receive the tokens.
   * Ensure the address is valid and correctly formatted.
2. **Amount**:
   * The number of tokens to be airdropped to the specified address.
   * This value should be an integer representing the token amount.
3. **Start Date**:
   * The date and time when the airdrop will commence.
   * Use ISO 8601 format (e.g., `YYYY-MM-DDTHH:MM:SS.SSSZ`).
4. **Cliff Period**:
   * The initial period (in days) during which no tokens are released.
   * This value should be an integer representing the number of days.
5. **Interval Setting**:
   * An array specifying the distribution settings:
     * The first element is the percentage of tokens to distribute at each interval.
     * The second element is the number of days between each distribution.
   * Ensure the percentage and interval are appropriately formatted within the array.

### Preparing Your CSV File

To prepare your airdrop CSV file, follow these steps:

1. Open a spreadsheet application (e.g., Microsoft Excel, Google Sheets).
2. Create a new spreadsheet.
3. Populate each row with the required data fields as described above.
4. Save the file in CSV format (Comma Separated Values).

### Example CSV Content

Here's an example of the content within the CSV file:

```
0xD88394136da1f712b7eccd74bdb0a39c4a4af348, 30, 2024-07-15T17:31:14.036Z, 10, [50,20]
```

By following this template, developers can ensure their airdrop data is correctly formatted for processing by the TokenInfo.AI platform, enabling efficient and accurate token distribution.