Before you can tap into the rich data streams and AI-powered intelligence of the Token Metrics API, you need to know how to authenticate properly. Authentication is how your app securely proves who it is and gets access to the API.
In this blog post, we’ll cover how Token Metrics API authentication works, how to send your API key in requests, and how to troubleshoot common issues.
🔐 Why API Authentication Matters
APIs are like doors to a system. Without authentication, those doors would be open to anyone—including bad actors. API keys protect your access, control rate limits, and track usage by linking each request to a verified account.
The Token Metrics API uses API key authentication via headers, which is simple, fast, and secure when implemented correctly.
📘 Authentication Method: x-api-key Header
To connect to the Token Metrics API, every request must include your API key in the header. Here’s the format:
Header:
x-api-key: YOUR_API_KEY_HERE
Base URL:
https://api.tokenmetrics.com/v2/
💻 Example: Using cURL to Fetch Token Data
curl -X GET "https://api.tokenmetrics.com/v2/tokens/BTC" \
-H "x-api-key: YOUR_API_KEY_HERE"
That’s it! If the key is valid and active, the API will return live data instantly.
🧠 Tip: Store API Keys Securely
Never hard-code your API key into frontend code or expose it in GitHub repositories. Instead:
Use environment variables for local development
Use a secret manager (like AWS Secrets Manager or Google Secret Manager) for production apps
📊 Track Your Usage
You can monitor your API usage by visiting your dashboard:
👉 app.tokenmetrics.com/en/api
There, you’ll see:
API call graphs and quotas
Rate limit performance
Logs for each request (time, endpoint, status)
🧯 Troubleshooting Authentication Errors
❌ 401 Unauthorized
Likely cause: Missing, expired, or invalid API key.
Fix: Double-check you’ve pasted the correct API key in the header.
❌ 403 Forbidden
Likely cause: The API key is inactive or your current plan does not have access to the requested endpoint.
Fix: Log into your dashboard and ensure your key is active and has permissions.
❌ 429 Too Many Requests
Likely cause: You exceeded the rate limit.
Fix: Throttle your requests or upgrade to a higher tier.
📦 Token Metrics API Plans and Rate Limits
Plan
API Calls/Month
Rate Limit
Endpoints Included
Free
5,000
1 req/min
Price, Trader Grade, Signals
Advanced
20,000
60 req/min
Indices, Sentiment, Grades
Premium
100,000
180 req/min
All AI tools and endpoints
VIP
500,000
600 req/min
Full access + priority
🚀 Start Sending Authenticated Requests
With a single line of code, you can access the same predictive signals, grades, and analytics trusted by thousands of traders and developers. Authentication is easy—but essential.
💡 Reminder: Every request = 1 credit, so efficient API usage helps you stay within quota.
Ready to build?
👉 Generate Your API Key Now → tokenmetrics.com/api
Top comments (0)