Tideshift
Documentation
Complete guide to Tideshift's demand-driven token migration platform. Covers every page, methodology, data source, and feature.
Getting Started
What is Tideshift and how to navigate the platform
What is Tideshift
Tideshift is full-lifecycle token migration infrastructure for Solana. It scores 50+ tokens by real migration demand — measuring bridge outflows, search intent, social signals, and wallet overlap — to produce a single Migration Demand Score (MDS) from 0 to 100. Built for the Sunrise Migrations track at the Solana Graveyard Hackathon.
Who is it for
Identify the strongest migration candidates using data-driven scoring. Prioritize outreach with ranked demand signals instead of gut feeling.
Understand your token's migration readiness at a glance. Use guided onboarding flows to bring your community onto Solana smoothly.
Track post-migration health metrics, explore the competitive landscape, and surface emerging demand before it becomes obvious.
Quick Tour
Navigation
Dashboard
The main command center for migration demand discovery
Stats Bar
Four KPI cards across the top of the dashboard provide an at-a-glance summary of the migration landscape.
Total tokens scored by the MDS engine across all tracked chains.
Mean Migration Demand Score across all candidates. A rising average signals growing ecosystem-wide demand.
Total cross-chain bridge outflow volume in the last 7 days, aggregated from WormholeScan data.
The token with the highest current MDS score — the strongest migration candidate right now.
Token Rankings Table
The primary ranking view lists every scored token with sortable columns, search, and chain filters.
| Column | Description |
|---|---|
| Rank | Position by MDS score (highest first) |
| Token | Name, symbol, and origin chain badge |
| MDS | Migration Demand Score (0–100) with color-coded badge |
| Bridge Vol | 7-day cross-chain bridge outflow volume in USD |
| Market Cap | Current market capitalization on origin chain |
| Search | Search intent score with visual progress bar |
| 7d Change | 7-day price change percentage with trend arrow |
Demand Charts
Three tabbed chart views visualize the top demand signals across the candidate pool.
Bar chart showing the top 5 tokens by 7-day bridge volume. Highlights where capital is actively leaving other chains.
Bar chart showing the top 5 tokens by search intent score. Derived from DEX volume, pair count, and listing gaps on Jupiter.
Stacked area chart showing weighted signal contributions for the top 5 tokens. See how Bridge, Search, Social, Chain Health, and Wallet Overlap contribute to each token’s MDS.
Onboarding Analytics
A community onboarding conversion funnel backed by Upstash Redis. Shows unique visitor counts at each step of the guided migration flow:
Real data
Migrated Tokens Banner
A horizontal scroll at the bottom of the dashboard highlights tokens that have already successfully migrated to Solana via Sunrise:
Click any migrated token to jump to the Migration Health page and review its post-migration performance.
Source of truth
Token Detail
Deep-dive into any token's migration demand signals
MDS Score Ring
A large circular progress ring dominates the top of the detail page, displaying the token's overall Migration Demand Score from 0 to 100. The ring color shifts dynamically based on score range: 0–29 red 30–59 yellow 60–79 green 80–100 cyan. This is the single most important indicator of migration demand.
Score Breakdown
Two complementary visualizations show how the MDS is composed:
5-axis spider chart showing each signal's normalized score (0–100). Quickly reveals a token's demand profile shape — whether it's bridge-heavy, socially driven, or balanced.
Shows raw score, weight, and weighted contribution for each signal side by side. Makes it clear exactly how many points each signal adds to the final MDS.
Signal Cards
Five expandable cards, each tracking a different demand signal that feeds into the MDS calculation:
7-day cross-chain bridge volume leaving the token’s origin chain, displayed as a total USD figure.
Data sourced from WormholeScan when available. Tokens without direct bridge data show estimated values derived from market volume with a 50% confidence discount.
Composite score from 24h DEX volume, pair count, liquidity depth, Solana pair count, and boost/trending score from DexScreener.
Tokens that are NOT listed on Jupiter receive a +15 “unmet demand” bonus, reflecting genuine demand without an existing Solana venue.
Community score built from Twitter followers, Reddit subscribers, and Reddit active users. Includes a sentiment percentage.
All social data is sourced from CoinGecko’s community data endpoints. Sentiment reflects the ratio of positive to total social mentions.
Market cap, 24h volume, TVL (DefiLlama), and holder count. Measures the token’s strength on its current chain.
Holder counts use the Helius DAS API for real on-chain data when a Solana mint exists. Otherwise, an estimated count is shown with an “(est.)” label.
Estimated percentage of token holders who also have active Solana wallets.
Uses a heuristic model based on chain proximity, category affinity, and DefiLlama TVL ratios. Always marked as “Estimated” since true cross-chain wallet mapping requires private data.
Additional Sections
30-day price history rendered as an area chart. Data sourced from CoinGecko’s market chart endpoint with daily granularity.
A checklist evaluating NTT (Native Token Transfer) compatibility, team accessibility and responsiveness, and existing bridge availability for the token.
Related tokens in the same category that are already live on Solana. Helps contextualize demand by showing comparable migrations that succeeded.
AI-powered proposal generation with 3 tones (Executive, Technical, Community). Streams narrative analysis from GPT-4o-mini using live token data.
Ask Tideshift
A conversational AI assistant available on every token detail page. Click the floating gradient button (bottom-right) to open the chat panel. Token data is pre-loaded from the page, so responses arrive in 2–7 seconds. The AI can also call tools to fetch additional data (e.g., comparing with a different token).
“Why should Sunrise migrate this token?”
Fetches token data and provides a migration case analysis
“What are the biggest risks?”
Analyzes risk signals: declining bridge trend, low overlap, sentiment
“Compare this to RENDER”
Fetches both tokens and gives signal-by-signal comparison
“Explain the bridge outflow data”
Deep-dives into the bridge signal with raw values and context
Scoped to migration topics
Generate a Proposal
Discovery
Scan the top 500 tokens to find migration candidates
Methodology
Discovery scans the top 500 tokens by market cap and isolates those without a Solana presence — surfacing the best migration candidates for the Sunrise team.
CoinGecko /coins/markets — 2 calls, 250 per page
CoinGecko /coins/list?include_platform=true
Filter out tokens that already have a Solana contract address
Remove stablecoins (USDT, USDC, DAI, etc.) and tokens under $5M market cap
Cross-reference with Jupiter verified token list — name similarity matching prevents false positives
~300 tokens with Solana status (Bridged / Not on Solana), liquidity data, cached 60 min
Table Features
25, 50, 100, 200, or all tokens per page
Filter by token name, symbol, or origin chain
Rank, market cap, 24h volume, 7d change, demand votes, MDS score
Download the full filtered dataset (includes CoinGecko URLs)
Click any row to view on CoinGecko
Cross-references Jupiter verified tokens to show Solana presence, with links to Orb Markets and Jupiter
Filter by All, Bridged (wrapped on Solana), or Not on Solana
Demand Votes
Community-driven demand signalling lets visitors express which tokens they want on Solana.
On-Demand MDS Scoring
Score any token directly from the discovery table without leaving the page.
Quick AI Summary
Get a one-click AI assessment of any token's migration potential directly from the discovery table.
Migration Scout Agent
An autonomous AI agent that analyzes the top migration candidates and produces a structured Migration Brief for the Sunrise BD team.
Scout vs. Quick Summary
Migration Health
Post-migration monitoring for tokens already on Solana
Overview
Migration Health tracks the ongoing performance of tokens that have already migrated to Solana via Sunrise. It answers the question: is the migration succeeding? Currently monitors RENDER, HNT (Helium), POWR (Powerledger), and GEOD (GEODNET).
Health Score Formula
healthScore = volumeScore x 0.30
+ stabilityScore x 0.30
+ bridgeScore x 0.20
+ momentumScore x 0.20Trading volume relative to market cap. Healthy tokens show active, consistent trading activity.
30-day price direction. Positive price movement scores higher, indicating post-migration growth and adoption.
Ongoing bridge activity volume, log-scaled. Shows continued interest in cross-chain movement.
7-day price momentum. Positive momentum signals growth and ecosystem adoption.
Status Thresholds
| Score | Status | Meaning |
|---|---|---|
| 70 - 100 | Healthy | Strong post-migration performance |
| 40 - 69 | Moderate | Acceptable but needs monitoring |
| 0 - 39 | Concerning | Potential issues, may need intervention |
Metrics Displayed
Each migration health card surfaces the following data points:
Data Freshness
Proposals
Auto-generated migration proposals with actionable analysis
How Proposals Work
Proposals turn raw signal data into structured, actionable migration documents. Powered by GPT-4o-mini with real-time token data.
AI Analysis Tones
The same token data produces distinctly different analysis depending on the audience.
Concise, strategic, ROI-focused. Leads with the verdict, backs it with evidence.
"Bridge outflows of $28.8M signal steady cross-chain demand — Solana users are actively leaving other chains to access this asset."
Precise, protocol-aware. References bridge mechanics, pool math, and integration complexity.
"NTT via Wormhole is recommended given Ethereum-origin with existing Guardian support. Initial pool deployment: 40% Jupiter CLMM, 30% Raydium concentrated."
Approachable, holder-friendly. Explains in plain language what migration means for you.
"Your tokens will be available on Solana with near-instant swaps on Jupiter. Bridge takes under a minute, and you can start earning yield on day one."
Classic fallback
Bridge Recommendation
The proposal engine automatically selects the best bridge based on the token's origin chain.
When: Origin chain supports Wormhole
Sunrise's preferred framework for native token migrations
When: Wormhole not supported
Alternative cross-chain protocols with broad chain coverage
Alternative Bridges
Liquidity Estimates
Proposals calculate initial liquidity requirements based on trading activity.
Target Pool Allocation
| Venue | Pair | Allocation |
|---|---|---|
| Jupiter | TOKEN/USDC | 40% |
| Raydium | TOKEN/SOL | 30% |
| Orca | TOKEN/USDC | 20% |
| Kamino | TOKEN Lending | 10% |
Risk Assessment
Each proposal evaluates 5 risk factors and assigns an overall risk level.
| Factor | Severity | Trigger |
|---|---|---|
| Supply Concentration | High | Total-to-circulating supply ratio > 3 |
| Low Wallet Overlap | Medium | Less than 15% Solana wallet overlap |
| Declining Bridge Activity | Medium | Bridge outflow trend is falling |
| Negative Sentiment | Medium | Community sentiment score below 0 |
| Low TVL vs Market Cap | Low | TVL under $10M with market cap over $100M |
Proposal Actions
Share the full proposal as formatted text
Remove a saved proposal from localStorage
Jump back to the token's signal analysis page
Open an external link to submit for review
Onboarding Flows
Guided community migration for token holders
5-Step Stepper
Each onboarding flow walks token holders through the full migration journey in five guided steps.
Token introduction and overview of why migrating to Solana unlocks better speed, lower fees, and deeper DeFi opportunities.
Guided setup for Phantom, Backpack, or Solflare wallet. Includes links to download, install, and configure each option.
Transfer tokens from the origin chain to Solana via Wormhole Portal or deBridge. Step-by-step bridging instructions with fee estimates.
Swap tokens on Jupiter, Raydium, or Orca. Shows available trading pairs, liquidity depth, and current prices.
Explore lending, LP positions, and staking opportunities with live APYs pulled from DefiLlama Yields API.
Supported Tokens
Onboarding flows are pre-configured for the following migrated tokens.
| Token | Origin Chain | Migration Date | Bridge Options |
|---|---|---|---|
| RENDER | Ethereum | Nov 2023 | Wormhole Portal deBridge |
| HNT | Helium | Apr 2023 | Helium Wallet App |
| POWR | Ethereum | Feb 2025 | Wormhole NTT deBridge |
| GEOD | Polygon | Sep 2024 | Wormhole NTT |
Live DeFi APYs
The DeFi step (Step 5) shows real-time yield data pulled from the DefiLlama Yields API. APYs update in real time and include risk level indicators.
Analytics Tracking
Every step completion is tracked to measure conversion and identify drop-off points in the migration funnel.
MDS Methodology
How the Migration Demand Score is calculated
Signal Categories
The MDS is composed of five weighted signals, each capturing a different dimension of migration demand.
| Signal | Weight | Source | What It Measures |
|---|---|---|---|
| Bridge Outflow | 30% | WormholeScan | Cross-chain bridge volume for this token |
| Search Intent | 25% | DexScreener + Jupiter | DEX trading activity and Solana listing status |
| Social Demand | 20% | CoinGecko | Community size, engagement, and sentiment |
| Chain Health | 15% | CoinGecko + DefiLlama | Origin chain fundamentals (mcap, volume, TVL) |
| Wallet Overlap | 10% | Heuristic + DefiLlama | Estimated Solana wallet presence among holders |
Normalization Details
Each signal is normalized to a 0–100 scale using sub-metric breakdowns specific to the data source.
avgDaily from 7d/30d volumes, normalized to 0–100 (max ~$500K/day)
35% DEX volume ($1M+ = max) + 25% txn count (10K+ = max) + 15% liquidity ($5M+ = max) + unmet demand bonus (+15 if NOT on Jupiter) + boost bonus (+10 if trending)
60% community score + 25% sentiment + 15% reddit engagement. Community score = 40% Twitter followers + 20% Reddit subs + 20% Reddit active + 20% sentiment votes
30% mcap ($5B+ = max) + 25% volume ($500M+ = max) + 25% TVL ($5B+ = max) + 20% holders (500K+ = max)
Chain proximity model (Arbitrum 18%, Optimism 16%, Ethereum 15%, Base 14%) × category affinity × DefiLlama TVL ratios
Score Calculation
The final MDS is a weighted sum with dynamic rescaling when signals are missing.
available_weight = sum(weight_i for signals with data) scale = 1 / available_weight MDS = sum(normalized_i × weight_i) × scale (clamped 0-100) confidence = available_signals / 5 (0.0 to 1.0)
Score Ranges
Partial Data Handling
When a signal is unavailable (API down, rate limited, or no data for that token), its weight is redistributed proportionally to the available signals. The confidence score drops accordingly. For example, a token with 3 out of 5 signals available gets a confidence score of 0.6. This ensures every token receives a score even with incomplete data, while clearly indicating data completeness.
Bridge Estimation Discount
When WormholeScan lacks data for a specific token, bridge volume is estimated from the token's market cap and volume ratio. This estimated data receives a 50% confidence discount — the effective weight drops from 30% to 15%. This prevents speculative estimates from dominating the score while still incorporating partial bridge intelligence.
Demand, not popularity
Data Sources
All APIs, caching, and health monitoring
Tier 1: Free, No Auth Required
| Provider | Base URL | Data Provided | Rate Limit |
|---|---|---|---|
| WormholeScan | api.wormholescan.io | Bridge volumes, scorecards | 1000/min |
| DefiLlama | api.llama.fi | TVL, protocols, bridge volumes, DeFi APYs | ~100/min |
| DexScreener | api.dexscreener.com | DEX pairs, volume, liquidity, boosts | 300/min |
Tier 2: Free with API Key
| Provider | Data Provided | Rate Limit |
|---|---|---|
| CoinGecko | Market data, community/social data, platform lookups | 10–30/min |
| Jupiter | Verified token list, bridged token detection, liquidity data | Key required |
| Helius | Real SPL token holder counts (DAS API) | 10 rps |
| OpenAI | GPT-4o-mini: streaming proposals (3 tones) + Ask Tideshift chat | Pay-per-use |
Tier 3: Persistent Storage
| Service | Purpose | Free Tier |
|---|---|---|
| Upstash Redis | Community demand votes, onboarding analytics | 10K commands/day |
Caching Strategy
All API responses are cached in-memory with TTLs tuned to each data type's volatility.
| Data Type | TTL | Reason |
|---|---|---|
| Market data | 2 min | Prices change frequently |
| Bridge data | 5 min | Volume updates regularly |
| Search/DEX data | 10 min | Moderately stable |
| Social data | 15 min | Changes slowly |
| Wallet overlap | 30 min | Heuristic, infrequent |
| Holder counts | 30 min | On-chain, changes slowly |
| Protocol list | 1 hour | Rarely changes |
| Token discovery | 1 hour | Top-500 list is stable |
| API response | 3 min | Full dashboard cache |
Health Monitoring
Every API call uses trackedFetch() which records latency, success/failure, and consecutive failure count per provider. Status is derived from consecutive failures:
The API Health Board in the sidebar shows real-time status of all providers.
Error Handling
A 4-step pipeline ensures graceful degradation when any provider is unreachable.
Check in-memory cache → return if valid
Call live API with 10s timeout + 1 retry on 5xx
On success → cache result → return
On failure → return null → scoring engine uses available signals only
Resilient by design
Glossary
Key terms and definitions
ATH
All-Time High — the highest price a token has ever reached.
Bridge Outflow
Cross-chain value moving between blockchains, indicating demand for a token on other chains.
CCIP
Chainlink Cross-Chain Interoperability Protocol — a bridge framework for secure cross-chain messaging.
Community Score
Weighted composite of Twitter followers, Reddit subscribers, Reddit activity, and sentiment votes.
Confidence Score
Ratio of available data signals to total signals (0.0 to 1.0), indicates data completeness.
DAS API
Digital Asset Standard API — Helius’s interface for querying on-chain Solana token data.
Health Score
Composite metric (0–100) tracking post-migration token performance.
LayerZero OFT
Omnichain Fungible Token — LayerZero’s standard for cross-chain token transfers.
MDS
Migration Demand Score — Tideshift’s proprietary 0–100 score measuring real migration demand.
NTT
Native Token Transfers — Wormhole’s framework for canonical cross-chain token representation (Sunrise’s preferred).
Origin Chain
The blockchain where a token was originally deployed before migration.
Search Intent
Normalized score measuring DEX trading activity, pair availability, and boost/trending status.
Signal
One of 5 data categories (bridge, search, social, chain health, wallet overlap) feeding the MDS.
TVL
Total Value Locked — aggregate value deposited in DeFi protocols.
Wallet Overlap
Estimated percentage of a token’s holders who also maintain active Solana wallets.
Weight Redistribution
When a signal is unavailable, its scoring weight is redistributed proportionally to available signals.