Screen a counterparty wallet address before transacting with it
Screens a wallet address across EVM, Solana, TON and Bitcoin for known scam, drainer, phishing, dark web and sanctions associations, and returns a risk level with the specific flags behind it. The chain is detected from the address format, so no chain parameter is needed.
This is the key-authenticated twin of /v1/payg/wallet-risk, added for callers who hold an API key rather than paying per call over x402. Same handler, same price, same response.
Read degraded before you read risk_flags. When degraded is true an upstream source did not answer, so an empty flag list means the check did not complete rather than that the address is clean. Treat that as no verdict, never as a pass.
Billing. $0.05 per successful call. Failed calls are never billed. Charged against prepaid credits when the balance covers it, otherwise metered to your card. Threat Intelligence subscribers and AWS Marketplace bundle customers call this at no extra charge.
Request
- Base URL: https://api.relayshield.net
- URL: https://api.relayshield.net/v1/metered/wallet-risk
- Auth: one of:
- API key in header X-RS-API-KEY
- HTTP bearer
Request body
Example request
{
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}Response
Success. ok is true and data holds the result.
Changes
No recorded changes to this operation across all 1 revision of this API.