# Creating a Token Raffle

Use this flow when the prize is a fungible token.

{% stepper %}
{% step %}

### Start the raffle flow

* Tap the create button to open raffles in private chat and tap Start or Get started.
* When prompted, select the blockchain:
  * Ethereum
  * Base
  * Binance Chain
  * Solana
    {% endstep %}

{% step %}

### Choose prize type

* When asked what you are raffling, choose **tokens**.
* Paste the token contract address for the chain you selected.
* Enter the exact token amount that you want to raffle.

{% hint style="info" %}
Ensure the contract address matches the selected blockchain and the token amount is exact.
{% endhint %}
{% endstep %}

{% step %}

### Set ticket price

* Enter the ticket price for one entry.
  {% endstep %}

{% step %}

### Minimum fundraise goal

Choose whether there is a minimum fundraise goal.

* If yes: enter the minimum amount that must be raised.
* If no: the raffle can complete even if the raise stays small.
  {% endstep %}

{% step %}

### Review base settings

* Review your current settings and go back if you need to edit anything.
  {% endstep %}

{% step %}

### Profit sharing

Choose whether this raffle uses profit sharing.

* If yes:
  * Enter a partner wallet address.
  * Choose a profit share percentage between 1 and 50.
* If no:
  * The group or creator receives the full profit.

{% hint style="info" %}
Profit share percentage must be between 1 and 50.
{% endhint %}
{% endstep %}

{% step %}

### Set end time

Set when the raffle ends:

* Select from preset durations, or
* Enter a Unix timestamp for a custom end time.
  {% endstep %}

{% step %}

### Raffle card message and image

* Write a custom message for the raffle card (between 10 and 500 characters).
* Choose a raffle image:
  * Upload your own image, or
  * Proceed without an image.

{% hint style="info" %}
Message length must be between 10 and 500 characters.
{% endhint %}
{% endstep %}

{% step %}

### Final review and submission

* Review the complete overview of the raffle.
* Submit the raffle.
* After submission, the bot shows a wallet address that must receive the tokens.
  {% endstep %}

{% step %}

### Send tokens to bot

* Send the exact token amount to the displayed bot wallet address.
* Wait for confirmation that the tokens were received.
* Once tokens are confirmed, the raffle goes live.
  {% endstep %}
  {% endstepper %}

Expandable flow (quick visual)

<details>

<summary>Raffle flow steps</summary>

Start raffle in DMs → Select blockchain → Select tokens → Paste contract address → Enter token amount → Set ticket price → Minimum goal? yes/no → Confirm base settings → Profit sharing? yes/no → (If yes: partner wallet + percentage) → Set end time → Custom message + image → Submit raffle → Send tokens to bot wallet → Tokens confirmed → Raffle live

</details>


---

# Agent Instructions: 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:

```
GET https://raffl.gitbook.io/raffl-docs/creating-a-token-raffle.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.