Authentication

API Key Authentication

All Range Data API requests require authentication using an API key passed in the request header.

Getting Your API Key

Create a free account at app.range.org

Generate API Key

Navigate to your dashboard and generate a new API key

Copy & Secure

Copy your API key and store it securely. Treat it like a password, never commit it to version control.

Making Authenticated Requests

Include your API key in the Authorization header with every request:

curl -X GET "https://api.range.org/v1/address?address=YOUR_ADDRESS&network=solana" \
  -H "Authorization: Bearer your_api_key_here"

const response = await fetch(
  "https://api.range.org/v1/address?address=YOUR_ADDRESS&network=solana",
  {
    headers: {
      Authorization: "Bearer your_api_key_here",
    },
  }
);
const data = await response.json();

import requests

headers = {
    'Authorization': 'Bearer your_api_key_here'
}

response = requests.get(
    'https://api.range.org/v1/address',
    params={'address': 'YOUR_ADDRESS', 'network': 'solana'},
    headers=headers
)
data = response.json()

const response = await fetch(
  "https://api.range.org/v1/address?address=YOUR_ADDRESS&network=solana",
  {
    headers: {
      Authorization: "Bearer your_api_key_here",
    },
  }
);
const data = await response.json();

Rate Limits

API rate limits vary by plan tier:

Plan	Rate Limit	Monthly Quota
Free	10 requests/minute	100 requests/month
Pro	100 requests/minute	10,000 requests/month
Enterprise	Custom	Custom

Rate limit headers are included in every API response to help you track usage:

X-RateLimit-Limit: Your rate limit ceiling - X-RateLimit-Remaining: Requests remaining in current window - X-RateLimit-Reset: Time when the rate limit resets (Unix timestamp)

Error Responses

401 Unauthorized

Missing or invalid API key:

{
  "statusCode": 401,
  "message": "Unauthorized",
  "error": "Invalid or missing API key"
}

Solution: Verify your API key is correct and included in the Authorization header.

429 Too Many Requests

Rate limit exceeded:

{
  "statusCode": 429,
  "message": "Too Many Requests",
  "error": "Rate limit exceeded. Please try again later."
}

Solution: Wait for the rate limit window to reset (check X-RateLimit-Reset header) or upgrade your plan.

Best Practices

Environment Variables

Store your API key in environment variables, never hardcode it:

export RANGE_API_KEY="your_api_key_here"

const apiKey = process.env.RANGE_API_KEY;

Server-Side Only

Never expose your API key in client-side code (frontend JavaScript, mobile apps). Make API calls from your backend server.

Key Rotation

Rotate your API keys periodically and immediately if you suspect they’ve been compromised. You can generate new keys in your dashboard.

Monitor Usage

Track your API usage in the Range dashboard to avoid hitting rate limits and optimize your integration.

Overview

API Reference

API Key Authentication

Getting Your API Key

Making Authenticated Requests

Rate Limits

Error Responses

401 Unauthorized

429 Too Many Requests

Best Practices

Need Help?

Upgrade Your Plan

Contact Support

​API Key Authentication

​Getting Your API Key

​Making Authenticated Requests

​Rate Limits

​Error Responses

​401 Unauthorized

​429 Too Many Requests

​Best Practices

​Need Help?

Upgrade Your Plan

Contact Support

API Key Authentication

Getting Your API Key

Making Authenticated Requests

Rate Limits

Error Responses

401 Unauthorized

429 Too Many Requests

Best Practices

Need Help?