Reference

DOCS

Full usage for Kintara Tools: live pages, calculators, Telegram alerts, data policy, and setup.

Start Here

HOW TO USE THE SITE

Use public pages without connecting a wallet. Data pages read public Kintara endpoints and cache safely.

Public pages do not need wallet login. OTC seller/buyer actions require a connected Solana wallet.

Use Telegram alerts from the top bar, then open the bot and send /start.

GET ALERTS

The bot works in private chats or groups. It sends market alerts, price watches, server/events status, OTC status, and daily digest.

Open @Kintara_Tools_Bot

Pages

SITE MAP

/dashboard

Live overview for token, servers, marketplace, properties, chat, merchant, and expansion.

/market

Market watch with live listings, paginated asks, and daily-average candle charts.

/index-items

Item index derived from current marketplace listings. Search and filter by category.

/tools

Scanners, planners, calculators, local alerts, rare floors, and value helpers.

/alerts

Telegram bot landing page, command list, thresholds, and bot link.

/events

Merchant campaign, expansion tribute, property signs, and spectator chat pulse.

/otc

Redis-backed account OTC listings, wallet-gated buyer/seller flow, and escrow status.

/updates

Deploy SHA and token feed freshness.

Tools

TOOLS USAGE

30D value scanner

Find public listings whose unit ask is below the 30d average returned by Kintara stats.

Rare floor tracker

Show current floors for rare/public marketplace items.

Local price alerts

Browser-local floor targets. Refresh the site to check current floors.

Account value estimator

Estimate account value from gold, item counts, levels, and public $KINS floors.

Drop log

Track personal attempts/drops in local storage and infer observed rate.

Live flip scanner

Read current asks and find floor-to-second-ask spread after tax. Read-only.

Merchant cap tracker

Estimate cap tiers from $KINS holdings and current merchant stock inputs.

Wilderness risk estimator

Estimate expected loss from carried loot, death chance, trips, and protection.

Bank page planner

Plan stack pressure, bank trips, and route time.

XP planner

Estimate XP/actions from manual inputs. Mechanics are not verified by public endpoint.

Drop odds simulator

Calculate hit chance, dry risk, and expected attempts from manual drop odds.

Bot Commands

TELEGRAM FULL COMMANDS

Command	Usage
/start	Subscribe this chat and show the command list.
/subscribe	Turn market alerts on for this chat.
/unsubscribe	Turn market alerts off.
/status	Show token API, marketplace API, $KINS price, market cap, holders, asks, and subscribers.
/market coal	Search live item floors. Replace coal with any item query.
/watch coal 0.0001	Alert when the unit floor for coal is at or below 0.0001 $KINS.
/watch axe 1 gold	Alert when the unit floor for axe is at or below 1 gold.
/watches	List active watches for the current chat.
/unwatch id	Remove one watch by ID prefix.
/unwatch all	Remove every watch in this chat.
/deals	Show current public listings below their 30d average.
/rare	Show rare item floors from live listings.
/events	Show merchant, expansion, property, and spectator chat status.
/servers	Show public server queues, population, membership, and level gates.
/otc	Show Redis-backed OTC account listings.
/trade id	Show OTC trade status by full ID or ID prefix.
/digest	Show daily digest immediately.
/plus wallet	In Plus mode, link one Solana wallet to the current Telegram chat after a live $TOOLS balance check.
/wallet	Show linked Plus wallet and current $TOOLS balance.
/alerts	Show configured alert thresholds.
/help	Show commands again.

Telegram Plus

PLUS ALERT MODE

1. Enable mode

Set MARKET_ALERT_PLUS_MODE=true on the Telegram bot worker.

2. Set token mint

Set TOOLS_MINT_ADDRESS to the $TOOLS SPL token mint you want to gate with.

3. Set RPC

Set SOLANA_RPC_ENDPOINT to a reliable Solana RPC. The bot uses it for live token-account reads.

4. User links wallet

User sends /plus PUBKEY in Telegram. The bot checks that wallet has at least 250,000 $TOOLS by default.

5. Wallet uniqueness

A wallet can only be linked to one Telegram chat. Reusing the same wallet in another chat is rejected.

6. Delivery checks

Broadcasts, price-watch hits, and daily digest recheck the linked wallet. If balance falls below the minimum, the chat is removed from subscribers.

Plus Env

TOKEN-GATED SETUP

Plus mode does not ask for private keys or signatures. It stores one public wallet per Telegram chat and checks the token balance on-chain.

MARKET_ALERT_PLUS_MODE=true
TOOLS_MINT_ADDRESS=your-tools-token-mint
TOOLS_PLUS_MIN_BALANCE=250000
TOOLS_PLUS_BALANCE_CACHE_MS=60000
SOLANA_RPC_ENDPOINT=https://mainnet.helius-rpc.com/?api-key=...

Set TOOLS_PLUS_BALANCE_CACHE_MS=0 if every outgoing alert should hit RPC without cache. Keep Redis enabled so wallet links and uniqueness persist across restarts.

Data

LIVE DATA POLICY

Token

$KINS price, market cap, holders, mint.

Servers

Server names, queue lengths, population labels, membership and level gates.

Marketplace listings

Current public asks, quantity, seller, currency, reserved state, USD estimate.

Marketplace stats

Daily average unit prices and sales samples. No true OHLC from API.

World reads

Merchant campaign, expansion tribute, property signs, spectator chat bootstrap.

OTC

Local Redis-backed listing/trade state, sealed account secrets, wallet-gated buyer/seller actions.

Plus gate

Telegram bot checks linked Solana wallets on-chain for $TOOLS token balance before delivering alerts.

If an upstream API fails, pages show stale Redis cache or empty states. The app should not invent market, player, or world rows.

Setup

ENVIRONMENT

KINTARA_REDIS_URL

Optional Redis cache and OTC persistence. Example: redis://localhost:6379

TELEGRAM_BOT_TOKEN

BotFather token for the Telegram alert bot.

MARKET_ALERT_INTERVAL_MS

Bot poll interval. Default 60000, minimum 15000.

MARKET_ALERT_DAILY_DIGEST_HOUR_UTC

Daily digest hour in UTC. Default 14.

MARKET_ALERT_PLUS_MODE

When true, Telegram alerts only go to chats with a linked wallet holding enough $TOOLS.

TOOLS_MINT_ADDRESS

Mint address for the $TOOLS token checked by Plus mode.

TOOLS_PLUS_MIN_BALANCE

Minimum $TOOLS balance for Plus alerts. Default 250000.

TOOLS_PLUS_BALANCE_CACHE_MS

Balance cache window for Plus mode. Default 60000; set 0 for every alert send to hit RPC.

OTC_SEAL_SECRET

Server-only secret used to seal OTC account secrets.

OTC_ADMIN_ESCROW_WALLET

Primary escrow admin/operator wallet shown on older OTC trades.

OTC_ADMIN_ESCROW_WALLETS

Comma-separated escrow admin/operator wallets. Defaults to Gh97...iwzxV and DiHA...inor.

SOLANA_RPC_ENDPOINT

Server-side Solana RPC for OTC/payment helpers and Plus $TOOLS balance checks.

NEXT_PUBLIC_SOLANA_RPC

Optional browser-visible RPC for connected-wallet balance reads.

NEXT_PUBLIC_PRIVY_APP_ID

Privy app id. Required for OTC wallet login; optional for public read-only pages.

Wallet

WALLET CONNECT

Wallet connect is optional. Public dashboard, market, index, tools, events, docs, and alerts do not require it.

OTC requires wallet connect for list, buy, payment check, dispute, and seller withdraw. Payout wallet is forced to the seller login wallet.

OTC still uses per-trade escrow deposit wallets so one old balance cannot fake another trade payment. Admin escrow wallets default to Gh97...iwzxV and DiHA...inor.

Safety

NO PRIVATE KEYS

Never paste a private key into public calculators, Telegram, or wallet connect.

OTC account secrets are sealed server-side when using the OTC flow, and seller withdraw unlocks after 72h once funded.

Gameplay automation and account boosting should stay off private keys unless a dedicated, audited flow exists.