🚧 Membership tiers coming soon! Features currently in development.
🍶

🍶 Sake Tier

Hold $SAKE to unlock curated filters & "left of trend" insights

🎯 Hyped Projects Filter 📈 Trend Predictions 🔍 Advanced Screeners
Get $SAKE
Token-Based Access
💎

💎 Diamond Tier

Advanced technical analysis tools for tracked token pairs

📊 TA Indicators 🔄 Multi-Timeframe Analysis ⚡ Real-time Signals
$47/month
⚛️

⚛️ Quantum Tier

Full API access & custom integrations

🔗 API Endpoints 🛠️ Custom Tools 👥 Direct Support
Enterprise Pricing

API Documentation

Complete reference for Sake's REST API endpoints. All endpoints return JSON responses and support CORS.

Documentation Purpose: The endpoints below are shown for demonstration and integration planning purposes. To access these APIs, please .
🔒 API Access Notice: These endpoints are currently restricted for internal use only.
Base URL: https://sake.gg/api
Access:
Response Format: All responses are in JSON format

Market Data

GET /api/top-tokens Get top 10 tokens per narrative (excluding stablecoins)

Description: Returns the top 10 cryptocurrency tokens by market cap from each narrative category (excluding stablecoins), ensuring all tokens have complete data including icons, market cap, and sentiment data.

Example Response:
{ "success": true, "tokens": [ { "id": 1, "symbol": "BTC", "name": "Bitcoin", "categories": ["Store of Value"], "market_cap": 1250000000000, "price": 65000.50, "percent_change_24h": 2.5, "volume_24h": 25000000000, "market_dominance": 50.2, "icons64_path": "btc.png" } ], "total_count": 100 }
GET /api/market-sentiment Get market sentiment index

Description: Returns the current market sentiment calculated from top altcoins using social volume, volatility, and price performance.

Example Response:
{ "success": true, "sentiment": { "score": 71, "emoji": "⚔️", "label": "Seppuku Index: Battle Ready", "color": "success" } }
GET /api/market-dominance Get market dominance data

Description: Returns market dominance percentages for BTC, ETH+SOL (weighted), and stablecoins with change indicators.

Example Response:
{ "success": true, "data": { "btc": { "symbol": "BTC", "dominance": 64.07, "dominance_prev": 61.36, "change": 2.71, "change_pct": 4.43, "trend": "up" }, "eth_sol": { "symbol": "ETH+SOL", "dominance": 11.79, "change_pct": 4.43, "trend": "up" } } }

Narratives

GET /api/narratives Get all narratives

Description: Returns all available crypto narratives with metadata and token counts.

Example Response:
{ "success": true, "narratives": [ { "id": 1, "category_name": "defi", "full_name": "Decentralized Finance", "description": "Protocols enabling decentralized financial services", "token_count": 245, "created_at": "2024-01-01T00:00:00", "updated_at": "2024-12-01T12:00:00" } ] }
GET /api/narrative/{category_name} Get specific narrative details

Description: Returns detailed information about a specific narrative category.

Parameters:
  • category_name (path) - The narrative category identifier (e.g., "defi", "gaming", "ai")
Example Response:
{ "success": true, "narrative": { "id": 1, "category_name": "defi", "full_name": "Decentralized Finance", "meta_description": "Protocols enabling decentralized financial services", "token_count": 245, "created_at": "2024-01-01T00:00:00", "updated_at": "2024-12-01T12:00:00" } }
GET /api/narrative/{category_name}/chart Get narrative chart data

Description: Returns weighted price chart data for a narrative over specified timeframe.

Parameters:
  • category_name (path) - The narrative category identifier
  • timeframe (query) - Chart timeframe: "24h", "7d", "30d" (default: "7d")
Example Response:
{ "success": true, "data": [ { "recorded_at": "2024-12-01T12:00:00", "price": 1.25, "token_count": 8 } ], "metadata": { "timeframe": "7d", "total_tokens": 10, "synchronized_points": 168 } }

Chart Data

GET /api/token/{symbol}/chart/{timeframe} Get token chart data

Description: Returns historical price chart data for a specific token.

Parameters:
  • symbol (path) - Token symbol (e.g., "BTC", "ETH")
  • timeframe (path) - Currently supports "24h" only
Example Response:
{ "data": [ { "timestamp": "2024-12-01T12:00:00", "price": 65000.50, "volume_24h": 1500000000, "social_volume_24h": 2500 } ], "data_status": "available", "current_data_points": 96, "expected_data_points": 96 }

Search

GET /api/search Global search for narratives and tokens

Description: Search across narratives and tokens by name or symbol.

Parameters:
  • q (query) - Search query (minimum 2 characters)
Example Response:
{ "success": true, "narratives": [ { "type": "narrative", "category_name": "defi", "full_name": "Decentralized Finance", "token_count": 245, "url": "/narrative/defi" } ], "tokens": [ { "type": "token", "symbol": "UNI", "name": "Uniswap", "categories": ["defi", "dex"], "price": 8.50, "market_cap": 5100000000, "percent_change_24h": 3.2, "url": "/token/UNI" } ], "query": "uni" }

Trending

GET /api/trending-narratives-dashboard Get trending narratives by performance

Description: Returns top performing narratives based on 24h weighted average performance.

Parameters:
  • limit (query) - Number of narratives to return (default: 5, max: 20)
Example Response:
{ "success": true, "narratives": [ { "category_name": "ai", "full_name": "Artificial Intelligence", "font_awesome": "fas fa-robot", "token_count": 89, "performance_24h": 15.2, "total_market_cap": 25000000000 } ] }
GET /api/top-social-volume Get top tokens by social volume

Description: Returns the top 5 tokens with highest social volume in the last 24 hours.

Example Response:
{ "success": true, "tokens": [ { "symbol": "BTC", "name": "Bitcoin", "icon": "btc.png", "social_volume_24h": 15000, "price": 65000.50, "percent_change_24h": 2.5, "market_cap": 1250000000000 } ] }

Error Responses

All endpoints may return the following error response format:

{ "success": false, "error": "Error description", "message": "Detailed error message (optional)" }
Note: Chart data endpoints may return status 503 (Service Unavailable) during system maintenance with appropriate error messages.