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.