> ## Documentation Index
> Fetch the complete documentation index at: https://docs.range.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Risk API

> Comprehensive risk scoring and threat detection for blockchain addresses, transactions, tokens, and smart contracts.

Range's Risk API provides real-time risk intelligence for blockchain activity. Screen addresses for proximity to malicious actors, assess token legitimacy, evaluate payment safety, and check sanctions compliance - all through a unified API.

<Info>
  **Authentication required.** All Risk API requests require a Bearer token in the `Authorization` header. [Get your API key →](/introduction/getting-started)
</Info>

**Base URL:** `https://api.range.org`

***

## Which Endpoint Should I Use?

| I want to...                                               | Endpoint                                                                    | Networks                                                                                                       |
| ---------------------------------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Check if an address is connected to known malicious actors | [Address Risk Score](/risk-api/risk/get-address-risk-score)                 | Solana, EVM chains, Stellar, Bitcoin, Tron, Cosmos and more [see all](/risk-api/product-info/supported-chains) |
| Evaluate end-to-end payment safety between two addresses   | [Payment Risk Assessment](/risk-api/risk/get-payment-risk-assessment)       | Solana, Stellar, Cosmos [see all](/risk-api/product-info/supported-chains)                                     |
| Check OFAC sanctions and stablecoin issuer blacklists      | [Sanctions & Blacklist Check](/risk-api/risk/get-sanctions-blacklist-check) | All (OFAC), Ethereum/Tron/Solana (blacklists)                                                                  |
| Assess the risk profile of a token                         | [Token Risk Assessment](/risk-api/risk/get-token-risk-assessment)           | Solana                                                                                                         |
| Simulate a transaction before broadcasting                 | [Transaction Simulator](/risk-api/simulator/simulate-solana-transaction)    | Solana, Osmosis, Neutron                                                                                       |

***

## Quick Start

New to the Risk API? The [Quick Start guide](/risk-api/quickstart) walks you through your first calls to each endpoint with example requests and response interpretation.

<Card title="Risk API Quick Start" icon="rocket" href="/risk-api/quickstart">
  Make your first API calls and learn how to interpret the responses.
</Card>

***

## Risk Endpoints

<CardGroup cols={2}>
  <Card title="Address Risk Score" icon="location-dot" href="/risk-api/risk/get-address-risk-score">
    Risk scores for blockchain addresses using network proximity analysis and ML-based threat detection.
  </Card>

  <Card title="Token Risk Assessment" icon="coins" href="/risk-api/risk/get-token-risk-assessment">
    Multi-factor risk analysis for Solana tokens across 17 independent risk factors.
  </Card>

  <Card title="Payment Risk Assessment" icon="money-bill-transfer" href="/risk-api/risk/get-payment-risk-assessment">
    End-to-end risk evaluation for payment transactions and fund transfers.
  </Card>

  <Card title="Sanctions & Blacklist Check" icon="ban" href="/risk-api/risk/get-sanctions-blacklist-check">
    OFAC sanctions screening and stablecoin issuer blacklist checks.
  </Card>
</CardGroup>

### Coming Soon

<CardGroup cols={2}>
  <Card title="Transaction Risk Score" icon="arrow-right-arrow-left" href="/risk-api/risk/get-transaction-risk-score">
    Risk scoring for individual blockchain transactions.
  </Card>

  <Card title="Smart Contract Risk" icon="file-contract" href="/risk-api/risk/get-smart-contract-risk">
    Security vulnerability assessment for Solana smart contracts.
  </Card>
</CardGroup>

***

## Alerts

Configure delivery channels, subscribe to alert rule templates, and monitor fired alert events - all programmatically through the Risk API.

<CardGroup cols={2}>
  <Card title="Alert Channels" icon="satellite-dish" href="/risk-api/alerts/list-alert-channels">
    Create and manage Slack, Discord, PagerDuty, email, webhook, and other delivery destinations.
  </Card>

  <Card title="Alert Templates" icon="file-lines" href="/risk-api/alerts/list-alert-templates">
    Browse the alert rule templates available to your workspace.
  </Card>

  <Card title="Alert Rules" icon="bell" href="/risk-api/alerts/list-alert-rules">
    Create, update, and subscribe alert rules from templates to your channels.
  </Card>

  <Card title="Alert Events" icon="triangle-exclamation" href="/risk-api/alerts/list-alert-events">
    List and inspect fired alert events for your workspace.
  </Card>
</CardGroup>

***

## How Risk Scoring Works

Range combines multiple data sources and analytical techniques to produce risk scores. For a deep dive into methodology and how to interpret scores, see [Understanding Risk Scores](/risk-api/product-info/understanding-risk-scores).

<AccordionGroup>
  <Accordion title="Network Proximity Analysis" icon="diagram-project">
    Analyzes the shortest path distance between addresses and known malicious entities across the transaction graph. Malicious actors exhibit clustering behavior and maintain greater distances from regulated exchanges.
  </Accordion>

  <Accordion title="Machine Learning Models" icon="brain">
    Proprietary ML models trained on verified malicious addresses extract behavioral signatures to identify previously undetected threats, expanding coverage beyond traditional threat intelligence.
  </Accordion>

  <Accordion title="Threat Intelligence" icon="shield-exclamation">
    Integrates data from sanctions lists (OFAC, EU, UK, UN), confirmed exploits, scams, phishing attacks, and other verified malicious activity sources.
  </Accordion>

  <Accordion title="Behavioral Analysis" icon="chart-line">
    Examines transaction patterns, timing behaviors, counterparty relationships, and other onchain activity to identify suspicious patterns.
  </Accordion>
</AccordionGroup>

***

## Guides

Step-by-step guides for common integration patterns:

<CardGroup cols={2}>
  <Card title="Compliance Screening Pipeline" icon="gavel" href="/risk-api/guides/compliance-screening-pipeline">
    Build an automated AML/KYC workflow combining address, sanctions, and payment risk checks.
  </Card>

  <Card title="Wallet & dApp Integration" icon="wallet" href="/risk-api/guides/wallet-dapp-integration">
    Add real-time risk protection to Solana wallets and dApps.
  </Card>

  <Card title="Token Due Diligence" icon="magnifying-glass-dollar" href="/risk-api/guides/token-due-diligence">
    Evaluate token safety before listing, trading, or integrating.
  </Card>

  <Card title="Transaction Simulation" icon="flask-vial" href="/risk-api/guides/transaction-simulation">
    Validate transactions before broadcasting with pre-flight simulation.
  </Card>

  <Card title="Onchain Risk Verifier" icon="shield-halved" href="/risk-api/guides/onchain-risk-verifier">
    Verify wallet risk directly inside Solana programs using Switchboard oracles.
  </Card>

  <Card title="Payment Scam Prevention" icon="user-shield" href="/risk-api/guides/payment-scam-prevention">
    Detect address poisoning, new wallet fraud, and social engineering scams.
  </Card>

  <Card title="Privacy Protocol Screening" icon="eye-slash" href="/risk-api/guides/privacy-protocol-screening">
    Screen wallets before deposits to keep tainted funds out of your protocol.
  </Card>
</CardGroup>