Token Metrics API

Moonshots API: Discover Breakout Tokens Before the Crowd

Use the Moonshots API to surface breakout tokens with TM Grade and Bullish tags. Copy-paste JS/Python, watch the demo, and build screeners, bots, and alerting workflows in minutes.
Sam Monac
5 min
MIN

The biggest gains in crypto rarely come from the majors. They come from Moonshots—fast-moving tokens with breakout potential. The Moonshots API surfaces these candidates programmatically so you can rank, alert, and act inside your product. In this guide, you’ll call /v2/moonshots, display a high-signal list with TM Grade and Bullish tags, and wire it into bots, dashboards, or screeners in minutes. Start by grabbing your key at Get API Key, then Run Hello-TM and Clone a Template to ship fast.

‍

What You’ll Build in 2 Minutes

  • A minimal script that fetches Moonshots via /v2/moonshots (optionally filter by grade/signal/limit).

  • A UI pattern to render symbol, TM Grade, signal, reason/tags, and timestamp—plus a link to token details.

  • Optional one-liner curl to smoke-test your key.

  • Endpoints to add next: /v2/tm-grade (one-score ranking), /v2/trading-signals / /v2/hourly-trading-signals (timing), /v2/resistance-support (stops/targets), /v2/quantmetrics (risk sizing), /v2/price-prediction (scenario ranges).

Why This Matters

Discovery that converts. Users want more than price tickers—they want a curated, explainable list of high-potential tokens. The moonshots API encapsulates multiple signals into a short list designed for exploration, alerts, and watchlists you can monetize.

Built for builders. The endpoint returns a consistent schema with grade, signal, and context so you can immediately sort, badge, and trigger workflows. With predictable latency and clear filters, you can scale to dashboards, mobile apps, and headless bots without reinventing the discovery pipeline.

Where to Find 

The Moonshots API cURL request is right there in the top right of the API Reference. Grab it and start tapping into the potential!

‍

👉 Keep momentum: Get API Key • Run Hello-TM • Clone a Template

Live Demo & Templates

  • Moonshots Screener (Dashboard): A discover tab that ranks tokens by TM Grade and shows the latest Bullish tags and reasons.

  • Alert Bot (Discord/Telegram): DM when a new token enters the Moonshots list or when the signal flips; include S/R levels for SL/TP.

  • Watchlist Widget (Product): One-click “Follow” on Moonshots; show Quantmetrics for risk and a Price Prediction range for scenario planning.

Fork a screener or alerting template, plug your key, and deploy. Validate your environment with Hello-TM. When you scale users or need higher limits, compare API plans.

How It Works (Under the Hood)

The Moonshots endpoint aggregates a set of evidence—often combining TM Grade, signal state, and momentum/volume context—into a shortlist of breakout candidates. Each row includes a symbol, grade, signal, and timestamp, plus optional reason tags for transparency.

For UX, a common pattern is: headline list → token detail where you render TM Grade (quality), Trading Signals (timing), Support/Resistance (risk placement), Quantmetrics (risk-adjusted performance), and Price Prediction scenarios. This lets users understand why a token was flagged and how to act with risk controls.

Polling vs webhooks. Dashboards typically poll with short-TTL caching. Alerting flows use scheduled jobs or webhooks (where available) to smooth traffic and avoid duplicates. Always make notifications idempotent.

Production Checklist

  • Rate limits: Respect plan caps; batch and throttle in clients/workers.

  • Retries & backoff: Exponential backoff with jitter on 429/5xx; capture request IDs.

  • Idempotency: De-dup alerts and downstream actions (e.g., don’t re-DM on retries).

  • Caching: Memory/Redis/KV with short TTLs; pre-warm during peak hours.

  • Batching: Fetch in pages (e.g., limit + offset if supported); parallelize within limits.

  • Sorting & tags: Sort primarily by tm_grade or composite; surface reason tags to build trust.

  • Observability: Track p95/p99, error rates, and alert delivery success; log variant versions.

  • Security: Store keys in a secrets manager; rotate regularly.

Use Cases & Patterns

  • Bot Builder (Headless):


    • Universe filter: trade only tokens appearing in Moonshots with tm_grade ≥ X.

    • Timing: confirm entry with /v2/trading-signals; place stops/targets with /v2/resistance-support; size via Quantmetrics.

  • Dashboard Builder (Product):


    • Moonshots tab with Badges (Bullish, Grade 80+, Momentum).

    • Token detail page integrating TM Grade, Signals, S/R, and Predictions for a complete decision loop.

  • Screener Maker (Lightweight Tools):


    • Top-N list with Follow/alert toggles; export CSV.

    • “New this week” and “Graduated” sections for churn/entry dynamics.

  • Community/Content:


    • Weekly digest: new entrants, upgrades, and notable exits—link back to your product pages.

Next Steps

  • Get API Key — generate a key and start free.

  • Run Hello-TM — verify your first successful call.

  • Clone a Template — deploy a screener or alerts bot today.

  • Watch the demo: VIDEO_URL_HERE

  • Compare plans: Scale confidently with API plans.

FAQs

1) What does the Moonshots API return?
A list of breakout candidates with fields such as symbol, tm_grade, signal (often Bullish/Bearish), optional reason tags, and updated_at. Use it to drive discover tabs, alerts, and watchlists.

2) How fresh is the list? What about latency/SLOs?
The endpoint targets predictable latency and timely updates for dashboards and alerts. Use short-TTL caching and queued jobs/webhooks to avoid bursty polling.

3) How do I use Moonshots in a trading workflow?
Common stack: Moonshots for discovery, Trading Signals for timing, Support/Resistance for SL/TP, Quantmetrics for sizing, and Price Prediction for scenario context. Always backtest and paper-trade first.

4) I saw results like “+241%” and a “7.5% average return.” Are these guaranteed?
No. Any historical results are illustrative and not guarantees of future performance. Markets are risky; use risk management and testing.

5) Can I filter the Moonshots list?
Yes—pass parameters like min_grade, signal, and limit (as supported) to tailor to your audience and keep pages fast.

6) Do you provide SDKs or examples?
REST works with JavaScript and Python snippets above. Docs include quickstarts, Postman collections, and templates—start with Run Hello-TM.

7) Pricing, limits, and enterprise SLAs?
Begin free and scale up. See API plans for rate limits and enterprise options.

‍

Build Smarter Crypto Apps &
AI Agents in Minutes, Not Months
Real-time prices, trading signals, and on-chain insights all from one powerful API.
Grab a Free API Key
Token Metrics Team
Token Metrics Team

Recent Posts

Research

Regime Switching in Crypto: Participate in Upside, Sit Out Drawdowns (2025)

Sam Monac
7 min
MIN

Timing crypto cycles is hard. Volatility cuts both ways: you want broad upside when markets run, and you want the discipline to step aside when trend and liquidity flip. That’s exactly what a regime switching crypto index does—using rules to allocate into the market during bullish conditions and to stablecoins during bearish conditions. TM Global 100 is our flagship implementation: a rules-based, top-100 crypto index when bullish that moves fully to stablecoins when not, with weekly rebalancing and transparent holdings/transactions you can verify at a glance. It’s built for people who want market exposure without micromanaging tokens—or their emotions.

→ Join the waitlist to be first to trade TM Global 100.

TL;DR (snippet)

What it is: A rules-based index that holds the top-100 crypto assets in bull markets and moves to stablecoins in bear markets.
Why it matters: Weekly rebalances + transparent holdings and a transactions log encourage discipline and clarity.
Who it’s for: Hands-off allocators and active traders who want a robust, rules-driven core.
Next step: Join the waitlist to be first to trade TM Global 100.

Why Education / Indices Matters in October 2025

Crypto runs in regimes—multi-month stretches of risk-on momentum followed by drawdowns that can erase gains quickly. Searchers looking for “regime switching,” “weekly rebalancing,” or “crypto index” want a practical framework that’s simple to follow and easy to execute.

Definition (for snippets): Regime switching in crypto is a rules-based method that changes portfolio exposure based on market conditions, typically rotating between a diversified token basket in uptrends and stablecoins in downtrends.

Why now:

  • Cycle asymmetry: Capturing trend while limiting drawdown time can meaningfully affect long-term outcomes.

  • Operational burden: DIY rebalancing across dozens of tokens is error-prone; a standardized process reduces slippage, delays, and missed changes.

  • Clarity: Real-time transparency over what you hold, why you hold it, and when it changed.

How the TM Global 100 Index Works (Plain English)

  • Regime switching:


    • Bullish: Hold the top-100 by market cap across sectors and chains.

    • Bearish: Exit to stablecoins and wait for a bullish re-entry signal.

  • Weekly rebalancing:


    • Reflects updated market-cap rankings and liquidity/supply thresholds. Constituents and weights update on schedule.

  • Transparency:


    • Strategy modal with rules; Gauge → Treemap → Transactions Log so you can verify what you own and what changed.

  • What you’ll see on launch:


    • Price tile, 100 tokens, “rebalances weekly,” one-click Buy Index flow with an embedded, self-custodial wallet.

Soft CTA: See the strategy and rules.

Benefits at a Glance (Why This Beats DIY)

  • Rules, not vibes: Mechanized regime logic aims to reduce emotional whipsaws.

  • Fewer ops mistakes: One flow vs. dozens of manual trades across chains/exchanges every rebalance.

  • Switching discipline: Full rotation to stablecoins on bearish signals—no second-guessing.

  • Slippage & fees surfaced: Estimated gas, platform fee, and minimum expected value shown before you confirm.

  • See everything: Holdings treemap/table and transactions log keep you informed.

  • Weekly cadence: A predictable update rhythm that keeps the index aligned with the market.

Step-by-Step: How to Get Early Access (Waitlist)

  1. Open the hub: Visit the Token Metrics Indices hub.

  2. Find TM Global 100: Open the index card and tap Join Waitlist.

  3. Add email: Enter the address you want us to notify at launch.

  4. (Optional) Connect wallet: Pre-connect to streamline the 90-second Buy flow on day one.

  5. Launch day: You’ll receive an email when trading opens; the index page shows Gauge → Strategy → Holdings so you can review in seconds.

  6. Buy in ~90 seconds: Confirm wallet, review fees/slippage, and Buy Index. Track your position in My Indices.

→ Join the waitlist to be first to trade TM Global 100.

Decision Guide: Is This Right for You?

  • Hands-Off Allocator: Want broad market beta when it’s worth it, and stables when it isn’t.

  • Active Trader: Keep this as a rules-based core, take satellite bets around it.

  • TM Member/Prospect: Prefer research-backed rules and transparent logs over discretionary churn.

  • New to Crypto: Want a single button, clear rules, and weekly updates.

  • Time-Strapped Pro: Minimize ops overhead; maximize clarity.

  • Skeptical of “forecasts”: Prefer process over prediction—signals + scheduled rebalances.

FAQs

What is a regime switching crypto index?
A rules-based portfolio that allocates to a diversified token basket in bullish regimes and rotates to stablecoins in bearish regimes, based on pre-defined signals. TM Global 100 implements this with a top-100 universe and a full stablecoin switch in bears.

How often does the index rebalance?
Weekly, to reflect updated rankings and liquidity thresholds; regime changes can occur outside the weekly cycle when the signal flips.

What triggers the move to stablecoins?
A proprietary market signal. When bearish, the index exits token positions into stablecoins and waits for a bullish re-entry signal.

Can I fund with USDC or fiat?
You purchase through an embedded, self-custodial wallet supporting major chains; funding and settlement options surface based on your wallet and chain. USDC payouts are supported when selling. (Region/asset availability may vary.)

Is the wallet custodial?
No. The embedded wallet is self-custodial—you control funds.

How are fees shown?
Before confirming, you’ll see estimated gas, platform fee, max slippage, and minimum expected value.

How do I join the waitlist?
Visit the Token Metrics Indices hub, open TM Global 100, and tap Join Waitlist. You’ll be notified at launch.

Security, Risk & Transparency

  • Self-custody first: Embedded smart wallet; you control keys and funds.

  • Clarity before commit: Fees, slippage, and holdings previewed pre-trade.

  • Logs on-page: Strategy, holdings, and transactions history are visible.

  • Regime logic limits: Signals can be wrong; sudden gaps and spreads can impact outcomes.

  • Geography: Availability and supported rails may differ by region.

Crypto is volatile and can lose value. Past performance is not indicative of future results. This article is for research/education, not financial advice.

Conclusion + Related Reads

If you want a disciplined, transparent way to gain broad crypto exposure while sitting out drawdowns, TM Global 100 was built for you. It’s rules-based, weekly-rebalanced, and visible down to the transaction log—so you can focus on allocation, not anxiety.

→ Join the waitlist to be first to trade TM Global 100.

Related Reads

‍

Research

What Is a Crypto Index? Why Weekly Rebalancing Matters (2025)

Sam Monac
7 min
MIN

If you’ve ever tried to “own the market” in crypto, you know the pain: picking coins, timing rotations, chasing listings, and rebalancing blends research with stress. A crypto index solves this by tracking a defined basket with clear rules—so you don’t babysit a watchlist 24/7. TM Global 100 extends that idea with a rules-based approach: it holds the top 100 assets when the market is bullish, and fully moves to stablecoins when it isn’t, with weekly rebalancing and transparent holdings and transactions. That means less micromanagement, more discipline, and a single place to see what you own and why.

→ Join the waitlist to be first to trade TM Global 100.

TL;DR (snippet)

  • What it is: A rules-based index that holds the top-100 in bull markets and moves to stablecoins in bear markets.

  • Why it matters: Weekly rebalances + transparent holdings and transaction logs keep exposure aligned with market structure.

  • Who it’s for: Hands-off allocators and active traders who want a disciplined, visible core.

  • Next step: Join the waitlist to be first to trade TM Global 100.

Why crypto indices matter in October 2025

Search interest around “what is a crypto index” keeps rising because investors want broad exposure without constant token-picking. Indices meet informational → commercial → transactional intent in one flow: learn the concept, see the rules, then invest. For traders, weekly rebalancing reduces drift from fast-changing market-cap rankings; for allocators, a regime switch (tokens ↔ stablecoins) can help avoid sitting exposed through deep drawdowns. In one sentence: A crypto index is a rules-based basket of crypto assets that rebalances on a schedule to maintain a defined exposure.

How the TM Global 100 Index Works (Plain English)

  • Regime switching:
    Bull: hold the top 100 by market cap.
    Bear: exit to stablecoins and wait for a bullish re-entry signal.

  • Weekly rebalancing:
    Updates weights and constituents to reflect the current top-100 ranking.

  • Transparency:
    Strategy modal (rules), Gauge → Treemap → Transactions Log, and an index price tile with “rebalances weekly” note.

  • What you’ll see on launch:
    Price tile, token count (100), one-click Buy Index, and post-buy visibility in My Indices.

Soft CTA: See the strategy and rules.

Benefits at a Glance (Why This Beats DIY)

  • Time saved: No weekly scramble across exchanges to add/remove names after rankings shift.

  • Lower drift risk: Scheduled weekly rebalances help keep the basket aligned with the evolving top-100.

  • Switching discipline: Automated bear-market stablecoin posture enforces a plan when emotions run hot.

  • Fewer missed moves: Rotations into/out of constituents are handled by rules, not vibes.

  • Single dashboard: Gauge → Treemap → Transactions Log show what changed and when.

  • One-click execution: Fund, confirm, done—no manual multi-token shopping cart.

Step-by-Step: How to Get Early Access (Waitlist)

  1. Go to the Token Metrics Indices hub.

  2. Open TM Global 100 and tap Join Waitlist; add your email.

  3. (Optional) Connect wallet so you’re set for the 90-second Buy flow at launch.

  4. We’ll notify you on go-live—you’ll see the price tile, signal Gauge, and Buy Index.

  5. Preview fees/slippage, confirm, and your position appears in My Indices with full transactions history.

  6. Revisit weekly to see updated holdings and rebalances; we log everything.

  7. Repeat the waitlist CTA to share with a friend who wants “one-click top-100.”

→ Join the waitlist to be first to trade TM Global 100.

Decision Guide: Is This Right for You?

  • Hands-Off Allocator: Want market exposure without coin-picking? Consider Global 100.

  • Active Trader: Want a rules-based core that moves to stables in bears while you run side bets?

  • TM Member/Prospect: Prefer transparent holdings & logs you can actually audit.

  • Rebalance-Skeptic: You know drift is real; weekly cadence may help keep you aligned.

  • Risk-Aware: Like the idea of stablecoin mode when signals flip—no promises, just rules.

  • Time-Poor, Thesis-Rich: You believe in crypto’s upside but can’t manage 100 positions manually.

FAQs

What is a crypto index?
A crypto index is a rules-based basket that tracks a defined set of assets (e.g., the top-100 by market cap), with a scheduled rebalance to keep exposure aligned. Global 100 applies that idea and adds a regime switch to stablecoins.

How often does TM Global 100 rebalance?
Weekly. Constituents and weights update on schedule; if the market regime changes, the portfolio can switch between tokens and stablecoins outside that cadence.

What triggers the move to stablecoins?
A proprietary market signal. Bullish: hold the top-100 basket. Bearish: exit to stablecoins and wait for a re-entry signal.

Can I fund with USDC or fiat?
At launch you’ll see wallet-funding options supported by the embedded smart wallet and supported chains; USDC payouts are available on selling. Details show in the Buy/Sell flow.

Is the wallet custodial?
No. The embedded wallet is self-custodial—you control funds.

How are fees shown?
Before confirming you’ll see estimated gas, platform fee, max slippage, and minimum expected value.

How do I join the waitlist?
Visit the Token Metrics Indices hub, open TM Global 100, and tap Join Waitlist. We’ll email when trading opens.

Security, Risk & Transparency

  • Self-custody: Embedded smart wallet; you control keys.

  • Clear rules: Strategy modal explains selection criteria and rebalancing methodology.

  • Full visibility: Holdings Treemap, Table, and Transactions Log show every change after rebalances/regime switches.

  • Fee clarity: Buy flow shows fees and slippage before you confirm.

  • Regime logic limits: Signals can be wrong; no performance is promised.

  • Regional notes: Availability may vary by region and wallet support at launch.

Crypto is volatile and can lose value. Past performance is not indicative of future results. This article is for research/education, not financial advice.

Conclusion + Related Reads

If you want broad market exposure without herding coins—or a disciplined core you can trust to step aside in bad regimes—TM Global 100 was built for you: rules-based, weekly rebalancing, stablecoins when warranted, and full transparency. Join the waitlist now to be first to trade on launch.

Related Reads:

‍

Research

Predictable Crypto: The Index That Moves to Stablecoins When It Should (2025)

Sam Monac
7 min
MIN

If you’ve ever wished for a crypto index that participates broadly in bull markets yet steps aside when risk turns south, this is it. TM Global 100 is a rules-based index that holds the top 100 crypto assets when our market signal is bullish—and moves fully to stablecoins when it isn’t. It rebalances weekly, shows transparent holdings and transaction logs, and can be purchased in one click with an embedded wallet. That’s disciplined exposure, minus the micromanagement.

→ Join the waitlist to be first to trade TM Global 100.

TL;DR (snippet)

  • What it is: A rules-based index that holds the top 100 in bull markets and stablecoins in bear markets.

  • Why it matters: Weekly rebalances + full transparency (strategy, holdings, transactions).

  • Who it’s for: Hands-off allocators and active traders who want a disciplined core.

  • Next step: Join the waitlist to be first to trade TM Global 100.

Why Education / Indices Matters in October 2025

Two things define this cycle: speed and uncertainty. Narratives rotate in weeks, not months, and individual-coin risk can swamp portfolios. Indices let you own the market when conditions warrant, while a regime-switching approach aims to sidestep drawdowns by cutting risk to stablecoins. (A crypto index is a rules-based basket tracking a defined universe—here, a top-100 market-cap set—with scheduled rebalances.)

For searchers comparing “regime switching,” “weekly rebalancing,” and “top 100 crypto index,” TM Global 100 offers one simple answer: rules, not vibes—plus a transparent page that shows what you own and when it changes.

‍

How the TM Global 100 Index Works (Plain English)

  • Regime switching:
    Bull: hold the top 100 by market cap.
    Bear: move fully to stablecoins, wait for a bullish re-entry signal.

  • Weekly rebalancing: Updates weights and constituents to reflect the current top-100 list.

  • Transparency: A Strategy modal explains rules; a Gauge shows the live market signal; Holdings appear in Treemap + Table; and every rebalance/transaction is logged.

  • What you’ll see on launch:
    Price tile • “100 tokens” • “rebalances weekly” • one-click Buy Index flow.

→ See the strategy and rules. (TM Global 100 strategy)

Benefits at a Glance (Why This Beats DIY)

  • Time back: No more tracking 100 tickers or manual reweights. The weekly job runs for you.

  • Discipline on drawdowns: The stablecoin switch enforces risk management when the signal turns.

  • Less execution drag: One embedded wallet checkout vs. dozens of small trades that add slippage and fees.

  • See everything: Gauge → Treemap → Transactions Log—know what you hold, and what changed.

  • Own the market when it’s worth it: Capture broad upside in bullish regimes with top-100 breadth.

Step-by-Step: How to Get Early Access (Waitlist)

  1. Open the Token Metrics Indices hub. (Token Metrics Indices hub)

  2. Tap TM Global 100 and select Join Waitlist.

  3. (Optional) Connect wallet to preview the one-click Buy flow and funding options.

  4. On launch, you’ll receive an email and in-app prompt.

  5. Click Buy Index → review fees/slippage/holdings → confirm. Most users finish in ~90 seconds.

  6. Track your position under My Indices with real-time P&L and a full transactions history.

→ Join the waitlist to be first to trade TM Global 100.

‍

Decision Guide: Is This Right for You?

  • Hands-Off Allocator: Want broad exposure without micromanaging? Consider TM Global 100 for rules-based coverage.

  • Active Trader: Prefer a disciplined core that exits to stables while you run satellite bets.

  • TM Member/Prospect: Already read our research? This turns it into an actionable, one-click index.

  • New to On-Chain: Embedded wallet + clear fees and logs lower the operational lift.

  • Skeptical of Black Boxes: Full strategy copy, holdings, and rebalance logs are visible—no mystery knobs.

FAQs

What is a “crypto index”?
A rules-based basket that tracks a defined universe (here: top-100 market cap), with scheduled rebalances and clear inclusion criteria.

How often does the index rebalance?
Weekly, with additional full-portfolio switches when the market regime changes.

What triggers the move to stablecoins?
A proprietary market signal. Bullish: hold top-100. Bearish: move fully to stablecoins until re-entry.

Can I fund with USDC or fiat?
You’ll use the embedded wallet and supported on-chain assets; USDC is supported for selling. Funding options surface based on chain/wallet at checkout.

Is the wallet custodial?
No. It’s an embedded, self-custodial smart wallet—you control funds.

How are fees shown?
At checkout, you’ll see estimated gas, platform fee, max slippage, and minimum expected value before confirming.

How do I join the waitlist?
Visit the Indices hub, open TM Global 100, and tap Join Waitlist; we’ll notify you at launch. (Token Metrics Indices hub)

Security, Risk & Transparency

  • Self-custody: Embedded smart wallet; you hold keys.

  • Operational clarity: Strategy modal, Holdings treemap/table, and Transactions log.

  • Fee & slippage preview: All shown before you confirm.

  • Regime logic limits: Signals can be wrong; switching can incur spreads and gas.

  • Region notes: Chain and asset support may vary by user wallet and jurisdiction.

Crypto is volatile and can lose value. Past performance is not indicative of future results. This article is for research/education, not financial advice.

Conclusion + Related Reads

If you want broad upside when it’s worth it and stablecoins when it’s not—with weekly rebalances, transparent logs, and a 90-second buy flow—TM Global 100 was built for you. Join the waitlist now and be first to trade at launch.

Related Reads

  • TM Global 100 strategy (TM Global 100 strategy)

  • Token Metrics Indices hub (Token Metrics Indices hub)

  • Best Cryptocurrency Exchanges 2025 (Token Metrics article)

‍

Choose from Platinum, Gold, and Silver packages
Reach with 25–30% open rates and 0.5–1% CTR
Craft your own custom ad—from banners to tailored copy
Perfect for Crypto Exchanges, SaaS Tools, DeFi, and AI Products