> For the complete documentation index, see [llms.txt](https://space-vizsla.gitbook.io/moonpup-bot-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://space-vizsla.gitbook.io/moonpup-bot-guide/moonpup-guide/transactions-sends-swaps-and-giveaways.md).
# Transactions - Sends, Swaps, and Giveaways
### ***/send***
**Description:** Send tokens to one or more users or an address. Specify @user or public address and amount. You can optionally choose to mint the receiving users token account if they do not have one (by default a token account will not be minted when sending to users, and will be minted when sending to an external public key) . The token sent will be the serverβs default token when used in a server with a default token set. In a direct message or in a server without a default token set, the senders global default token will be used.
{% hint style="success" %}
**Required Input:** *user\_or\_address:* Specify a user in the format @user or a valid Solana public key. You can send to multiple users by listing multiple users with a space in between, ex: @user1 @user2 @user3.
**Required Input:** *amount:* Amount of tokens to send. If multiple users are specified this amount will be sent to each user.
{% endhint %}
{% hint style="success" %}
**Optional Input:** *mint\_receiver\_account:* Specify true or false (not case sensitive) to dictate whether you want to mint a token account for the token receiver (costs approximately .002 SOL). If true is specified you will mint a token token account for the receiving user if they have none. If false is specified the transaction will fail if the receiving user does not have a token account. By default (if left blank) this parameter is false for token sends to users and true for sends to public addresses.
{% endhint %}
### ***/send\_sol***
**Description:** Sends Solana to a user or public Solana address.
{% hint style="success" %}
**Required Input:** *user\_or\_address:* Specify a user in the format @user or a valid Solana public key.
**Required Input:** *amount:* Amount of SOL to send.
{% endhint %}
{% hint style="success" %}
**Optional Input:** *memo:* Adds a memo to your Solana transaction on the blockchain. This can be a word, sentence, or any string.
{% endhint %}
### ***/send\_special***
**Description:** Basic command for sending token with a custom mint address to one or more users or an address. Works like /send, except you specify the token mint to be sent. This can be an NFT.
{% hint style="success" %}
**Required Input:** *user\_or\_address:* Specify a user in the format @user or a valid Solana public key. You can send to multiple users by listing multiple users with a space in between, ex: @user1 @user2 @user3. (note trying to send an NFT to multiple users will fail....)
**Required Input:** *amount:* Amount of tokens to send. If multiple users are specified this amount will be sent to each user.
**Required Input:** *token\_mint:* Mint address of the token or NFT to send.
{% endhint %}
{% hint style="success" %}
**Optional Input:** *mint\_receiver\_account:* Specify true or false (not case sensitive) to dictate whether you want to mint a token account for the token receiver (costs approximately .002 SOL). If true is specified you will mint a token token account for the receiving user if they have none. If false is specified the transaction will fail if the receiving user does not have a token account. By default (if left blank) this parameter is false for token sends to users and true for sends to public addresses.
{% endhint %}
### ***/swap***
**Description:** Swap tokens or SOL for other tokens or SOL! This command will return the best quote available from [Jupiter Aggregator](https://jup.ag) for a given swap. To confirm swap click the confirm button and your swap will be submitted. Quotes expire after 60 seconds and you will need to re-use the command to generate a new quote.
{% hint style="success" %}
**Required Input:** *swap\_token:* Specify a token's ticker (ex. SVIZ) or mint address. This is the token you want to swap or sell for another token.
**Required Input:** *amount:* Input number of tokens to swap. If you want to swap your max token balance you can put any amount here and update to max balance when you have the quote.
**Required Input:** *receive\_token:* Specify the ticker or mint address for the token you wish to receive.
{% endhint %}
{% hint style="success" %}
**Optional Input:** *slippage:* Input a percentage without the % sign (ex: input 1 for 1%). Slippage defines how much the price can slide from the quoted amount before the swap is aborted. This will determine the absolute minimum amount of tokens you will receive. By default (if left blank), this parameter is set to 0.5%.
{% endhint %}
### ***/giveaway***
**Description:** Starts a giveaway! Specify a total amount to giveaway and duration to collect entries. Entrants enter by reacting to the β
emoji. The giveaway pool is split evenly by all entrants. This command uses the server default token when available, or user global default otherwise.
{% hint style="success" %}
**Required Input:** *amount:* The total amount of tokens to giveaway.
**Required Input:** *time\_in\_minutes:* Duration for entry collection in minutes (min 1 minute, max 60 minutes).
{% endhint %}
### ***/giveaway\_random\_4***
**Description:** Starts a giveaway with a 1 in 4 chance to win! Users are prompted to pick the right emoji to win (β π π π). When the giveaway time is up the right emoji is revealed and winners announced!
{% hint style="success" %}
**Required Input:** *amount:* The total amount of tokens to giveaway.
**Required Input:** *time\_in\_minutes:* Duration for entry collection in minutes (min 1 minute, max 10 minutes).
{% endhint %}
### ***/giveaway\_random\_6***
**Description:** Starts a giveaway with a 1 in 6 chance to win! Users are prompted to pick the right emoji to win (β π π π¦ β‘ π). When the giveaway time is up the right emoji is revealed and winners announced!
{% hint style="success" %}
**Required Input:** *amount:* The total amount of tokens to giveaway.
**Required Input:** *time\_in\_minutes:* Duration for entry collection in minutes (min 1 minute, max 10 minutes).
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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://space-vizsla.gitbook.io/moonpup-bot-guide/moonpup-guide/transactions-sends-swaps-and-giveaways.md?ask=
```
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.