Skip to main content
This guide walks you through your first calls to each Risk API endpoint. By the end, you’ll understand the request format, response structure, and key fields for each endpoint.
You’ll need an API key. All requests require a Bearer token. If you don’t have one yet, get your API key →

Authentication

Every Risk API request uses the same authentication pattern. Pass your API key in the Authorization header:
Base URL: https://api.range.org
Keep your API key server-side. Never expose it in client-side code or public repositories.

1. Screen an Address

The Address Risk Score endpoint is the most commonly used starting point. It returns a risk score (1-10) for any blockchain address across 27 supported networks.

Key Response Fields

What the Scores Mean


2. Check Sanctions & Blacklists

The Sanctions & Blacklist Check endpoint screens an address against OFAC sanctions and stablecoin issuer blacklists (Tether, Circle, Coinbase, Paxos).

Key Response Fields

Two Modes

The Address Risk Score endpoint already includes sanctions and blacklist data in its scoring. Use this standalone endpoint when you need explicit sanctions documentation for audit trails, or the detailed event history.

3. Assess Payment Risk

The Payment Risk Assessment endpoint is the most comprehensive check. It analyzes both sender and recipient across 8 independent risk dimensions - including everything Address Risk Score does, plus payment-specific checks.

Key Response Fields

Risk Dimensions Checked


4. Evaluate a Token

The Token Risk Assessment endpoint evaluates up to 17 risk factors for Solana tokens. Try it with USDC:

Key Response Fields

USDC shows HIGH for freeze_authority and minting_authority - this is expected for regulated stablecoins and doesn’t indicate a problem. The overall score accounts for all factors together.

Common Errors


What’s Next

Test Addresses

More test addresses across all endpoints and networks for verifying your integration.

Understanding Risk Scores

Deep dive into how scores are calculated and how to interpret them.

Compliance Pipeline

Build a multi-layered screening workflow combining multiple endpoints.

Wallet Integration

Add real-time risk protection to wallets and dApps.
Last modified on February 10, 2026