Authentication

API Key Authentication

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

Getting Your API Key

If you need access, request a time-limited Sandbox.

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"

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

import requests

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

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",
    },
  }
);
const data = await response.json();

Rate Limits

Rate limits and quotas depend on your account. Use the X-RateLimit-* response headers below to check your current limit and usage.

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 the X-RateLimit-Reset header), or contact Range to discuss higher limits.

Best Practices

Environment Variables

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

export RANGE_API_KEY="YOUR_API_KEY"

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?

Discuss Rate Limits

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?

Discuss Rate Limits

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?