Unlock the Power of AI for Crypto: Build Smarter with the Token Metrics API & SDK
Looking to supercharge your crypto tools with cutting-edge intelligence? The Token Metrics API & SDK delivers real-time, AI-powered insights that help you build faster, and smarter. Whether you’re a trader looking for an edge, a developer building the next big thing, or part of a crypto startup, this platform gives you direct access to the same AI that spotted MATIC at $0.03 and SOL at $1.
With zero need to reinvent the wheel, you can create powerful tools like trading bots, market dashboards, and forecasting engines, all backed by more than 30 high-quality data points.
🔧 What Can You Build?
Here’s a taste of what’s possible with the Token Metrics API:
AI-Powered Trading Bots – Automate trades on CEXs or DEXs with real-time buy/sell signals.
Market Dashboards – Monitor sentiment, price trends, and crypto correlations in one sleek view.
Telegram/Discord Bots – Keep your community in the loop with live market alerts.
Price Prediction Tools – Use machine learning to forecast crypto price movements.
Asset Scoring Engines – Evaluate any token using AI-generated investor and trader grades.
🚀 Get Started in Minutes
1. Sign Up for Free
Create your account at tokenmetrics.com/api
2. Generate Your API Key
Your personal key unlocks access to all endpoints.
3. Explore the Docs
Experiment with sample calls and see what’s possible.
4. Choose Your Plan
Start with 50 free API calls/month, or stake TMAI tokens to unlock more.
5. (Optional) Download the SDK
Jumpstart development with our official SDKs in Python and JavaScript.
🛠️ Built for Builders
30+ endpoints across AI signals, grades, forecasts, and more
Real-time data via REST & WebSockets
Developer-friendly SDKs for Python and JavaScript
Built-in usage dashboard for tracking API calls and billing
🔑 Getting Started
Q: What is the Token Metrics API?
A: The Token Metrics API provides real-time and historical market data, proprietary AI-driven grades (TM, Fundamental, Technology), trading signals, indices, AI reports, and a conversational crypto agent. It’s designed for traders, developers, analysts, and researchers who need institutional-grade data.
Q: How do I get an API key?
A: Sign up at Token Metrics, then go to your API Dashboard → API Keys to generate a key.
Q: How do I authenticate?
A: Include your API key in the header:
x-api-key: YOUR_API_KEY
Or, use x402 pay-per-call (wallet-based, no API key required).
Q: Is there a free tier?
A: Yes. The Basic plan includes 500 calls/month, 5 req/min, and access to top-50 market cap assets for TM Grades and Trading Signals.
💼 Plans & Pricing
Q: What plans are available?
Basic (Free) — 500 calls/month, 5 req/min, TM Grades + Trading Signals for top-50 assets
Pay-as-you-go (x402) — Pay per call in USDC or TMAI ($0.017–$0.068 per call depending on endpoint)
Advanced — $99.99/month or $999.90/year, 20,000 calls, 60 req/min, access to all core endpoints (TM Grades, Indices)
Premium — $199.99/month or $1,999.90/year, 100,000 calls, 180 req/min, includes AI Reports, TM AI Agent, Quantmetrics, Moonshot Tokens
Q: Is there still a VIP plan?
A: No. The top public plan is Premium.
Q: How do overages work?
A: Usage beyond your quota is billed per call:
$0.017 USDC / $0.0153 TMAI — Signals, OHLCV
$0.034 USDC / $0.0306 TMAI — Grades, Indices, Market Metrics
$0.068 USDC / $0.0612 TMAI — AI Reports, Quantmetrics, Moonshot Tokens, TM AI Agent
Q: How does the TMAI discount work?
A: Paying with TMAI via x402 applies up to 35% discount.
📊 Endpoints & Data
Q: What are the most popular endpoints?
/tokens — Metadata + IDs
/price, /hourly-ohlcv, /daily-ohlcv — Real-time + historical prices
/tm-grade — Proprietary TM Grade (quant signals, momentum, buy/sell triggers)
/fundamental-grade, /technology-grade — Project quality & dev activity
/trading-signals — Entry/exit buy/sell calls
/indices — AI-powered indices
/resistance-support — Price levels & volatility
/moonshot-tokens — AI-curated high potential tokens
/ai-reports — Research briefs
/tmai — Conversational crypto agent
Q: How often is data updated?
Market data: near real-time
Signals: intraday/daily
Grades: daily (with history available)
Reports & indices: at refresh cycles
Q: How deep is historical coverage?
Prices: up to 3+ years (plan dependent)
Grades: historical TM, Fundamental, Technology grades
Indices: performance history
📈 Usage & Limits
Q: What are the rate limits by plan?
Basic — 5 req/min
Advanced — 60 req/min
Premium — 180 req/min
Q: What happens when I hit my quota?
Basic → Calls are blocked; upgrade banner appears.
Pay-as-you-go → Automatically billed per call.
Paid plans → Overages billed at per-call pricing.
Q: How can I monitor my usage?
A: The API Dashboard shows:
Daily API call volume
Remaining calls + reset date
Request logs (endpoint, IP, status, timestamp)
Q: How do I avoid hitting rate limits?
A:
Use batching where possible
Cache responses instead of calling repeatedly
Monitor quota from the dashboard
🔌 Integrations & Tools
Q: Can I use the API with no-code tools?
A: Yes. Integrations include: Postman, Zapier, RapidAPI, Smithery, and MCP server for AI assistants (Claude, OpenAI, Cursor, Windsurf, VS Code).
Q: What AI frameworks are supported?
Current: Replit, QuickNode, LangChain, Claude, Cline, Cursor
Coming soon: Chainlink, Alchemy, Dune, Fetch.ai, Virtuals TM-Oracle, Hugging Face
Q: Do you provide SDKs?
A: Official Postman collection + GitHub resources are available. x402 integration examples exist for Node.js and Python.
💳 x402 Pay-Per-Call
Q: What is x402?
A: Coinbase’s pay-per-call standard. Lets you call Token Metrics API without an API key, paying directly from your wallet in USDC or TMAI.
Q: How do I use it?
Add x-coinbase-402: true header
Add x-payment-token: usdc | tmai (optional)
Do not include x-api-key
Q: Do I need to set a payment cap?
A: Yes for TMAI (suggested 200 TMAI max per call).
🛠 Errors & Troubleshooting
Q: What errors might I see?
200 — Success
400 — Bad request (invalid params, date ranges, etc.)
401 — Unauthorized (missing/invalid API key)
403 — Forbidden (inactive/blocked key)
404 — Not found
429 — Too many requests (rate limit exceeded)
500 — Server error
503 — Service unavailable
Q: Why am I getting “Unauthorized” errors?
A: Check that your API key is valid, not expired, and tied to the right plan.
Q: How do I debug failed calls?
A: Use the API dashboard logs — check endpoint, timestamp, IP, and status code.
🔐 Security & Best Practices
Q: How should I store my API key?
A: Never expose keys in front-end code or GitHub. Store them in backend env variables or secret managers.
Q: Can I share my API key?
A: No. Keys are account-specific. Sharing may lead to suspension.
Q: How do I rotate keys?
A: Delete old keys and generate new ones in the dashboard.
📞 Support
Q: Where can I get help?
Email: [email protected]
Telegram: https://t.me/tokenmetricsapi
Q: Do you offer enterprise support?
A: Yes. Premium plan includes priority support. Enterprise solutions available upon request.
Whether you're building a bot, a dashboard, or the next big DeFi app, Token Metrics gives you the tools and data to do it better, faster, and smarter.