Skip to main content

API FAQ's

Find Token Metrics API FAQs in the docs under Support or Developers for quick help on usage, tokens, and troubleshooting.

Updated over 3 months ago

🔑 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?

Q: Do you offer enterprise support?

A: Yes. Premium plan includes priority support. Enterprise solutions available upon request.

Did this answer your question?