Back to blog
Research

Understanding X402: The Protocol Powering AI Agent Commerce

Explore how X402 is transforming AI agent commerce with programmable wallets, interoperable smart contracts, and automated on-chain transactions.
Token Metrics Team
4 min read
Want Smarter Crypto Picks—Free?
See unbiased Token Metrics Ratings for BTC, ETH, and top alts.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
 No credit card | 1-click unsubscribe

Introduction

The intersection of artificial intelligence and blockchain technology has produced numerous innovations, but few have the potential architectural significance of X402. This internet protocol, developed by Coinbase and Cloudflare, is positioning itself as the standard for machine-to-machine payments in an increasingly AI-driven digital economy.

What is X402?

X402 is an open protocol designed specifically for internet-native payments. To understand its significance, we need to consider how the internet operates through layered protocols:

  • HTTP/HTTPS: Powers web browsing
  • SMTP: Enables email communication
  • FTP: Facilitates file transfers
  • X402: Enables seamless payment transactions

While these protocols have existed for decades, X402 - despite being available for over ten years - has only recently found its primary use case: enabling autonomous AI agents to conduct commerce without human intervention.

The Problem X402 Solves

Traditional digital payments require several prerequisites that create friction for automated systems:

  1. Account Creation: Services typically require user registration with identity verification
  2. Subscription Models: Monthly or annual billing cycles don't align with usage-based AI operations
  3. Payment Processing Delays: Traditional payment rails operate on settlement cycles incompatible with real-time AI interactions
  4. Cross-Platform Complexity: Different services require different authentication and payment methods

AI agents operating autonomously need to:

  • Access services immediately without manual account setup
  • Pay per-request rather than commit to subscriptions
  • Transact in real-time with minimal latency
  • Maintain wallet functionality for financial operations

X402 addresses these challenges by creating a standardized payment layer that operates at the protocol level.

How X402 Works

The protocol functions as a real-time usage billing meter integrated directly into API requests. Here's a simplified workflow:

  1. AI Agent Request: An AI agent needs to access a service (e.g., data query, computation, API call)
  2. X402 Header: The request includes X402 payment information in the protocol header
  3. Service Verification: The service provider validates the payment capability
  4. Transaction Execution: Payment processes automatically, often in fractions of a penny
  5. Service Delivery: The requested service is provided immediately upon payment confirmation

This architecture enables transactions "up to a penny in under a second," according to protocol specifications.

Real-World Implementation: Token Metrics API

One of the most practical examples of X402 integration comes from Token Metrics, which has implemented X402 as a pay-per-call option for their cryptocurrency analytics API. This implementation demonstrates the protocol's value proposition in action.

Token Metrics X402 Pricing Structure:

  • Cost per API call: $0.017 - $0.068 (depending on endpoint complexity)
  • Commitment: None required
  • Monthly limits: Unlimited API calls
  • Rate limiting: Unlimited
  • Endpoint access: All endpoints available
  • Historical data: 3 months
  • Web sockets: 1 connection

Why This Matters:

This pricing model fundamentally differs from traditional API access:

Traditional Model:

  • Monthly subscription: $X per month (regardless of usage)
  • Commitment period required
  • Fixed tier with call limits
  • Manual account setup and payment processing

X402 Model:

  • Pay only for actual requests made
  • No upfront commitment or subscription
  • Scale usage dynamically
  • AI agents can access immediately without human intervention

For AI agents performing crypto market analysis, this creates significant efficiency:

  • An agent needing only 100 API calls per month pays ~$1.70-$6.80
  • Traditional subscription might cost $50-500 monthly regardless of usage
  • Agent can start making requests immediately without registration workflow
  • Usage scales perfectly with need

This implementation showcases X402's core value proposition: removing friction between autonomous systems and the services they consume.

Current Adoption Landscape

Analysis of X402scan data reveals the emerging adoption patterns:

Leading Facilitators:

  • Coinbase: Naturally leading adoption as a protocol co-creator
  • Token Metrics: Providing crypto data API access via X402
  • PayAI: Solana-focused payment facilitator gaining traction
  • OpenX402: Independent implementation showing growing transaction volume
  • Various AI Agents: Individual agents implementing X402 for service access

Transaction Metrics (30-day trends):

  • Coinbase maintains 4x transaction volume compared to competitors
  • PayAI experienced significant volatility with 8x price appreciation followed by sharp corrections
  • Slot-based gambling and AI analyst services showing unexpected adoption

Technical Integration Examples

Several platforms have implemented X402 functionality:

API Services:

Rather than requiring monthly subscriptions, API providers can charge per request. Token Metrics exemplifies this model - an AI agent queries their crypto analytics API, pays between $0.017-$0.068 via X402 depending on the endpoint, and receives the data - all within milliseconds. The agent accesses:

  • Unlimited API calls with no rate limiting
  • All available endpoints
  • 3 months of historical data
  • Real-time web socket connection

This eliminates the traditional friction of:

  • Creating accounts with email verification
  • Adding payment methods and billing information
  • Committing to monthly minimums
  • Managing subscription renewals

AI Agent Platforms:

  • Virtuals Protocol: Integrating X402 alongside proprietary solutions
  • AIXBT Labs: Enabling builders to integrate AI agents via X402
  • Eliza Framework: Supporting X402 for Solana-based agent development

Cross-Chain Implementation: X402 operates on multiple blockchain networks, with notable activity on Base (Coinbase's Layer 2) and Solana.

Market Implications

The emergence of X402 as a standard has created several market dynamics:

Narrative-Driven Speculation: Projects announcing X402 integration have experienced significant short-term price appreciation, suggesting market participants view the protocol as a value catalyst.

Infrastructure vs. Application Layer: The protocol creates a distinction between:

  • Infrastructure providers (payment facilitators, protocol implementations)
  • Application layer projects (AI agents, services utilizing X402)

Competitive Landscape: X402 faces competition from:

  • Proprietary payment solutions developed by individual platforms
  • Alternative blockchain-based payment protocols
  • Traditional API key and authentication systems

Use Cases Beyond AI Agents

While AI commerce represents the primary narrative, X402's architecture supports broader applications:

Data Services: As demonstrated by Token Metrics, any API provider can implement pay-per-request pricing. Applications include:

  • Financial market data
  • Weather information services
  • Geolocation and mapping APIs
  • Machine learning model inference
  • Database queries

Micropayment Content: Publishers could charge per-article access at fractional costs

IoT Device Transactions: Connected devices conducting autonomous commerce

Gaming Economies: Real-time, granular in-game transactions

Computing Resources: Pay-per-compute models for cloud services

The Economics of X402 for Service Providers

Token Metrics' implementation reveals the business model advantages for service providers:

Revenue Optimization:

  • Capture value from low-usage users who wouldn't commit to subscriptions
  • Eliminate customer acquisition friction
  • Reduce churn from users only needing occasional access
  • Enable price discovery through usage-based metrics

Market Access:

  • AI agents represent new customer segment unable to use traditional payment methods
  • Automated systems can discover and integrate services programmatically
  • Lower barrier to trial and adoption

Operational Efficiency:

  • Reduce customer support overhead (no subscription management)
  • Eliminate billing disputes and refund requests
  • Automatic revenue recognition per transaction

Challenges and Considerations

Several factors may impact X402 adoption:

Technical Complexity: Implementing X402 requires protocol-level integration, creating barriers for smaller developers.

Network Effects: Payment protocols succeed through widespread adoption. X402 competes with established systems and must reach critical mass.

Blockchain Dependency: Current implementations rely on blockchain networks for settlement, introducing:

  • Transaction costs (gas fees)
  • Network congestion risks
  • Cross-chain compatibility challenges

Pricing Discovery: As seen with Token Metrics' range of $0.017-$0.068 per call, establishing optimal pricing requires experimentation. Too high and traditional subscriptions become competitive; too low and revenue suffers.

Regulatory Uncertainty: Automated machine-to-machine payments operating across borders face unclear regulatory frameworks.

Market Maturity: The AI agent economy remains nascent. X402's long-term relevance depends on AI agents becoming standard economic actors.

Comparing X402 to Alternatives

Traditional API Keys with Subscriptions:

  • Advantage: Established, widely understood, predictable revenue
  • Disadvantage: Requires manual setup, subscription billing, slower onboarding, higher commitment barrier
  • Example: $50/month for 10,000 calls whether used or not

X402 Pay-Per-Call:

  • Advantage: Zero commitment, immediate access, perfect usage alignment, AI-agent friendly
  • Disadvantage: Variable costs, requires crypto infrastructure, emerging standard
  • Example: $0.017-$0.068 per actual call, unlimited potential usage

Cryptocurrency Direct Payments:

  • Advantage: Direct peer-to-peer value transfer
  • Disadvantage: Lacks standardization, higher complexity per transaction, no protocol-level support

Payment Processors (Stripe, PayPal):

  • Advantage: Robust infrastructure, legal compliance
  • Disadvantage: Minimum transaction amounts, settlement delays, geography restrictions

X402's differentiator lies in combining protocol-level standardization with crypto-native functionality optimized for automated systems, as demonstrated by Token Metrics' implementation where AI agents can make sub-dollar API calls without human intervention.

Development Resources

For developers interested in X402 integration:

Documentation: X402.well (protocol specifications)

Discovery Platforms: X402scan (transaction analytics), The Bazaar (application directory)

Integration Frameworks: Virtuals Protocol, Eliza (Solana), various Base implementations

Live Examples: Token Metrics API (tokenmetrics.com/api) demonstrates production X402 implementation

Several blockchain platforms now offer X402 integration libraries, lowering implementation barriers.

Market Performance Patterns

Projects associated with X402 have demonstrated characteristic patterns:

Phase 1 - Announcement: Initial price appreciation upon X402 integration news Phase 2 - Peak Attention: Maximum price when broader market attention focuses on X402 narrative Phase 3 - Stabilization: Price correction as attention shifts to next narrative

PayAI's trajectory exemplifies this pattern - rapid 8x appreciation followed by significant correction within days. This suggests X402-related assets behave as narrative-driven trading vehicles rather than fundamental value plays, at least in current market conditions.

However, service providers implementing X402 functionality (like Token Metrics) represent a different category - they're adding practical utility rather than speculating on the protocol itself.

Future Outlook

The protocol's trajectory depends on several factors:

AI Agent Proliferation: As AI agents become more autonomous and economically active, demand for payment infrastructure grows. Early implementations like Token Metrics' API access suggest practical demand exists.

Developer Adoption: Whether developers choose X402 over alternatives will determine market position. The simplicity of pay-per-call models may drive adoption.

Service Provider Economics: If providers like Token Metrics successfully monetize X402 access, other API services will follow. The ability to capture previously inaccessible low-usage customers creates compelling economics.

Institutional Support: Coinbase's backing provides credibility, but sustained development and promotion are necessary.

Regulatory Clarity: Clear frameworks for automated, cross-border machine transactions would reduce adoption friction.

Interoperability Standards: Success may require coordination with other emerging AI commerce protocols.

Conclusion

X402 represents an attempt to solve genuine infrastructure challenges in an AI-driven economy. The protocol's technical architecture addresses real friction points in machine-to-machine commerce, as demonstrated by Token Metrics' implementation of pay-per-call API access at $0.017-$0.068 per request with no commitments required.

This real-world deployment validates the core thesis: AI agents need frictionless, usage-based access to services without traditional account creation and subscription barriers. However, actual adoption remains in early stages, and the protocol faces competition from both traditional systems and alternative blockchain solutions.

For market participants, X402-related projects should be evaluated based on:

  • Actual transaction volume and usage metrics (not just speculation)
  • Developer adoption and integration depth
  • Real service implementations (like Token Metrics API)
  • Competitive positioning against alternatives
  • Sustainability beyond narrative-driven speculation

The protocol's long-term relevance will ultimately be determined by whether AI agents become significant economic actors requiring standardized payment infrastructure. While the technical foundation appears sound and early implementations show promise, market validation remains ongoing.

Key Takeaways:

  • X402 enables real-time, micropayment commerce for AI agents
  • Token Metrics API offers practical X402 implementation at $0.017-$0.068 per call with no commitments
  • Protocol operates at the internet infrastructure layer, similar to HTTP or SMTP
  • Pay-per-call model eliminates subscription friction and enables AI agent access
  • Current adoption concentrated on Base and Solana blockchains
  • Market interest has driven speculation in X402-related projects
  • Service provider implementations demonstrate real utility beyond speculation
  • Long-term success depends on AI agent economy maturation

This analysis is for informational purposes only. X402 adoption and associated project performance remain highly uncertain and subject to rapid change.

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
About Token Metrics
Token Metrics: AI-powered crypto research and ratings platform. We help investors make smarter decisions with unbiased Token Metrics Ratings, on-chain analytics, and editor-curated “Top 10” guides. Our platform distills thousands of data points into clear scores, trends, and alerts you can act on.
30 Employees
analysts, data scientists, and crypto engineers
Daily Briefings
concise market insights and “Top Picks”
Transparent & Compliant
Sponsored ≠ Ratings; research remains independent
Want Smarter Crypto Picks—Free?
See unbiased Token Metrics Ratings for BTC, ETH, and top alts.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
 No credit card | 1-click unsubscribe
Token Metrics Team
Token Metrics Team

Recent Posts

Research

Regime Switching Explained: Why Smart Crypto Indices Move to Stablecoins

Token Metrics Team
6

The best trade in crypto isn't always a trade—sometimes it's knowing when to step aside. While traditional indices force you to ride every crash from peak to bottom, regime-switching indices take a smarter approach: participate when conditions warrant, preserve capital when they don't. This systematic method of moving between crypto exposure and stablecoins has become the defining feature of next-generation index products, with Token Metrics leading the implementation through data-driven market signals.

What Is Regime Switching?

Regime switching is a systematic investment approach that classifies market conditions into distinct states—typically "bullish" and "bearish"—then adjusts portfolio positioning accordingly. Unlike static indices that maintain constant exposure regardless of conditions, regime-switching strategies dynamically allocate between risk assets and defensive positions based on quantifiable signals.

In practice for crypto indices:

This isn't emotional market timing or gut-feel trading. It's rules-based risk management following consistent, transparent criteria. The decision to switch regimes comes from systematic signals, not fear or greed.

The Traditional Index Problem

Standard crypto indices like market-cap weighted baskets operate on a simple premise: buy the universe, hold forever, rebalance periodically. This works well in prolonged bull markets but fails catastrophically during extended bear cycles.

Real performance data illustrates the problem:

Net result: Investors who bought January 2021 and held through December 2022 saw minimal net gains despite experiencing a massive bull run. The issue isn't the bull market capture—traditional indices do fine when prices rise. The problem is forced participation during catastrophic drawdowns that destroy years of gains in months. A 75% drawdown requires a 300% gain just to break even.

Research across historical crypto cycles shows that systematic regime-switching approaches have historically reduced maximum drawdowns by 40-60% while capturing 70-85% of bull market upside—a compelling risk-adjusted return profile that buy-and-hold cannot match.

Why Stablecoins, Not Cash?

Regime-switching crypto indices face a unique constraint: they operate on-chain and must maintain 24/7 liquidity for instant redeployment. This makes stablecoins the optimal defensive asset for several critical reasons:

Discover Crypto Gems with Token Metrics AI

Token Metrics uses AI-powered analysis to help you uncover profitable opportunities in the crypto market. Get Started For Free

The Signal Behind the Switch

The most critical component of regime-switching isn't the mechanism—it's the signal that triggers the switch. Token Metrics has built its reputation as a leading crypto analytics platform by developing sophisticated, data-driven market intelligence relied upon by over 50,000 traders and investors daily.

Token Metrics' Market Regime Detection employs a proprietary multi-factor model analyzing:

This synthesis results in a probabilistic assessment: whether the environment is bullish enough to risk capital or bearish enough to prioritize preservation.

Transparency is maintained by displaying current regime signals in real-time via visual market gauges, while proprietary model parameters and thresholds remain confidential to prevent strategic front-running.

Real Performance: When Regime Switching Matters Most

Regime-switching strategies excel during major bear markets that erode traditional portfolios:

Starting with $100,000 in November 2021, buy-and-hold would result in approximately $89,000 after recovering from -73%. The regime approach, with smaller drawdowns and better upside capture, could have grown the portfolio to around $152,000, emphasizing how avoiding large losses compounds benefits over time.

Implementation: How TM Global 100 Executes Switches

The TM Global 100 index automates regime switching with simplicity and transparency:

User Experience

Behind the Scenes

When signals turn bearish, the index:

Reversal when signals turn bullish follows the same systematic process.

The Cost of Switching

Every regime transition incurs costs:

Token Metrics estimates costs at approximately 0.8-1.5% per full switch, which becomes cost-effective when signals reliably avoid large drawdowns. Frequent whipsaws are mitigated by the model's stability factors, and projected costs are shown upfront for transparency.

Decision Framework: Is Regime Switching Right for You?

Consider regime switching if you:

Alternatively, if you have long-term horizons, believe markets are fully efficient, or prefer a buy-and-hold strategy, it might not suit you. Both approaches have their merits, but regime switching offers a balanced risk-adjusted profile for volatile crypto markets.

Where Research Meets Execution

Token Metrics has established itself as a leading crypto analytics platform by providing:

However, research alone isn't enough. The TM Global 100 index closes the gap between signal generation and automated execution—applying sophisticated regime logic seamlessly, enabling users to act on data-driven insights instantly with transparency and confidence.

Conclusion: Discipline Over Emotion

Regime switching removes emotional decision-making—often the hardest part of crypto investing. It systematically guides investors to participate during bull runs, protect capital during downturns, and avoid knee-jerk reactions to market volatility. This disciplined approach helps to sustain long-term growth while minimizing the pain of large drawdowns, demonstrating the evolution of systematic crypto investment strategies.

Click here to get early access to Token Metrics indices.

Research

Why Manual Crypto Portfolio Management Is Costing You Money (And Time)

Token Metrics Team
6

You're tracking 50+ tokens across three exchanges, updating your rebalancing spreadsheet every weekend, and second-guessing every exit decision at 2 AM. Sound familiar? Manual crypto portfolio management isn't just exhausting—it's expensive. Between missed rebalances, execution drag, and behavioral mistakes during volatility, DIY portfolio management quietly erodes returns before you see any market gains.

The data tells the story: investors who manually manage diversified crypto portfolios typically underperform comparable automated strategies by 12-18% annually, with 60% of that gap coming from operational inefficiency rather than market timing. If you're spending 10+ hours weekly maintaining positions, those hours have a cost—and it's higher than you think.

The Hidden Costs Destroying Your Returns

Time Drain: The 500-Hour Tax

Managing a diversified crypto portfolio demands constant vigilance. For investors holding 20+ positions, the weekly time investment breaks down to approximately:

  • Market monitoring: 5-8 hours tracking prices, news, and on-chain metrics
  • Rebalancing calculations: 2-3 hours determining optimal weights and required trades
  • Order execution: 3-5 hours placing trades across multiple platforms
  • Record keeping: 1-2 hours logging transactions for tax reporting
  • Research updates: 3-5 hours staying current on project developments

That's 14-23 hours weekly, or 728-1,196 hours annually. At a conservative $50/hour opportunity cost, you're spending $36,400-$59,800 in time value maintaining your portfolio. Even if you value your time at minimum wage, that's still $10,000+ in annual "sweat equity" that automated solutions eliminate.

Execution Drag: Death by a Thousand Trades

Small trades erode portfolios through accumulated friction. Every manual rebalance across a 50-token portfolio requires dozens of individual transactions, each incurring:

  • Trading fees: 0.1-0.5% per trade (average 0.25%)
  • Bid-ask spreads: 0.2-0.8% depending on liquidity
  • Slippage: 0.3-1.2% on smaller cap tokens
  • Gas fees: $2-50 per transaction depending on network congestion

For a $100,000 portfolio rebalanced monthly with 40 trades per rebalance, the costs add up:

  • Average cost per trade: ~$100
  • Monthly execution drag: $4,000
  • Annual execution drag: $48,000 (48% of portfolio value)

The smaller your individual trades, the worse the ratio becomes. A $500 rebalancing trade on a low-liquidity altcoin might pay $25 in fees—a 5% instant loss before any price movement.

Automated indices solve this. TM Global 100, Token Metrics' rules-based index, consolidates 100 individual positions into a single transaction at purchase, with weekly rebalances executed through optimized smart contract batching. Users typically save 3-7% annually in execution costs alone compared to manual approaches.

Behavioral Mistakes: Your Worst Enemy Is in the Mirror

Market psychology research shows that manual portfolio managers tend to make predictable, costly mistakes:

  • Panic selling during drawdowns: When Bitcoin drops 25% in a week, can you stick to your exit rules? Many override their plans during high volatility, often selling near local bottoms.
  • FOMO buying at peaks: Tokens up 300% in a week attract chase behavior, with managers entering after the movement is mostly over.
  • Rebalancing procrastination: Putting off rebalancing leads to drift, holding too much of past winners and missing new opportunities.

Token Metrics' systematic approach removes emotion from the equation. The TM Global 100 Index follows a transparent ruleset: hold the top 100 tokens by market cap during bullish phases, shift to stablecoins during bearish cycles, and rebalance weekly—eliminating emotional override and procrastination.

Missed Rebalances: Drifting Out of Position

Market cap rankings shift constantly. A token ranked #73 on Monday might hit #95 by Friday, or surge to #58. Without systematic rebalancing, your portfolio becomes a collection of recent winners or dumpers.

In Q3 2024, Solana ecosystem tokens surged while Ethereum DeFi tokens consolidated. Manual managers who missed weekly rebalances held too much ETH and insufficient SOL exposure. The result: 15-20% underperformance compared to systematically rebalanced portfolios. Data from Token Metrics shows that weekly rebalancing outperforms monthly or quarterly approaches by 8-12% annually.

Tax Reporting Nightmares

Every trade creates a taxable event. Manual managers executing over 200 trades yearly face:

  • Hours spent compiling transaction logs
  • Reconciliation across multiple exchanges
  • Cost-basis tracking for numerous lots
  • High professional accounting fees ($500-2,000+)

Automated solutions like Token Metrics provide transparent transaction logs for each rebalance, simplifying tax reporting and reducing accounting costs.

The Token Metrics Advantage: Research Meets Execution

Token Metrics has established itself as a leading crypto analytics platform, supporting over 50,000 users with AI-powered token ratings, market regime detection, portfolio optimization tools, and trading signals. But analysis alone isn't enough—implementation is crucial.

TM Global 100 Index bridges this gap. It turns research into actionable, tradeable products by automating rebalancing based on Token Metrics' signals and methodology. One click replaces hours of manual work, following a validated systematic approach.

Automation Without Compromise

The best automation is transparent. TM Global 100 offers:

  • Rules-Based Discipline: Bull markets—hold top 100 tokens; bear markets—move to stablecoins
  • Weekly rebalancing every Monday
  • Full methodology disclosure
  • One-Click execution via embedded self-custodial wallet
  • Real-time market insights and holdings visualization
  • Transaction logs with fees and timestamps

This streamlined process allows users to rapidly execute disciplined rebalancing, saving countless hours and increasing operational efficiency while maintaining asset control.

Decision Framework: When to Automate

Automation suits investors who:

  • Hold 15+ tokens and find rebalancing burdensome
  • Miss optimal rebalancing windows due to time constraints
  • Have experienced emotional trading decisions during volatility
  • Spend over 5 hours a week on portfolio management
  • Want broad exposure without manual tracking

Manual management may be suitable for those with fewer positions, active trading infrastructure, or tactical strategies. For most diversified portfolios, automation enhances efficiency and reduces operational errors.

The Compound Effect of Efficiency

Small inefficiencies compound over time. Over five years, a $50,000 portfolio managed manually with a 12% annual return minus 4-2-1% losses yields roughly a 5% net return, ending at about $63,814. A systematic approach with optimizer integration, zero behavioral errors, and regular rebalancing can attain a 13% net return, reaching approximately $92,246—an increase of over $28,000, not counting time saved.

Conclusion: Time Back, Returns Up

Manual crypto portfolio management made sense when portfolios were small and concentrated. Today’s diversified sets require operational discipline to prevent erosion of returns due to execution drag, missed rebalances, and emotional mistakes. Token Metrics built TM Global 100 to turn research into automated, transparent execution, reclaim your time, and boost portfolio discipline—without sacrificing control.

Research

Moonshots API: Discover Breakout Tokens Before the Crowd

Token Metrics Team
5

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

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

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

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 enables users to 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 to smooth traffic and avoid duplicates. Always make notifications idempotent.

Production Checklist

Use Cases & Patterns

Next Steps

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.

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