Free TikTok LIVE API
Connect to any TikTok LIVE stream over WebSocket. Receive every gift event - including Crystal Ball - within 50 ms. Sandbox tier free, no credit card.
Read the docs →What Crystal Ball costs and what the creator gets
| Gifts sent | Coins | Buyer cost (approx.) | Diamonds to creator | Creator payout (approx.) |
|---|---|---|---|---|
| 1 x Crystal Ball | 1,700 | $17.00 | 1,700 | $8.50 |
| 10 x Crystal Ball | 17,000 | $170.00 | 17,000 | $85.00 |
| 100 x Crystal Ball | 170,000 | $1,700.00 | 170,000 | $850.00 |
Buyer cost uses a reference rate of 100 coins per $1. TikTok sells coins in packs, and the price per coin depends on the pack size, the store and your region; web checkout and in-app purchases (which include app store fees) usually cost more than this rate. Creator payout uses $0.005 per diamond, before any agency share. Convert any amount with the diamonds calculator.
Gift gallery API
PRO+Embed Crystal Ball + the full gift gallery via API
One request returns the full TikTok LIVE gift catalog - every name, diamond cost, and icon URL. Drop it straight into your own app.
// npm install @tiktool/live
import { TikTokLive } from '@tiktool/live';
const live = new TikTokLive({ apiKey: 'YOUR_TIKTOOLS_KEY' });
// Fetch the full gift gallery / catalog (Pro+ = full live catalog).
const res = await fetch('https://api.tik.tools/webcast/gift_info', {
headers: { 'x-api-key': 'YOUR_TIKTOOLS_KEY' },
});
const { data } = await res.json();
// data.gifts[] = every gift: name, diamond_count, icon URL, id.
for (const g of data.gifts) {
console.log(g.name, g.diamond_count, g.icon);
}View API docs Full live catalog needs Pro+ - see plans
See top gifters
Browse the global gifter leaderboard - real users sending Crystal Ball and every other gift across 44 regions, updated continuously.
Gifters leaderboard →Production-ready SDK
One npm install -> live events in your terminal. Node.js + Python officially supported. Used by 1000+ developers.
Quick start →Gifts at a similar price
Crystal Ball gift FAQ
How much is the Crystal Ball gift on TikTok?
Crystal Ball costs 1,700 coins. At the reference rate of 100 coins per $1 that is about $17.00. The real checkout price depends on the coin pack, store and region, and in-app purchases usually cost more because of app store fees.
How much does a creator earn from one Crystal Ball?
The creator is credited 1,700 diamonds. At the payout rate of $0.005 per diamond that is about $8.50, before any agency share.
How many coins are 10 Crystal Ball gifts?
10 Crystal Ball gifts cost 17,000 coins (about $170.00) and credit the creator 17,000 diamonds (about $85.00).
Which TikTok gifts cost about the same as Crystal Ball?
Gifts at a similar price include Center Stage (1,799 coins), Here We Go (1,799 coins) and Lovely Ride (1,600 coins).
Want every gift event in real time?
Drop the free SDK in your app and stream gift, chat, like, follow, and battle events from any TikTok LIVE room.