Skip to main content
GET
/
v1
/
risk
/
sanctions
/
{address}
Check Blacklist & OFAC Sanctions
curl --request GET \
  --url https://api.range.org/v1/risk/sanctions/{address} \
  --header 'X-API-KEY: <api-key>'
{
  "address": "0x1da5821544e25c636c1417ba96ade4cf6d2f9b5a",
  "network": "ethereum",
  "is_token_blacklisted": true,
  "is_ofac_sanctioned": false,
  "checked_at": "2025-11-28T12:53:24Z",
  "token_status_summary": [
    {
      "token": "USDT",
      "issuer": "Tether",
      "is_currently_blacklisted": true,
      "first_blacklisted_date": "2023-12-09",
      "last_event_date": "2023-12-09",
      "last_event_type": "blacklist"
    }
  ],
  "blacklist_event_history": [
    {
      "event_type": "blacklist",
      "token": "USDC",
      "issuer": "Circle",
      "network": "ethereum",
      "date": "2021-04-21",
      "block_number": 12285873,
      "block_timestamp": "2021-04-21 23:04:36",
      "transaction_hash": "<string>",
      "token_account": "<string>"
    }
  ],
  "ofac_info": {
    "is_sanctioned": true,
    "name_tag": "ANDREYEV, Anton Nikolaeyvich",
    "category": "OFAC Sanctioned",
    "entity": "OFAC",
    "address_role": "Individual",
    "first_sanctioned_date": "2020-09-10",
    "sanction_url": "https://ofac.treasury.gov/recent-actions/20200910"
  },
  "attribution": {
    "name": "cbBTC Blacklisted Address (9b5a)",
    "category": "cbBTC Blacklist",
    "role": "Blacklisted Address",
    "entity": "<string>",
    "tags": [
      "BLACKLISTED",
      "STABLECOIN-ISSUER",
      "COMPLIANCE"
    ],
    "malicious": true
  }
}
Check if a blockchain address is blacklisted by token issuers (e.g. Tether, Circle, Coinbase, Paxos) or sanctioned by the US Treasury’s Office of Foreign Assets Control (OFAC).
  • Token Blacklist Events — Real-time monitoring on Ethereum, Tron, and Solana for specific stablecoin issuers.
  • OFAC Sanctions — Sourced from official OFAC reports and covers any network published by OFAC.
Use this endpoint to:
  • Screen addresses before processing transactions
  • Ensure regulatory compliance with OFAC sanctions
  • Detect addresses blocked by stablecoin issuers from using USDT, USDC, CBBTC, or USDP

How It Works

The endpoint performs two types of checks:
  1. Token Blacklist Check — Monitors on-chain blacklist events emitted by stablecoin issuer contracts on Ethereum, Tron, and Solana. When issuers like Tether or Circle blacklist an address, it is blocked from transferring their tokens. The endpoint tracks both blacklist and unblacklist events in real-time to determine the current status.
  2. OFAC Sanctions Check — Cross-references the address against the US Treasury OFAC Specially Designated Nationals (SDN) list. OFAC data is sourced from official published reports and covers any network published by OFAC.
  3. Attribution Data — In addition to real-time blacklist events, the endpoint includes attribution labels that may provide extended context and information beyond what is captured in on-chain events.
Note: The is_token_blacklisted field reflects the current status based on the most recent event. An address that was blacklisted and later unblacklisted will show false. Use blacklist_event_history to view the complete history.

Path Parameters

NameTypeRequiredDescription
addressstringBlockchain address to check

Query Parameters

NameTypeRequiredDefaultDescription
networkstringallFilter blacklist events by network
include_detailsbooleantrueInclude event history, token status breakdown, and attribution
Recommendation: In general, we do not recommend using the network parameter. Omitting it ensures comprehensive screening across all networks for both blacklist events and OFAC sanctions. Only use the network parameter if you have a specific use case, such as:
  • Limiting the search to a specific network for performance reasons
  • Checking an address format that exists on multiple networks (e.g., EVM addresses on Ethereum vs other EVM-compatible chains)

Supported Networks & Tokens (Blacklist Events)

Real-time blacklist event monitoring is available for the following stablecoin issuers:
NetworkUSDT (Tether)USDC (Circle)CBBTC (Coinbase)USDP (Paxos)
Ethereum
Tron
Solana

OFAC Sanctions Coverage

OFAC sanctions data is sourced from official US Treasury reports and covers any network published by OFAC. We do not maintain a separate list of which networks OFAC has released sanctioned addresses for—any address included in official OFAC publications will be reflected in the results.

Response Schema

The response contains the sanctions and blacklist status for the queried address.
{
  "address": "0x1da5821544e25c636c1417ba96ade4cf6d2f9b5a",
  "network": "ethereum",
  "is_token_blacklisted": true,
  "is_ofac_sanctioned": false,
  "checked_at": "2025-12-01T15:55:05.354822Z",
  "token_status_summary": [
    {
      "token": "USDT",
      "issuer": "Tether",
      "is_currently_blacklisted": true,
      "first_blacklisted_date": "2023-12-09",
      "last_event_date": "2023-12-09",
      "last_event_type": "blacklist"
    }
  ],
  "blacklist_event_history": [
    {
      "event_type": "blacklist",
      "token": "USDT",
      "issuer": "Tether",
      "network": "ethereum",
      "date": "2023-12-09",
      "block_number": 18749975,
      "block_timestamp": "2023-12-09 17:51:23",
      "transaction_hash": "15fa3cb1cea19b075d8dafeb3a003061f7191025f9ef9d785374786eb4c9e6a2",
      "token_account": null
    }
  ],
  "ofac_info": null,
  "attribution": {
    "name": "cbBTC Blacklisted Address (9b5a)",
    "category": "cbBTC Blacklist",
    "role": "Blacklisted Address",
    "entity": null,
    "tags": ["BLACKLISTED", "STABLECOIN-ISSUER", "COMPLIANCE"],
    "malicious": true
  }
}

Top-Level Fields

FieldTypeDescription
addressstringThe blockchain address that was checked.
networkstring | nullThe network filter applied. Returns null if all networks were checked.
is_token_blacklistedbooleantrue if the address is currently blacklisted by any stablecoin issuer.
is_ofac_sanctionedbooleantrue if the address appears on the OFAC sanctions list.
checked_atstringTimestamp (ISO 8601) when this check was performed.
token_status_summaryarray | nullBreakdown of blacklist status per token. null when include_details=false or no blacklist data exists.
blacklist_event_historyarray | nullChronological list of on-chain blacklist/unblacklist events. null when include_details=false or no events exist.
ofac_infoobject | nullDetails about the OFAC sanction. null if not sanctioned.
attributionobject | nullAdditional labels and context for the address. null when include_details=false or no attribution exists.

Token Status Summary

Shows the current blacklist status for each token that has flagged this address.
FieldTypeDescription
tokenstringToken symbol: USDT, USDC, CBBTC, or USDP.
issuerstringThe company that issued the token: Tether, Circle, Coinbase, or Paxos.
is_currently_blacklistedbooleantrue if the address is currently blocked from using this token.
first_blacklisted_datestringWhen the address was first blacklisted for this token (YYYY-MM-DD).
last_event_datestringDate of the most recent blacklist or unblacklist event.
last_event_typestringEither blacklist or unblacklist. Determines current status.

Blacklist Event History

A chronological record of all on-chain blacklist and unblacklist events.
FieldTypeDescription
event_typestringblacklist (address blocked) or unblacklist (address unblocked).
tokenstringToken symbol.
issuerstringToken issuer.
networkstringBlockchain where the event occurred: ethereum, tron, or solana.
datestringEvent date (YYYY-MM-DD).
block_numberintegerBlock number of the transaction.
block_timestampstringTimestamp of the block.
transaction_hashstringOn-chain transaction hash for verification.
token_accountstring | nullThe token account address (Solana only). null for EVM chains.

OFAC Info

Details about OFAC sanctions. Only present when the address is sanctioned.
FieldTypeDescription
is_sanctionedbooleanAlways true when this object is present.
name_tagstringName of the sanctioned individual or entity.
categorystringSanction category (e.g., “OFAC Sanctioned”).
entitystringSanctioning body (e.g., “OFAC”).
address_rolestringIndividual or Entity.
first_sanctioned_datestringDate when the address was first sanctioned (YYYY-MM-DD).
sanction_urlstringLink to the official OFAC announcement.

Attribution

Additional context and labels for the address, which may include information beyond on-chain events.
FieldTypeDescription
namestringHuman-readable name or label for the address.
categorystringCategory (e.g., “USDT Blacklist”, “Multi-Provider Blacklist”).
rolestringRole description (e.g., “Blacklisted Address”).
entitystring | nullAssociated entity, if known.
tagsarray | nullList of tags (e.g., ["BLACKLISTED", "COMPLIANCE"]).
maliciousbooleantrue if the address is considered malicious.

Examples

Multi-Provider Blacklisted Address

An address blacklisted by multiple stablecoin issuers (USDT, USDC, USDP, CBBTC) on Ethereum.
curl -G "https://api.range.org/v1/risk/sanctions/0x1da5821544e25c636c1417ba96ade4cf6d2f9b5a" \
  -H "X-API-KEY: your_api_key_here"
{
  "address": "0x1da5821544e25c636c1417ba96ade4cf6d2f9b5a",
  "network": null,
  "is_token_blacklisted": true,
  "is_ofac_sanctioned": false,
  "checked_at": "2025-12-01T16:05:38.977186Z",
  "token_status_summary": [
    {
      "token": "CBBTC",
      "issuer": "Coinbase",
      "is_currently_blacklisted": true,
      "first_blacklisted_date": "2024-09-09",
      "last_event_date": "2025-09-11",
      "last_event_type": "blacklist"
    },
    {
      "token": "USDC",
      "issuer": "Circle",
      "is_currently_blacklisted": true,
      "first_blacklisted_date": "2021-04-21",
      "last_event_date": "2021-04-21",
      "last_event_type": "blacklist"
    },
    {
      "token": "USDP",
      "issuer": "Paxos",
      "is_currently_blacklisted": true,
      "first_blacklisted_date": "2024-01-03",
      "last_event_date": "2024-01-03",
      "last_event_type": "blacklist"
    },
    {
      "token": "USDT",
      "issuer": "Tether",
      "is_currently_blacklisted": true,
      "first_blacklisted_date": "2023-12-09",
      "last_event_date": "2023-12-09",
      "last_event_type": "blacklist"
    }
  ],
  "blacklist_event_history": [
    {
      "event_type": "blacklist",
      "token": "USDC",
      "issuer": "Circle",
      "network": "ethereum",
      "date": "2021-04-21",
      "block_number": 12285873,
      "block_timestamp": "2021-04-21 23:04:36",
      "transaction_hash": "72959622df120df8cfe27fa371c5b82542cda695d09568975259c0cf70430bf9",
      "token_account": null
    },
    {
      "event_type": "blacklist",
      "token": "USDT",
      "issuer": "Tether",
      "network": "ethereum",
      "date": "2023-12-09",
      "block_number": 18749975,
      "block_timestamp": "2023-12-09 17:51:23",
      "transaction_hash": "15fa3cb1cea19b075d8dafeb3a003061f7191025f9ef9d785374786eb4c9e6a2",
      "token_account": null
    },
    {
      "event_type": "blacklist",
      "token": "USDP",
      "issuer": "Paxos",
      "network": "ethereum",
      "date": "2024-01-03",
      "block_number": 18928262,
      "block_timestamp": "2024-01-03 18:16:59",
      "transaction_hash": "087498e654622570d0c5f8639c1e02db28ea8ac647c31a470f89412387cd0ab4",
      "token_account": null
    },
    {
      "event_type": "blacklist",
      "token": "CBBTC",
      "issuer": "Coinbase",
      "network": "ethereum",
      "date": "2024-09-09",
      "block_number": 20714651,
      "block_timestamp": "2024-09-09 19:49:23",
      "transaction_hash": "b051ee06b9fc656c0a2c8009d2a553a2ba8a09dbaf0eff35c2899197815306f8",
      "token_account": null
    }
  ],
  "ofac_info": null,
  "attribution": {
    "name": "Multi-Provider Blacklisted Address (9b5a)",
    "category": "Multi-Provider Blacklist",
    "role": "Blacklisted Address",
    "entity": null,
    "tags": ["BLACKLISTED", "STABLECOIN-ISSUER", "COMPLIANCE"],
    "malicious": true
  }
}

OFAC Sanctioned and Token Blacklisted

An address that is both OFAC sanctioned and token blacklisted by multiple providers.
curl -G "https://api.range.org/v1/risk/sanctions/0x8576acc5c05d6ce88f4e49bf65bdf0c62f91353c" \
  -H "X-API-KEY: your_api_key_here"
{
  "address": "0x8576acc5c05d6ce88f4e49bf65bdf0c62f91353c",
  "network": null,
  "is_token_blacklisted": true,
  "is_ofac_sanctioned": true,
  "checked_at": "2025-12-01T16:06:07.870004Z",
  "token_status_summary": [
    {
      "token": "USDC",
      "issuer": "Circle",
      "is_currently_blacklisted": true,
      "first_blacklisted_date": "2022-03-29",
      "last_event_date": "2022-03-29",
      "last_event_type": "blacklist"
    },
    {
      "token": "USDT",
      "issuer": "Tether",
      "is_currently_blacklisted": true,
      "first_blacklisted_date": "2023-12-09",
      "last_event_date": "2023-12-09",
      "last_event_type": "blacklist"
    }
  ],
  "blacklist_event_history": [
    {
      "event_type": "blacklist",
      "token": "USDC",
      "issuer": "Circle",
      "network": "ethereum",
      "date": "2022-03-29",
      "block_number": 14481178,
      "block_timestamp": "2022-03-29 14:49:03",
      "transaction_hash": "5906c3dac2d75f141b72baa61842a9881e9d31ee36f761ffc7059ffc86c7e452",
      "token_account": null
    },
    {
      "event_type": "blacklist",
      "token": "USDT",
      "issuer": "Tether",
      "network": "ethereum",
      "date": "2023-12-09",
      "block_number": 18750100,
      "block_timestamp": "2023-12-09 18:17:11",
      "transaction_hash": "dbd24a66f187242bf3a8f8ce4a50a4b9143889dc988c7113d2e1069165332534",
      "token_account": null
    }
  ],
  "ofac_info": {
    "is_sanctioned": true,
    "name_tag": "ANDREYEV, Anton Nikolaeyvich",
    "category": "OFAC Sanctioned",
    "entity": "OFAC",
    "address_role": "Individual",
    "first_sanctioned_date": "2020-09-10",
    "sanction_url": "https://ofac.treasury.gov/recent-actions/20200910"
  },
  "attribution": {
    "name": "USDP Blacklisted Address (353c)",
    "category": "Multi-Provider Blacklist",
    "role": "Blacklisted Address",
    "entity": "OFAC",
    "tags": ["BLACKLISTED", "STABLECOIN-ISSUER", "COMPLIANCE"],
    "malicious": true
  }
}

OFAC Sanctioned Only

A Tron address that is OFAC sanctioned but not token blacklisted.
curl -G "https://api.range.org/v1/risk/sanctions/TMGLqRQ4twjW8wJhVH1mQR7nUThpGHUsN3" \
  -H "X-API-KEY: your_api_key_here"
{
  "address": "TMGLqRQ4twjW8wJhVH1mQR7nUThpGHUsN3",
  "network": null,
  "is_token_blacklisted": false,
  "is_ofac_sanctioned": true,
  "checked_at": "2025-12-01T16:06:15.993588Z",
  "token_status_summary": null,
  "blacklist_event_history": null,
  "ofac_info": {
    "is_sanctioned": true,
    "name_tag": "GAMBASHIDZE, Ilya Andreevich",
    "category": "OFAC Sanctioned",
    "entity": "OFAC",
    "address_role": "Individual",
    "first_sanctioned_date": "2024-03-20",
    "sanction_url": "https://ofac.treasury.gov/recent-actions/20240703"
  },
  "attribution": {
    "name": "GAMBASHIDZE, Ilya Andreevich",
    "category": "OFAC Sanctioned",
    "role": "Individual",
    "entity": "OFAC",
    "tags": null,
    "malicious": true
  }
}

Solana Blacklisted Address

A Solana address blacklisted by Tether. Note the token_account field which is specific to Solana.
curl -G "https://api.range.org/v1/risk/sanctions/6sEk1enayZBGFyNvvJMTP7qs5S3uC7KLrQWaEk38hSHH" \
  -H "X-API-KEY: your_api_key_here"
{
  "address": "6sEk1enayZBGFyNvvJMTP7qs5S3uC7KLrQWaEk38hSHH",
  "network": null,
  "is_token_blacklisted": true,
  "is_ofac_sanctioned": false,
  "checked_at": "2025-12-01T16:06:27.732211Z",
  "token_status_summary": [
    {
      "token": "USDT",
      "issuer": "Tether",
      "is_currently_blacklisted": true,
      "first_blacklisted_date": "2022-11-12",
      "last_event_date": "2022-11-12",
      "last_event_type": "blacklist"
    }
  ],
  "blacklist_event_history": [
    {
      "event_type": "blacklist",
      "token": "USDT",
      "issuer": "Tether",
      "network": "solana",
      "date": "2022-11-12",
      "block_number": 160590544,
      "block_timestamp": "2022-11-12 07:26:36",
      "transaction_hash": "5vQBXFxiSgufuLUpm6ugfxynd43P8tAa94SDeqtFvvvqzXa1DW8us4GRM3MS4QFnvcSHqD9DNPihuqnYJ9GbY7Qh",
      "token_account": "EdP6JNB26MrKzfsieCPz593VUgrDrpziQKstzCAFvNBP"
    }
  ],
  "ofac_info": null,
  "attribution": {
    "name": "",
    "category": "",
    "role": "",
    "entity": null,
    "tags": ["BLACKLISTED", "STABLECOIN-ISSUER", "COMPLIANCE"],
    "malicious": true
  }
}

Previously Blacklisted (Now Unblacklisted)

An address that was blacklisted then unblacklisted. is_token_blacklisted is false but the full history is preserved.
curl -G "https://api.range.org/v1/risk/sanctions/0x9faf5515f177f3a8a845d48c19032b33cc54c09c" \
  -H "X-API-KEY: your_api_key_here"
{
  "address": "0x9faf5515f177f3a8a845d48c19032b33cc54c09c",
  "network": null,
  "is_token_blacklisted": false,
  "is_ofac_sanctioned": false,
  "checked_at": "2025-12-01T16:06:37.232941Z",
  "token_status_summary": [
    {
      "token": "USDT",
      "issuer": "Tether",
      "is_currently_blacklisted": false,
      "first_blacklisted_date": "2017-11-28",
      "last_event_date": "2017-11-28",
      "last_event_type": "unblacklist"
    }
  ],
  "blacklist_event_history": [
    {
      "event_type": "blacklist",
      "token": "USDT",
      "issuer": "Tether",
      "network": "ethereum",
      "date": "2017-11-28",
      "block_number": 4638805,
      "block_timestamp": "2017-11-28 17:39:10",
      "transaction_hash": "17ce88e3e2417f6c13db93f619423cc4c5f51e89660587631dc34c823fac54a8",
      "token_account": null
    },
    {
      "event_type": "unblacklist",
      "token": "USDT",
      "issuer": "Tether",
      "network": "ethereum",
      "date": "2017-11-28",
      "block_number": 4638882,
      "block_timestamp": "2017-11-28 17:59:39",
      "transaction_hash": "520a66112467b4b79016c2a62658b56e8f78049bae8bf6f4ce4bf39ec2d75ba8",
      "token_account": null
    }
  ],
  "ofac_info": null,
  "attribution": {
    "name": "USDT Unblacklisted Address (0x9fa)",
    "category": "USDT Blacklist",
    "role": "Unblacklisted Address",
    "entity": null,
    "tags": ["UNBLACKLISTED", "STABLECOIN-ISSUER", "COMPLIANCE"],
    "malicious": true
  }
}

Clean Address

An address with no sanctions or blacklist history.
curl -G "https://api.range.org/v1/risk/sanctions/0x1234567890abcdef1234567890abcdef12345678" \
  -H "X-API-KEY: your_api_key_here"
{
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "network": null,
  "is_token_blacklisted": false,
  "is_ofac_sanctioned": false,
  "checked_at": "2025-12-01T16:07:06.387337Z",
  "token_status_summary": null,
  "blacklist_event_history": null,
  "ofac_info": null,
  "attribution": null
}

Minimal Response

Use include_details=false for high-volume screening when you only need pass/fail results.
curl -G "https://api.range.org/v1/risk/sanctions/0x1da5821544e25c636c1417ba96ade4cf6d2f9b5a" \
  --data-urlencode "include_details=false" \
  -H "X-API-KEY: your_api_key_here"
{
  "address": "0x1da5821544e25c636c1417ba96ade4cf6d2f9b5a",
  "network": null,
  "is_token_blacklisted": true,
  "is_ofac_sanctioned": false,
  "checked_at": "2025-12-01T16:07:27.972840Z",
  "token_status_summary": null,
  "blacklist_event_history": null,
  "ofac_info": null,
  "attribution": null
}

Errors

HTTP CodeCauseRecommended Action
400Invalid address formatValidate the address format before making the request
429Rate limit exceededImplement exponential backoff and retry
5xxInternal server errorRetry after a short delay; contact support if persists

Best Practices

  • Check both flags — Always check both is_token_blacklisted and is_ofac_sanctioned for comprehensive compliance screening.
  • Real-time checks — Blacklist status can change; avoid caching for high-risk use cases.
  • Use full details — Keep include_details=true (default) when you need event history.
  • Addresses are case-insensitive — Both 0x1DA5... and 0x1da5... return identical results.

Use Cases

  • Pre-transaction screening — Check counterparty addresses before processing payments or transfers.
  • Exchange compliance — Screen addresses during deposit/withdrawal flows.
  • DeFi integration — Add sanctions checks to smart contract interactions or front-ends.
  • Audit trails — Generate compliance reports with full event history.

Authorizations

X-API-KEY
string
header
required

Authorization method required to allow user to access the api endpoints.

Path Parameters

address
string
required

Blockchain address to check (EVM, Solana, or Tron format)

Example:

"0x1da5821544e25c636c1417ba96ade4cf6d2f9b5a"

Query Parameters

network
enum<string>

Filter by blockchain network. If omitted, checks all networks.

Available options:
ethereum,
tron,
solana
include_details
boolean
default:true

Include detailed event history and attribution (default: true)

Response

200 - application/json

Blacklist and sanctions check result

address
string
required

The queried blockchain address

Example:

"0x1da5821544e25c636c1417ba96ade4cf6d2f9b5a"

network
string | null
required

Network filter applied (null if all networks checked)

Example:

"ethereum"

is_token_blacklisted
boolean
required

Whether address is currently blacklisted by any token issuer

Example:

true

is_ofac_sanctioned
boolean
required

Whether address is on OFAC sanctions list

Example:

false

checked_at
string
required

UTC timestamp when check was performed (ISO 8601)

Example:

"2025-11-28T12:53:24Z"

token_status_summary
object[] | null

Current blacklist status per token (when include_details=true)

blacklist_event_history
object[] | null

Chronological list of blacklist/unblacklist events (when include_details=true)

ofac_info
object

OFAC sanction details (when sanctioned)

attribution
object

Known attribution/label for the address