Quickstart - Range Docs

Get from zero to your first authenticated API call in under five minutes.

1. Create your account and generate an API key

Create an account or log in at app.range.org.

Open your API settings

Go to Settings > API (app.range.org/keys).

Generate your API key

Generate your key and copy it to start making authenticated requests.

Copy your API key when you generate it. Range shows it only once and does not display it again. You can revoke and rotate keys at any time from your API settings.

2. Authenticate

All Range API requests require authentication via an API key passed in the request header. Include your API key in every request using the Authorization header:

Authorization: Bearer your_api_key_here

Keep your API key secure. Never expose it in client-side code or public repositories. Use environment variables in production.

3. Make your first request

Pick the API you want to start with. Each tab shows a sample call and a link to that API’s own quickstart for the full walkthrough.

Data API
Risk API
Platform API
Faraday API

Look up blockchain address data:

curl 'https://api.range.org/v1/address?address=CCTPiPYPc6AsJuwueEnWgSgucamXDZwBd53dQ11YiKX3&network=solana' \
  --header 'Authorization: Bearer your_api_key_here'

Explore the Data API →

Score an address for risk:

curl -G 'https://api.range.org/v1/risk/address' \
  --data-urlencode 'address=TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA' \
  --data-urlencode 'network=solana' \
  --header 'Authorization: Bearer your_api_key_here'

Risk API quickstart →

List the counterparties in your workspace:

curl 'https://api.range.org/v2/counterparties' \
  --header 'Authorization: Bearer your_api_key_here'

Explore the Platform API →

Get a quote for a cross-chain transfer using the Faraday SDK:

import { FaradayClient } from "@rangesecurity/faraday-sdk";

const client = new FaradayClient({ apiKey: process.env.RANGE_API_KEY });

const quote = await client.getQuote({
  fromChain: "ethereum",
  toChain: "solana",
  fromToken: "USDC",
  toToken: "USDC",
  amount: "1000",
});

Integrate Faraday →

4. Rate limits and best practices

Rate limits

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.

Error handling

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

Best practices

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

Next steps

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

Data API

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

Risk API

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

Faraday API

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

Platform API

Manage your Range organization, API keys, users and account settings programmatically.

​1. Create your account and generate an API key

​2. Authenticate

​3. Make your first request

​4. Rate limits and best practices

​Next steps

Data API

Risk API

Faraday API

Platform API

1. Create your account and generate an API key

2. Authenticate

3. Make your first request

4. Rate limits and best practices

Next steps