Crypto

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.

post/v1/metered/wallet-risk

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

addressstring required

Wallet address to screen. EVM (0x...), Solana, TON (EQ.../UQ...) or Bitcoin. The chain is inferred from the format.

Example request

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}

Response

Success. ok is true and data holds the result.

oktrue required

Changes

No recorded changes to this operation across all 1 revision of this API.