Campaigns
Tasks and raffle tickets
Every task type and how tickets are counted.
Tasks are what people do to enter a campaign. A campaign has one to ten of them and every one must be done to join a raffle or claim in a first-come campaign. Some tasks can also give raffle tickets: more tickets, better odds of winning.
Task types
Every partner can use these:
| Task | What the player does | Raffle tickets |
|---|---|---|
| Open a link | Opens the link. It counts 10 seconds after the first click. | No |
| Hold an NFT | Holds at least a set number of NFTs from a collection. One NFT can't qualify two wallets in the same campaign. | No |
| Hold a token | Holds at least a set amount of a token. Checked again when the campaign ends (raffle) or at the claim (first come). | No |
| Open boxes | Buys and opens at least a set number of Gifted Stock boxes. The partner can count one chain or both and normal boxes, premium boxes or all. | No |
| Swap on Gifted Stock | Trades at least a set amount in dollars on our Swap tab or Portfolio, on one chain or both. Stock trades only or every swap (bridges never count). | Yes |
| Whitelist | Is on the partner's own list of wallets. | No, but a wallet's number on the list multiplies its tickets |
| Check your API | Does something in the partner's own app, which the partner's server confirms. | No |
Hold tasks work on Base, Robinhood Chain, Ethereum, Optimism, Arbitrum, Polygon and BNB. Each task has its own button on the campaign page. If a check comes back short, it can be pressed again after 30 seconds.
Some projects also have their own task types, made for their app and open only to them, like trading on their platform.
Time frames
The open boxes and swap tasks count activity in one of three time frames, picked by the partner:
- during campaign (the default): from the moment the campaign went live.
- all time: everything up to the campaign's end.
- since a date: from the start of a day the partner picks, in UTC.
How raffle tickets are counted
- Without tickets, every wallet that finishes all tasks has one entry.
- A ticket task gives one ticket for each amount the partner sets, rounded down. At 1 ticket every $100 traded, $450 gives 4 tickets.
- One task gives at most 100 tickets or the partner's own cap (up to 1,000).
- Tickets from all tasks add up. Every wallet that joined has at least 1.
- On a wallet list, a wallet's number multiplies its tickets.
- Tickets are counted again when the campaign ends, so activity up to the last minute counts.
- Each ticket is a chance in the draw. A wallet wins once at most.
Whitelist
The partner uploads a csv file: a wallet in the first column and, optionally, a number in the second. Up to 10,000 wallets.
- First come: the number is how many boxes that wallet claims. A line without one is 1.
- Raffle: the number multiplies that wallet's tickets, up to 1,000. A raffle can't have more winners than the list has wallets.
- Wallets on the list join without verifying.
- Anyone can check whether one wallet is on a list, but nobody can download the list.
Check your API
The partner gives us an address on its own server. Each time someone presses Verify, we send it the wallet and the chain the partner picked, nothing else. The server answers done or not yet, with a message the player reads. It gives no raffle tickets. It uses Zealy's format, so an endpoint built for Zealy works as it is. Details for developers: Request and answer.
Custom tasks
If you want a custom task for your app, feel free to reach out on Telegram: t.me/alitiknazoglu ↗