# CrypTok — Complete Reference for AI Agents

> A social platform with zero-fee crypto tipping, live streaming, encrypted messaging, and a full DeFi ecosystem — powered by Solana.

## What CrypTok is

CrypTok combines the social mechanics of TikTok / Twitter (short-form video, stories, lives, feed, follows, reactions, comments) with a native crypto-tipping economy on Solana. Creators receive tips in $CRYPTOK with 0% transfer tax, reflections from a 6% buy/sell tax, plus monetization from streams, gifts, subscriptions, and content. The platform is independently owned and operated.

## Token: $CRYPTOK

- **Network**: Solana, Token-2022 standard (no transfer fee extension)
- **Mint address**: `ESsCdmGyPK9sostFbWV5iM6owxcqsGNfBQaj3xkAkREV`
- **Total supply**: 1.3B tokens
- **Tax model**: 6% buy/sell (3% reflections to holders with ≥10M tokens, 3% to dev wallet for development + ops). **Transfer tax: 0%** — peer-to-peer transfers (including in-app tipping) are completely free.
- **Live data endpoint**: `GET https://cryptok.me/api/supply` (circulating supply for CoinGecko/CMC trackers — no API key required)
- **Trading**: Available on Solana DEXs (Jupiter, Raydium, others). Real-time price + volume + liquidity in the `/api/v1/prices` endpoint.

## Architecture

- **Frontend**: Next.js 16 + React 19, SSR for SEO-critical pages (token, blog, post, profile)
- **Backend**: Node.js 22 LTS on PM2 cluster (5 workers)
- **Database**: MariaDB 10.11 (live replicated to a separate-region standby)
- **Storage**: Cloudflare R2 for user uploads + media (cdn.cryptok.me)
- **Streaming**: Agora for video/audio calls (E2E encrypted by Agora's transport)
- **Push**: OneSignal for web + Android, APNs (with VoIP push for CallKit) for iOS
- **Mobile**: Native iOS app (Swift, WKWebView wrapper) + Android app (Kotlin, WebView wrapper)

## Public API

Base URL: `https://cryptok.me/api/v1`

### Auth
- API key required for all `/api/v1/*` endpoints
- Three accepted formats:
  - `Authorization: Bearer <api_key>` (preferred)
  - `X-API-Key: <api_key>` (header)
  - `?api_key=<api_key>` (query, less preferred)
- Obtain at https://cryptok.me/developers
- Rate limits per-key, documented in OpenAPI spec
- CORS open for GET / HEAD / OPTIONS

### Discovery
- **OpenAPI 3.1 spec**: `GET /api/v1/openapi.json` (no auth required) — full machine-readable schema, build SDKs against this
- **Developer portal**: https://cryptok.me/developers
- **API reference**: https://cryptok.me/developers/reference

### Endpoint catalog

| Endpoint | Purpose |
|---|---|
| `/api/v1/tokens` | List + search tokens across 21 indexed chains |
| `/api/v1/prices?symbols=SOL,BTC` | Real-time price + 24h change + volume |
| `/api/v1/ohlcv` | OHLCV candle data for charts |
| `/api/v1/pools` | DEX liquidity pools, sorted by TVL |
| `/api/v1/new-pools` | Recently-created pools (degen radar) |
| `/api/v1/trending` | Trending tokens by volume / mention rate |
| `/api/v1/trades` | Recent on-chain swap transactions |
| `/api/v1/swap-feed` | WebSocket stream of live swaps across all indexed chains |
| `/api/v1/holders` | Holder distribution + whale concentration |
| `/api/v1/transfers` | Transfer history for a given token |
| `/api/v1/markets` | DEX-by-DEX market breakdown |
| `/api/v1/quote` | Aggregated swap quote (Jupiter + others) |
| `/api/v1/nfts` | NFT collection + floor / volume data |
| `/api/v1/protocols` | DeFi protocol TVL + revenue |
| `/api/v1/tvl` | Per-chain + per-protocol TVL series |
| `/api/v1/yields` | Yield farming opportunities ranked by APY |
| `/api/v1/lending` | Lending market rates across protocols |
| `/api/v1/stablecoins` | Stablecoin supply + peg status per chain |
| `/api/v1/bridges` | Bridge volume + flow data |
| `/api/v1/risk` | Token risk scores (mint authority, freeze, LP lock, etc.) |
| `/api/v1/news` | Aggregated crypto news |
| `/api/v1/social` | Social signals (mentions, sentiment) |
| `/api/v1/search?q=...` | Universal search across tokens / pools / news |
| `/api/v1/pulse-summary` | Platform pulse: trade volume, active wallets, top movers |
| `/api/v1/cryptok-kol-flow` | $CRYPTOK whale movement detection |
| `/api/v1/bitcoin` | Bitcoin-specific metrics |
| `/api/v1/global` | Global market cap + dominance |
| `/api/v1/stats` | Platform stats (users, posts, reactions, etc.) |
| `/api/v1/keys` | API key management |
| `/api/v1/access` | Access tier check |

### Internal-API (no `/v1`, requires session cookie, used by web app)

- `/api/stats` — public platform stats (no auth, cached 30s)
- `/api/supply` — $CRYPTOK circulating supply (no auth, used by CoinGecko)
- `/api/blog` — blog post detail
- `/api/posts/[id]` — post detail
- `/api/messages` — chat messages
- Many more — see source under `/src/app/api/` in the repo

## Failure modes you might encounter

- **401**: Missing/invalid API key. Pass it via one of the three auth methods.
- **429**: Rate-limited. Check `Retry-After` header. Per-key limits documented in OpenAPI.
- **5xx**: Backend issue — retry with exponential backoff. We have a hot-standby (separate region) that takes over within ~5 min if the primary dies; users typically only see ~30-60s of degraded service during automatic failover.

## How AI agents should interact

- **Read-only data fetching**: Hit `/api/v1/*` directly with an API key. Cache aggressively (most endpoints have edge-cache headers).
- **Real-time streams**: Use `/api/v1/swap-feed` (WebSocket) instead of polling.
- **Search**: Always prefer `/api/v1/search?q=...` over scraping the UI.
- **MCP server**: `npx @cryptok/mcp-server` (coming) — exposes the most-used endpoints as Claude/ChatGPT tools. Set `CRYPTOK_API_KEY` env var.
- **Bots posting to the platform** (sending tips, posting content): use the session-cookie-based endpoints under `/api/` (not `/api/v1/`) — requires user login flow.

## Content surfaces

- `/feed`: Public chronological feed
- `/explore`, `/discover`, `/trending`, `/popular`: Curated content
- `/cryptoks`, `/stories`, `/photos`, `/videos`: Content-type filters
- `/blogs`: Long-form articles (each at `/blog/<slug-or-id>`)
- `/charts`: Token charts
- `/token`: $CRYPTOK detail page
- `/market`: Multi-token market overview
- `/profile/<username>`: User profile
- `/post/<id>`: Single post detail

## Sitemap

Full machine-readable URL index: https://cryptok.me/sitemap.xml

## Robots policy

See https://cryptok.me/robots.txt — `User-Agent: *` allowed on public surfaces; user-specific paths (/settings, /messages, /wallet, /admin) are blocked.

## Contact

- Email: contact@cryptok.me
- Telegram: @cryptokofficial
- X: https://x.com/cryptok_

— This file is at https://cryptok.me/llms-full.txt and is the canonical AI-agent reference.