https://api.range.org/ai/mcp
Auth: Authorization: Bearer <api_key>
Risk & Sanctions
get_address_risk
get_address_risk
Get the risk score for a blockchain address. Returns a risk level (VERY_LOW to CRITICAL), numeric score (1–10), reasoning, malicious addresses found in the transaction graph, and entity attribution.This is the recommended first call in any investigation.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address. EVM: 0x... (42 chars). Solana: base58 (32–44 chars). Stellar: G... or M... (56 chars). Cosmos: network-prefixed bech32. |
network | string | No | Network ID. Examples: eth, solana, stellar, cosmoshub-4, osmosis-1, dydx-mainnet-1, neutron-1, tron. Auto-detected for EVM/Solana/Stellar if omitted. |
get_transaction_risk
get_transaction_risk
Get the risk score for a transaction by hash. Evaluates all addresses involved and returns the highest risk score found with per-address breakdown.
| Parameter | Type | Required | Description |
|---|---|---|---|
transaction | string | Yes | Transaction hash to assess. |
network | string | No | Network of the transaction. Examples: solana, ethereum, cosmoshub-4. Defaults to solana if omitted. |
get_payment_risk
get_payment_risk
Assess the risk of a cross-chain payment before it’s sent. Analyzes sender/recipient risk, interaction history, address poisoning, malicious connections, and behavioral indicators. Returns
overall_risk_level (LOW/MEDIUM/HIGH/UNKNOWN) with detailed risk factors.| Parameter | Type | Required | Description |
|---|---|---|---|
sender_address | string | Yes | Sender blockchain address. |
recipient_address | string | Yes | Recipient blockchain address. |
amount | number | Yes | Payment amount in USD equivalent (must be > 0). |
sender_network | string | Yes | Sender network. Examples: solana, ethereum, osmosis-1. |
recipient_network | string | Yes | Recipient network. |
sender_token | string | No | Token/denom being sent. Enables token risk check. Example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v |
recipient_token | string | No | Token/denom being received. |
timestamp | string | No | Payment timestamp (ISO 8601). Example: 2025-01-15T10:30:00Z |
get_token_risk
get_token_risk
Get the risk score for a token by its contract address. Returns risk level, score, and reasoning for whether a token is associated with scams, rug pulls, or malicious activity.
| Parameter | Type | Required | Description |
|---|---|---|---|
asset_address | string | Yes | Token contract or mint address. Example: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC on Solana). |
network | string | No | Blockchain network. Currently solana only. Default: solana. |
check_sanctions
check_sanctions
Check if a blockchain address is OFAC sanctioned or blacklisted by stablecoin issuers (Tether USDT, Circle USDC, Coinbase, Paxos). Returns
is_ofac_sanctioned and is_token_blacklisted flags with full event history.| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address. Supports EVM (0x...), Solana (base58), and Tron (T...) formats. |
network | string | No | Filter by network: ethereum, tron, or solana. If omitted, checks all supported networks. |
include_details | boolean | No | Include full blacklist event history and attribution. Default: true. |
Address Intelligence
get_address_info
get_address_info
Get identifying information for a blockchain address: entity name, category, labels, and tags. Identifies whether an address belongs to a known exchange, mixer, protocol, or other entity.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address. |
network | string | Yes | Network ID. Examples: eth, solana, stellar, cosmoshub-4, osmosis-1. |
get_address_connections
get_address_connections
Get counterparty addresses that a given address has interacted with. Essential for building a transaction graph and tracing money flows. Returns connected addresses with labels and transfer statistics.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address to find counterparties for. |
network | string | Yes | Network ID. |
size | integer | No | Number of counterparties to return (1–100). Default: 10. |
start_time | string | No | Filter connections from this time (ISO 8601). |
end_time | string | No | Filter connections until this time (ISO 8601). |
get_address_transactions
get_address_transactions
Get transaction history for a blockchain address. Returns a paginated list with amounts, counterparties, and timestamps.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address. |
network | string | Yes | Network ID. |
limit | integer | No | Transactions to return (1–500). Default: 50. |
offset | integer | No | Transactions to skip for pagination. Default: 0. |
startTime | string | No | Filter from this time (ISO 8601). |
endTime | string | No | Filter until this time (ISO 8601). |
status | string | No | Filter by status: success or failed. |
msgTypes | string | No | Filter by message types (comma-separated). |
get_address_features
get_address_features
Get detailed behavioral statistics for an address: transaction counts, volumes, token interactions, active duration, unique counterparties, and daily activity patterns. Use for behavioral profiling.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address. |
network | string | Yes | Network ID. |
get_address_funded_by
get_address_funded_by
Find the source of funds for an address — which address initially funded it, when, and with what amount. Critical for tracing the origin of funds in an investigation.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address to find the funding source for. |
network | string | Yes | Network ID. |
get_address_balance
get_address_balance
Get current token balances for a blockchain address across all tokens it holds.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address. |
network | string | Yes | Network ID. |
network_type | string | No | Architecture type: evm, solana, cosmos. |
token_contracts | string | No | Comma-separated token contract addresses to filter results. |
get_address_stats
get_address_stats
Get aggregate statistics for an address: total transaction count, total volume, unique counterparties, active days, and more. Useful for quickly profiling activity level.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address. |
network | string | Yes | Network ID. Examples: ethereum, solana, cosmoshub-4. |
get_address_payments
get_address_payments
Get payment history for a blockchain address. Payments are cross-chain and intrachain value transfers. Supports filtering by direction, time range, and counterparty.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address. |
network | string | No | Network ID. |
limit | integer | No | Payments to return (1–500). Default: 50. |
offset | integer | No | Payments to skip for pagination. Default: 0. |
direction | string | No | incoming, outgoing, or both. Default: both. |
start_time | string | No | Filter from this time (ISO 8601). |
end_time | string | No | Filter until this time (ISO 8601). |
receiver | string | No | Filter payments involving this counterparty address. |
receiver_network | string | No | Network of the counterparty address. |
get_payment_by_hash
get_payment_by_hash
Get full details of a specific payment by transaction hash: sender, receiver, amounts, token details, and timestamps.
| Parameter | Type | Required | Description |
|---|---|---|---|
hash | string | Yes | Payment or transaction hash to look up. |
get_address_asset_flow
get_address_asset_flow
Get net inflow and outflow per token for a blockchain address. Shows which tokens an address has been accumulating or distributing over time.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address. |
network | string | Yes | Network ID. Examples: ethereum, solana, cosmoshub-4. |
network_type | string | No | Architecture type: evm, solana, cosmos. |
search_entities
search_entities
Search for known blockchain entities by name or label. Find exchanges (Binance, Coinbase), mixers (Tornado Cash), protocols (Uniswap), and other labeled addresses across chains.
| Parameter | Type | Required | Description |
|---|---|---|---|
search_term | string | Yes | Name or partial name to search for. Examples: "Binance", "Coinbase", "Tornado Cash". |
networks | string | No | Comma-separated networks to filter by. Examples: ethereum,solana. |
Transfers & Transactions
get_transfers
get_transfers
Get token transfer history for a blockchain address. Returns transfers with sender, receiver, token symbol, USD amount, timestamp, and bridge type. Covers cross-chain and intrachain transfers.
| Parameter | Type | Required | Description |
|---|---|---|---|
address | string | Yes | Blockchain address. |
network | string | No | Filter by network. Examples: solana, ethereum, cosmoshub-4. |
size | integer | No | Number of transfers (1–10000). Default: 25. |
cursor | string | No | Pagination cursor from previous response. |
token_symbols | string | No | Comma-separated token symbols. Examples: USDC,DAI,SOL. |
status | string | No | Comma-separated statuses: SUCCEEDED,FAILED. |
min_usd | number | No | Minimum USD amount filter. |
max_usd | number | No | Maximum USD amount filter. |
start_time | string | No | Filter from this time (ISO 8601). |
end_time | string | No | Filter until this time (ISO 8601). |
source_networks | string | No | Comma-separated source networks. |
destination_networks | string | No | Comma-separated destination networks. |
bridges | string | No | Comma-separated bridge types. Examples: ibc,cctp. |
get_transfers_between
get_transfers_between
Get all transfers between two specific blockchain addresses. Useful for investigating direct financial relationships between two wallets, including cross-chain flows.
| Parameter | Type | Required | Description |
|---|---|---|---|
address_a | string | Yes | First blockchain address. |
network_a | string | Yes | Network of address A. Examples: solana, ethereum, osmosis-1. |
address_b | string | Yes | Second blockchain address. |
network_b | string | Yes | Network of address B. |
size | integer | No | Number of transfers (1–100). Default: 10. |
start_time | string | No | Filter from this time (ISO 8601). |
end_time | string | No | Filter until this time (ISO 8601). |
types | string | No | Transfer types (comma-separated). Examples: ibc,cctp. |
cursor | string | No | Pagination cursor. |
get_transaction_details
get_transaction_details
Get full details of a blockchain transaction by network and hash: sender, receiver, amounts, token transfers, fees, and timestamp.
| Parameter | Type | Required | Description |
|---|---|---|---|
network | string | Yes | Blockchain network. Examples: ethereum, solana, cosmoshub-4, osmosis-1, dydx-mainnet-1, neutron-1, stellar. |
hash | string | Yes | Transaction hash to look up. |
Network Analytics
get_whale_moves
get_whale_moves
Get large-value transactions on a blockchain network within a time range, sorted by USD value. Useful for identifying market-moving activity, suspicious large flows, or tracking major players.
| Parameter | Type | Required | Description |
|---|---|---|---|
network | string | Yes | Blockchain network. Examples: ethereum, solana, cosmoshub-4. |
start_time | string | Yes | Start of time range (ISO 8601). Example: 2024-01-01T00:00:00Z. |
end_time | string | Yes | End of time range (ISO 8601). Example: 2024-01-07T23:59:59Z. |
limit | integer | No | Number of results (1–100). Default: 10. |
symbol | string | No | Filter by token symbol. Examples: USDC, ETH, SOL. |
get_network_volume
get_network_volume
Get total transaction volume in USD for a blockchain network within a specific time range.
| Parameter | Type | Required | Description |
|---|---|---|---|
network | string | Yes | Blockchain network. Examples: ethereum, solana, cosmoshub-4. |
start_time | string | Yes | Start of time range (ISO 8601). |
end_time | string | Yes | End of time range (ISO 8601). |