Skip to main content

​
Authentication

All Range API requests require authentication via an API key passed in the request header.
If you haven’t generated your API key yet, follow the Getting Started guide to create your account and obtain credentials.

​
Header Format

Include your API key in every request using the X-API-KEY header: 
X-API-KEY: your_api_key_here
Keep your API key secure. Never expose it in client-side code or public repositories. Use environment variables in production.

​
Making Your First Request

​
Example: Get Address Information

Retrieve comprehensive blockchain address data including labels, risk scores, and activity across chains. 
curl --location 'https://api.range.org/v1/address?address=CCTPiPYPc6AsJuwueEnWgSgucamXDZwBd53dQ11YiKX3&network=solana' \
  --header 'X-API-KEY: your_api_key_here'

{
    "address": "CCTPiPYPc6AsJuwueEnWgSgucamXDZwBd53dQ11YiKX3",
    "ecosystem": "solana",
    "network": "solana",
    "name_tag": "CCTP TokenMessengerMinter",
    "category": "DEFI, BRIDGE",
    "address_role": "Program",
    "entity": "",
    "attributes": {},
    "tags": [],
    "malicious": false,
    "is_validator": false
}

​
Explore More Endpoints

Now that you’ve made your first request, explore the full Range API suite:

Data API Reference

Access unified blockchain data, protocol analytics, and stablecoin intelligence across multiple chains.

Risk API Reference

Screen wallets, transactions, and tokens for sanctions, security risks, and compliance checks.

Faraday API Reference

Execute compliant cross-chain stablecoin transfers with best-price routing and built-in compliance.

Full API Specifications

Browse complete OpenAPI specifications with detailed parameters, responses, and examples for all endpoints.

​
Rate Limits & Best Practices

  • Risk API: 10 requests per month (trial)
  • Faraday API: 100 requests per month (trial)
  • Data API: 100 requests per month (trial)
  • Enterprise: Custom limits and higher tiers available
Monitor your usage via the Range dashboard. Contact us to upgrade or discuss higher limits.
All errors return standard HTTP status codes with JSON error messages:
{
  "error": "Invalid API key",
  "status": 401,
  "message": "The provided API key is invalid or expired"
}
Common status codes:
  • 200: Success
  • 400: Bad request (invalid parameters)
  • 401: Unauthorized (invalid API key)
  • 429: Rate limit exceeded
  • 500: Server error
  • Cache responses when possible to reduce API calls
  • Use batch endpoints when available for multiple queries
  • Implement exponential backoff for rate limit errors
  • Monitor your usage via the Range dashboard
  • Subscribe to webhooks for real-time updates instead of polling
Need help? Contact our support team or check out our API Reference for detailed endpoint documentation.