Token Due Diligence

This guide shows the token assessment request and its validation errors, followed by a separate address risk request for a deployer.

Prerequisites: You need a Risk API key and familiarity with the Token Risk Assessment and Address Risk Score endpoints.

When to Use This

Exchanges - Before listing a new token for trading
DEX aggregators - Before including a token in routing
Portfolio trackers - Before displaying a token’s price and details
DeFi protocols - Before accepting a token as collateral or in liquidity pools
Wallet providers - Before showing token metadata to users

Step 1: Assess Token Risk

Submit the token’s mint address as asset_address to GET /v1/risk/token. Both asset_address and network are required; solana is the only supported network.

curl -X GET "https://api.range.org/v1/risk/token?asset_address=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&network=solana" \
  -H "Authorization: Bearer YOUR_API_KEY"

async function assessToken(mintAddress) {
  const params = new URLSearchParams({
    asset_address: mintAddress,
    network: "solana",
  });
  const response = await fetch(
    `https://api.range.org/v1/risk/token?${params}`,
    { headers: { Authorization: `Bearer ${API_KEY}` } }
  );
  return response.json();
}

Unsupported Network

A request to GET /v1/risk/token with asset_address=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v and network=ethereum returns HTTP 400:

{
  "message": [
    "network must be one of the following values: solana"
  ],
  "error": "Bad Request",
  "statusCode": 400
}

Step 2: Check the Deployer Address

If you have identified the token deployer onchain, submit its address to the Address Risk Score endpoint. The request below uses a known high-risk address to demonstrate the request format.

curl -G https://api.range.org/v1/risk/address \
  --data-urlencode "address=42RLPACwZPx3vYYmxSueqsogfynBDqXK298EDsNoyoHi" \
  --data-urlencode "network=solana" \
  -H "Authorization: Bearer YOUR_API_KEY"

What’s Next

Token Risk Assessment

Request parameters, documented response contract, and validation errors.

Understanding Risk Scores

Risk scoring methodology.

Last modified on October 8, 2026

Overview

Guides

Risk Endpoints

Risk v2 Endpoints

Alerts

Simulator

Product Information

When to Use This

Step 1: Assess Token Risk

Unsupported Network

Step 2: Check the Deployer Address

What’s Next

Token Risk Assessment

Understanding Risk Scores

​When to Use This

​Step 1: Assess Token Risk

​Unsupported Network

​Step 2: Check the Deployer Address

​What’s Next

Token Risk Assessment

Understanding Risk Scores

When to Use This

Step 1: Assess Token Risk

Unsupported Network

Step 2: Check the Deployer Address

What’s Next