CryptoJar is a crypto wallet and tipping bot that lives inside Discord. Send, share and hold crypto with short commands, without a browser extension, a seed phrase or fees on tips.
What you can do
Tip one person, a role, or a whole group of members, like everyone online or everyone in voice.
Run airdrops, redpackets, phrase drops and game drops with math, trivia and trick-or-treat.
Deposit and withdraw supported crypto, and check your balances at any time.
Sell server roles for crypto with the server store.
Reward active members with XP and automatic roles, and keep the server safe with automod.
How it works
Every Discord user already has a CryptoJar wallet waiting for them. It is created automatically the first time you use a command or receive a tip. Tips, drops and games move instantly inside CryptoJar. Only when you withdraw to your own wallet does the blockchain network fee apply.
All commands start with j or J, for example jtip or Jbalances. There are no slash commands.
Who uses CryptoJar
CryptoJar is a Discord-verified app with all privileged intents approved. It is used by 122,000+ members across 350+ Discord servers, and is rated 5.0 on Top.gg and Blockmap.one.
Send jwithdraw <token> to the bot in a direct message to move funds to your own wallet. Only the blockchain network fee applies.
jwithdraw sol
Getting started
Command basics
Learn the pattern once and you know every command.
The pattern
j<command> <who> <amount> <token> [options]
In these docs, <angle brackets> are required and [square brackets] are optional. You never type the brackets themselves.
Who receives it
Option
What it does
@user
One member
@role
Every member with that role
@here / @everyone / all
Everyone in the channel or server
online / offline
Members by status
active
Members who chatted recently
voice / speaking / streamer
Members in voice, talking, or streaming
random
Random members, e.g. jtip 5 random $.01 sol each
Amounts
Option
What it does
10 smlo
An amount in coins
0.01 sol
A decimal amount
$1
A US dollar value, converted to the token at its live price
max
Your full balance of that token (jtip and jairdrop)
Durations and caps
Drops take a duration such as 5m, 10m or 1h. Many also take a cap: for 100 limits an airdrop to 100 claimers, winners 3 limits a game drop to 3 winners.
Getting started
Fees & limits
CryptoJar is free to use. Here is everything that costs something or has a limit.
Fees
Tips, airdrops, redpackets, game drops and faucet claims: no fee.
Withdrawals to your own wallet: only the blockchain network fee.
Limits
What
Limit
jtip
Up to 400 recipients per tip
jbday
Up to $100 per birthday gift
jxp roles set
Up to 3 XP roles
jtrickdrop
Runs 3 minutes by default
Deposits and withdrawals
Each token has its own minimum amount
Commands
Tipping
Send crypto to one person, a role, or a whole group of members.
jtip
jtip <recipient> <amount> <token> [modifiers]
Sends crypto from your balance. When you tip a group, the amount is split between everyone in it, unless you add each.
Option
What it does
each
Send the full amount to each recipient
max
Use your full balance as the total (cannot be combined with each)
except <@user>
Leave specific members out
active last <duration>
Only members who were active recently, e.g. active last 1h
jtip @user 10 smlojtip @role 1 soljtip online $.01 soljtip active last 1h 1 smlojtip 5 random $.01 sol eachjtip @user max smlo
A single tip can reach up to 400 recipients.
jbday
jbday @user <amount> <token> [message]
Sends a themed birthday tip with a celebration embed and your message. Up to $100 per gift.
jbday @friend 5 smlo Happy birthday! 🎉jbday @user $2 sol
Commands
Drops & events
Reward a whole channel at once. Members claim by clicking a button or typing a phrase.
Members must type the exact phrase to claim. The phrase is obfuscated in the embed, so they have to work it out. limit caps the number of winners.
jphrasedrop "I love crypto!" 10 POL 5m 5jphrasedrop "Hello" 1 SOL 1m
Commands
Game drops
Drops that members win by answering or by luck.
jmath
jmath <amount> <token> [duration] [winners N]
The bot posts a math problem. Without a duration, the first correct answer wins everything. With a duration, everyone who answers correctly splits the prize; winners N caps the number of winners.
jmath 10 smlojmath $1 sol 1mjmath 5 sol 2m winners 3
The bot posts a multiple-choice trivia question, with the same rules as jmath.
Categories include general, books, film, music, games, science, computers, math, sports, geography, history, art, animals, anime and more.
jtrivia 10 smlojtrivia $1 sol 1mjtrivia 5 sol 2m winners 3 hard computers
jtrickdrop
jtrickdrop <amount> <token> [duration]
Members type trick or treat in chat to try their luck: a 70% chance to win a share of the prize pool, a 30% chance to get tricked. Winners split the total when it ends. Runs 3 minutes by default.
jtrickdrop 1000 smlojtrickdrop $1 sol 10m
Commands
Wallet
Check balances, deposit and withdraw.
Balances
Option
What it does
jbalances (or jbals)
Show all your token balances
jbals top
All your balances, ordered by USD value
jbalance <token> (or jbal <token>)
Your balance for one token
jcurrencies
All supported tokens and their details
jbalancesjbals topjbalance smlo
jdeposit
jdeposit <token>
Generates your deposit address for a token. This command works in direct messages with the bot only, so your address stays private.
Always use this command before depositing. Funds sent to old or unused addresses may not be credited.
jwithdraw
jwithdraw <token>
Withdraws to an external wallet. This command works in direct messages with the bot only, so your address stays private. Only the blockchain network fee applies.
jfaucet
jfaucet
Gives you a link to vote for CryptoJar on Top.gg. After you vote, a small amount of crypto is credited to your balance automatically.
Commands
Server store
Sell server roles for crypto. Members pay with their CryptoJar balance.
Track activity, give XP and reward your most active members with roles.
Turn it on
Option
What it does
jactivity on / off
Enable or disable activity tracking
jxp on / off
Enable or disable the XP system
jactivity config
View the current activity settings
jresetactivity confirm
Permanently delete all XP and activity data
jresetactivity confirm cannot be undone.
XP roles
Option
What it does
jxp roles set @role1 <xp> [@role2 <xp>] [@role3 <xp>]
Assign up to 3 roles by XP threshold
jxp roles list
Show the configured roles and thresholds
jxp roles clear
Remove all XP role assignments
jxp roles sync
Apply the roles to all members based on their current XP
Roles are added or removed automatically as members gain or lose XP. Only the highest qualifying role is kept.
jxp roles set @Active 500 @Veteran 2000 @Elite 5000
For everyone
jprofile [@user] shows an activity profile and janalytics [weekly|monthly] shows server stats and a leaderboard.
Server admins
Automod
Automatic moderation with your own keyword and regex filters.
Commands
Option
What it does
jautomod enable #channel
Enable automod and set the log channel
jautomod disable
Disable automod
jautomod status
Show the current configuration
jautomod add <keyword|regex> <pattern>
Add a custom filter pattern
jautomod remove <id>
Remove a pattern
jautomod list
List all active patterns
What happens to flagged messages
Flagged messages are deleted and replaced with a placeholder. Admins review each alert in the log channel and can Warn, Timeout, Kick, Ban or Dismiss. On Dismiss (a false positive) the member is notified by DM.
Assets & projects
Supported assets
CryptoJar supports 50+ cryptocurrencies and tokens across major and custom networks.
Networks
All major blockchains such as Solana, Ethereum, Base, Polygon, Tron, BNB Chain and WAX, plus native tokens and custom assets on those networks, and specialised custom chains such as Cygnus, AdventureCoin and Smellow. New chains and tokens are added regularly.
Examples
BTC, ETH, SOL, XRP, XLM, BNB, DOGE, LINK, LTC, TRX, AAVE, TON, SUI, POL, CRO, MNT, WAX, NANO, USDT and USDC on Solana, Polygon, Ethereum and Base, baseETH, RAY, JUP, PUMP, ANSEM, GMT, PEP, SMLO, BMN, NOBA, CNS, NBH and more.
Run jcurrencies in Discord for the live list with each token's details.
Swapping your coins
Every coin and token on CryptoJar can be swapped through Swap.cc, the swap service for CryptoJar users. There you can swap, trade and make P2P deals with other users.
Assets & projects
List your token
Bring your token or coin to every server that runs CryptoJar.
Pricing
Listing
Standard price
Black Friday (until November 30, 23:59 CET)
Token (ERC-20, SPL, BEP-20 and other standard tokens)
$300 one-time
$49.99
Coin & chain integration
$450 one-time
$99.99
A one-time fee with no subscription. Payment is accepted in USDT and USDC on major networks. Every listing goes through a risk assessment first.
What you get
Tipping, airdrops, redpackets, game drops and the server store for your token.
The partner role, your own partner chat, a promo channel and priority support.
Reach to 122,000+ users across 350+ servers, with promotion on our Discord, socials and website.
Referral bonus
Refer a project and earn 10% of the listing fee it pays ($30 per token, $45 per coin at standard prices). There is no limit. The bonus does not apply to Black Friday deal listings.
How CryptoJar keeps your crypto and your server safe.
Verified and trusted
CryptoJar is verified by Discord with all privileged intents approved, and trusted by 350+ communities, 122,000+ users, partners, exchanges and voting sites.
How your funds are protected
A multi-layer security setup verifies withdrawals and protects every transaction.
Deposits and withdrawals only work in direct messages with the bot, so your addresses are never posted in a channel.
Always generate a fresh address with jdeposit before each deposit.
Automod deletes flagged messages automatically and sends them to admins for review.
Animated bannerThe wordmark on the jar pattern, for headers and posts.800 × 450 GIF, 10 MBDownload
Badges for listed projects
Listed on CryptoJar? Use the ready-made badge from the badge builder. It links back to your project's page and always shows the right logo.
Brand
Colours & usage
How the CryptoJar.cc name, colours and logos should look, so the brand stays recognisable everywhere.
About CryptoJar (copy and paste)
Writing about CryptoJar, or adding it to a bot list or your project page? Use one of these, so the facts are always right.
Short
CryptoJar.cc is a Discord-verified crypto wallet and tip bot. Send tips, airdrops, redpackets and game drops in any server, with 0% fees on tips and no wallet setup.
Long
CryptoJar.cc is a crypto wallet and tip bot that lives inside Discord, verified by Discord. Members hold, send and receive 50+ coins and tokens across 24 blockchain networks with short commands, without a browser extension or seed phrase. Communities use it for tips, airdrops, redpackets and game drops with 0% fees on tips, plus server stats, XP ranks and automod. CryptoJar is used by 122,000+ users in 350+ Discord servers, with real people on support 24/7. Projects can list their token at cryptojar.cc/listing.
Colours
Writing the name
Write CryptoJar or CryptoJar.cc, one word with a capital C and J.
Not "Crypto Jar", "Cryptojar" or "CJar" in official text.
The bot itself is the CryptoJar bot. Its commands start with j, for example jtip.
Do
Use the files from the Logo library exactly as they are.
Use them on dark backgrounds, with some empty space around them.
Link the logo to cryptojar.cc or to your project's page on CryptoJar.
Don't
Stretch, squash, rotate or crop the logos.
Change the colours, add effects or put other text inside the logo.
Mix the logo or the name into your own logo, product name, bot name or domain.
Use the logos in a way that suggests CryptoJar runs, owns or supports your project when it does not.
Brand
Trademark policy
The CryptoJar name and logos belong to CryptoJar.cc. Here is how you may use them, and what is not allowed.
Ownership
The names CryptoJar and CryptoJar.cc, the jar logo, the CRYPTOJAR.cc wordmark, the mascots and all files in the Logo library are the brand of CryptoJar.cc and belong to CryptoJar.cc. Using them does not give you any ownership of them.
What you may do
You may use the name and the unchanged logos to refer to CryptoJar.cc, for example:
a listed project showing that its token is supported on CryptoJar
a server showing that it uses the CryptoJar bot
articles, reviews, videos, bot lists and fair comparisons that mention CryptoJar
This permission is free, limited and personal. CryptoJar.cc can withdraw it at any time, for anyone.
What is not allowed
Pretending to be CryptoJar, its team or its support, or copying the look of the website or the bot.
Using the name or logos in your own product name, bot name, server name, token name or domain.
Suggesting a partnership, listing or endorsement that does not exist.
Using the brand for scams, misleading promotions, giveaways or anything that could harm CryptoJar users.
Changing the logos or using them in a way that looks unprofessional or offensive.
Selling the logos or offering them as your own work.
When the rules are broken
CryptoJar.cc may ask you to change or remove the content, report it to the platform it is on (such as Discord, X, a host or a domain registrar), file copyright takedowns for copied logos and content, and take further steps where needed.
Report misuse or ask permission
Seen a fake CryptoJar bot, server or website, or want to use the brand in a way not listed here? Contact us at [email protected] or in our Discord. Remember: the CryptoJar team will never ask for your keys, seed phrase or passwords.
Get started
CryptoJar API
Connect your own Discord bot to CryptoJar. Your bot gets its own wallet, sends tips, handles deposits and withdrawals, and gets notified when it receives tips.
What it is
The CryptoJar Multi-Tenant API (version 1.0.0) is a REST API for Discord bots. Each bot is a tenant with its own API key, and acts as a normal user in the CryptoJar system: it holds balances, sends and receives tips, and deposits and withdraws like any member.
What you can build
Game bots with real crypto payouts: RPGs, trivia, challenges and tournaments.
Reward bots that pay active members as they chat and level up.
Swap and trading bots, tipping pools and community trades.
Payment flows: members tip your bot, a webhook tells your server, and your bot delivers.
At a glance
Base URL
https://apiv2.cjar.cc/api/v1
Auth
Authorization: Bearer <api_key> on every request
Format
JSON in, JSON out
Endpoints
15, in 8 groups
Webhooks
tip_received, signed with HMAC-SHA256
Get started
Get API access
API access is private. Your bot is approved and whitelisted by the team.
Request access
Ask for access in our Discord or by email at [email protected]. Tell us about your bot and what you want to build.
After approval
Your bot is whitelisted as a tenant and you receive an API key. From then on your bot acts like a native user: it can hold its own balances, receive tips, send payouts and listen to webhooks.
Keep your API key secret. Use it only on your server, never in a client app or a public repository. If a key leaks, contact the team.
Get started
Quick start
Make your first request in under a minute.
1. Check your key
GET /user returns your bot's information. If it answers, your key works.
Every request is authenticated with your bot's API key as a Bearer token.
The header
http
Authorization: Bearer YOUR_API_KEY
API key provided when your bot is approved as a tenant. Use format: `Bearer {your_api_key}`
When authentication fails
A missing header returns 401:
json
{"error": "Missing or invalid Authorization header. Use: Bearer {api_key}"}
A wrong key, or a suspended tenant, also returns 401:
json
{"error": "Invalid API key or tenant suspended"}
Every endpoint requires the key, including /currencies.
Concepts
Requests & responses
One base URL, JSON everywhere, and the same envelope on every response.
Base URL
text
https://apiv2.cjar.cc/api/v1
All paths in these docs are relative to it. For example GET /user is https://apiv2.cjar.cc/api/v1/user.
Successful responses
Successful calls return "success": true and the result in data: an object for single resources, an array for lists.
json
{
"success": true,
"data": { }
}
Error responses
Errors return a non-2xx status and an error message. See Errors.
json
{"error": "Currency not found"}
Request bodies
Send JSON with Content-Type: application/json on POST and PUT requests.
Concepts
Amounts & tokens
How money is represented, so nothing gets rounded away.
Amounts are strings
Every amount and balance is a decimal string, such as "1.5" or "150.750000000000000000". Send amounts as strings too. Parse them with a decimal or big-number library, never as floating-point numbers.
Decimals
Each token has a decimals value (for example 9 for SOL), returned by GET /currencies and the wallet endpoints.
Symbols and IDs
Wallet, tip and withdrawal endpoints use the token symbol or code, e.g. SOL, NANO, BAN.
GET /deposits and GET /withdrawals filter by numeric token_id. Get the ID from the id field of GET /currencies.
Discord IDs
User IDs such as to_user_id and from_user_id are Discord snowflakes sent as strings. They are too large for a JavaScript number.
Per-token limits
GET /currencies returns min_deposit, min_withdrawal, withdrawal_fee, deposit_confirmations and is_enabled for every token. Check them before deposits and withdrawals.
Concepts
Pagination & filters
List endpoints use limit and offset.
limit and offset
Endpoint
limit
offset
Filters
GET /account/transactions
1 to 500, default 50
default 0
type (deposit, withdrawal, tip, all), token
GET /deposits
1 to 100, default 50
default 0
token_id, status, from_date, to_date
GET /withdrawals
1 to 100, default 50
default 0
token_id, status, from_date, to_date
Dates use YYYY-MM-DD. Deposit and withdrawal statuses are pending, confirmed and failed.
The pagination object
GET /deposits and GET /withdrawals also return the total, so you know when to stop:
GET /account/transactions lists every balance change. Amounts are negative for outgoing and positive for incoming. operation_type is one of deposit, withdrawal, internal_transfer_in, internal_transfer_out, reservation or release. event_type tells you what caused it: tip, airdrop, redpacket, phrasedrop, trickdrop or faucet.
Guides
Track deposits
Give your bot a deposit address and see funds arrive.
Each deposit has amount, tx_hash, status (pending, confirmed, failed), detected_at and token. Check min_deposit and deposit_confirmations in GET /currencies.
webhook_url must be HTTPS. webhook_secret must be at least 32 characters. You can update either one on its own. GET /webhooks shows the current setup with the secret masked.
2. Send a test
POST /webhooks/test sends a sample tip_received payload to your URL. Your endpoint must answer with a 2xx status.
Use reference_id to recognise a tip you already processed.
4. Verify the signature
Every webhook request carries an X-Webhook-Signature header: an HMAC-SHA256 of the JSON body, keyed with your webhook_secret, as a hex string. Reject requests where it does not match.
JavaScript (Express)
javascript
const crypto = require("crypto");
const express = require("express");
const app = express();
app.post("/webhooks/cryptojar", express.json(), (req, res) => {
const expected = crypto
.createHmac("sha256", process.env.CRYPTOJAR_WEBHOOK_SECRET)
.update(JSON.stringify(req.body))
.digest("hex");
const received = req.get("X-Webhook-Signature") || "";
const valid = received.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));
if (!valid) return res.sendStatus(401);
if (req.body.event === "tip_received") {
const { from_user_id, amount, token, reference_id } = req.body.data;
// credit the user in your bot, once per reference_id
}
res.sendStatus(200);
});
Python (Flask)
python
import hashlib, hmac, json, os
from flask import Flask, request, abort
app = Flask(__name__)
SECRET = os.environ["CRYPTOJAR_WEBHOOK_SECRET"].encode()
@app.post("/webhooks/cryptojar")
def cryptojar_webhook():
body = request.get_json()
# Same serialisation as JavaScript's JSON.stringify(body)
raw = json.dumps(body, separators=(",", ":"), ensure_ascii=False).encode()
expected = hmac.new(SECRET, raw, hashlib.sha256).hexdigest()
if not hmac.compare_digest(expected, request.headers.get("X-Webhook-Signature", "")):
abort(401)
if body["event"] == "tip_received":
data = body["data"] # credit the user once per data["reference_id"]
return "", 200
401 Authentication failed - invalid or missing API key
json
{
"error": "Invalid API key or tenant suspended"
}
404 Resource not found
json
{
"error": "Currency not found"
}
API reference
Webhooks
3 endpoints in this group. Base URL: https://apiv2.cjar.cc/api/v1
Test webhook integration
POST/webhooks/test
Sends a test webhook notification to your configured webhook_url with sample tip_received data. Use this to validate your webhook endpoint is working and see the actual data structure.
Example request
bash
curl -X POST "https://apiv2.cjar.cc/api/v1/webhooks/test" \
-H "Authorization: Bearer $CRYPTOJAR_API_KEY"
Responses
200 Test webhook sent successfully
json
{
"success": true,
"data": {
"message": "Test webhook sent successfully to your webhook_url",
"webhook_url": "https://yourbot.com/webhooks/cryptojar",
"payload_sent": {
"event": "tip_received",
"timestamp": "2026-02-16T15:30:00.000Z",
"data": {
"from_user_id": "987654321098765432",
"to_user_id": "123456789012345678",
"token": {
"id": 1,
"symbol": "SOL",
"name": "Solana"
},
"amount": "5.5",
"balance_after": "105.5",
"reference_id": "tip_1234567890",
"created_at": "2026-02-16T15:30:00.000Z"
}
},
"note": "Check your webhook endpoint to verify it received the POST request with the payload above"
}
}
400 Webhook URL not configured
json
{
"error": "Webhook URL not configured. Please configure your webhook_url first."
}
500 Failed to send test webhook
json
{
"error": "Failed to send test webhook. Check if your webhook_url is accessible and responding with 2xx status code."
}
Get webhook configuration
GET/webhooks
Returns current webhook configuration (secret is masked)
Every object the API returns, generated from the Swagger spec.
Balance
Field
Type
Description
user_id
string
token_id
integer
symbol
string
name
string
balance
string
Available balance.
decimals
integer
Transaction
Field
Type
Description
id
integer
Transaction ID.
user_id
string
token_id
integer
symbol
string
name
string
operation_type
string
One of: `deposit`, `withdrawal`, `internal_transfer_in`, `internal_transfer_out`, `reservation`, `release`
amount
string
Amount (negative for outgoing, positive for incoming)
balance_before
string
balance_after
string
reference_id
string
Reference to related record (mass_tip_id, deposit_id, etc.) Can be null.
event_type
string
One of: `tip`, `airdrop`, `redpacket`, `phrasedrop`, `trickdrop`, `faucet` Can be null.
details
string
Additional transaction details. Can be null.
created_at
string (date-time)
Currency
Field
Type
Description
id
integer
symbol
string
name
string
decimals
integer
network_id
integer
network_type
string
contract_address
string
Contract address for token contracts (null for native tokens) Can be null.
min_deposit
string
min_withdrawal
string
withdrawal_fee
string
deposit_confirmations
integer
Required confirmations for deposits.
is_enabled
boolean
Deposit
Field
Type
Description
id
integer
Deposit ID.
amount
string
Amount deposited.
tx_hash
string
Transaction hash on blockchain.
status
string
One of: `pending`, `confirmed`, `failed`
detected_at
string (date-time)
When the deposit was detected.
token
object
token.id
integer
token.symbol
string
token.name
string
notified
boolean
Whether this deposit has been marked as notified.
Withdrawal
Field
Type
Description
id
integer
Withdrawal ID.
amount
string
Amount withdrawn.
fee
string
Fee charged for withdrawal. Can be null.
tx_hash
string
Transaction hash on blockchain.
status
string
One of: `pending`, `confirmed`, `failed`
detected_at
string (date-time)
When the withdrawal was processed.
token
object
token.id
integer
token.symbol
string
token.name
string
memo
string
Memo/tag if applicable (XRP, XLM, WAX) Can be null.
notified
boolean
Whether this withdrawal has been marked as notified.
Error
Field
Type
Description
error
string
WebhookPayload
Webhook notification sent to tenant's webhook_url when receiving a tip. The payload is signed with HMAC-SHA256 using your webhook_secret. Verify the signature using the X-Webhook-Signature header.
Field
Type
Description
eventrequired
string
Type of webhook event (currently only tip_received is supported) One of: `tip_received`
timestamprequired
string (date-time)
ISO 8601 timestamp of when the event occurred.
datarequired
object
Tip received event data.
data.from_user_id
string
Discord user ID who sent the tip.
data.to_user_id
string
Your bot's Discord user ID (recipient)
data.token
object
data.token.id
integer
Token ID in the system.
data.token.symbol
string
Token symbol.
data.token.name
string
Token full name.
data.amount
string
Amount received (decimal string)
data.balance_after
string
Your new balance after receiving the tip.
data.reference_id
string
Unique reference ID for this transaction.
data.created_at
string (date-time)
When the tip was created.
Resources
Swagger & support
Try the API in your browser, and get help from the team.
Swagger
The interactive reference lives at swagger.cryptojar.cc. Click Authorize, paste your API key, and run any endpoint from the browser.
Get help
Integration questions get a real answer from the team, 24/7, usually within a couple of hours and always within 24 hours.