Disclaimer

<aside> ⚠️ This is the first version of the Airdrop API, which is currently in a developmental stage. The API is subject to changes, including potential modifications to events, request formats, and response formats.

We require our partners to actively assist us by identifying and reporting any flaws in the API. It is important to be aware that changes will occur, and a full end-to-end test is required before releasing it to the public.

Additionally, we advise against loading significant amounts of funds into the wallets at this stage, as there is a risk of loss while we continue to fine-tune the system in collaboration with our partners.

We maintain active Telegram group chats with all partners and strive to be responsive and available at all times. Developers should expect some back-and-forth communication and calls to clarify any issues with the API.

When releasing products built on top of the API, we recommend doing so with a beta tag and using a gradual rollout to ensure everything works smoothly.

</aside>


Introduction

Flooz is developing secure payment rails for:

The Airdrop API is a powerful tool designed to simplify token distribution and enhance community engagement for token teams.

It allows token teams, project managers, and community leaders to easily distribute tokens to their community members natively on Telegram using Telegram usernames.

Developers can leverage the Airdrop API to streamline the complex process of token airdrops based on triggers and actions. With just a few API calls, you can enable your token teams to reward community members for raiding tweets, creating content, joining VoiceChats, joining a community and encourage engagement and growth

We encourage developers to innovate and build new experiences and use cases.

By integrating the Airdrop API, you can save time on manual distribution processes, reduce the risk of errors (e.g. fatfingers), and focus more on building and growing your project. The API is designed to be developer-friendly, with clear documentation to ensure a smooth integration process.

Glossary

Term Description
Airdrop The act of sending funds from a sender’s wallet to a recipient's wallet without requiring any action from the recipient.
Airdrop Wallet The source wallet from which funds are deducted for the recipients of an airdrop.
Airdrop Wallet Intent A transient object used to securely carry the information needed for the creation of an airdrop wallet.
Airdrop Payout The actual act of sending funds.
Wallet Owner The actual owner of the wallet. Note that Flooz does not have access to seed phrases or private keys. Refer to the detailed section below for more information.
Admin The Telegram Admin with the access rights to perform changes on the airdrop wallet settings and funds. Only Telegram admins who can add other admins have these access rights.
Partner An external system that instructs Flooz to execute payouts and gather information.
Custodians A partner application granted access to airdrop functionality by the Admin.
Supported networks The Airdrop API works across Ethereum, BASE, Polygon, Binance Smart Chain, Arbitrum, Avalanche, Optimism.

Next up: BLAST, Linea, Mantle, Solana |