{"uid":"cap_RmUErus5WYAv3M_bAdYjq","slug":"spendthebits-address-risk-screening-b7a3e8b8","name":"SpendTheBits Address Risk Screening","description":"Sanctions/scam screening verdict for one address (?address=, optional ?network=mainnet|testnet) plus whether it is a verified token contract STB recognises. The same screen that gates every send in the STB wallet.","url":"https://x402.spendthebits.com/@superappstb/address-risk/?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","maxLength":96,"minLength":20,"description":"Address to screen: an EVM 0x address, or another chain's address (Solana, TRON, XRPL, Bitcoin ...)"},"network":{"enum":["mainnet","testnet"],"type":"string","description":"mainnet (default) or testnet"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["address","network","family","verdict","screening","token_contract","evidence"],"properties":{"docs":{"type":"string"},"as_of":{"type":"string"},"family":{"enum":["evm","other"],"type":"string"},"address":{"type":"string"},"network":{"enum":["mainnet","testnet"],"type":"string"},"verdict":{"enum":["ok","warn","block"],"type":"string","description":"block = listed (sanctions/ransomware); warn = publicly reported scam"},"evidence":{"type":"array","items":{"type":"string"}},"screening":{"type":"object","required":["listed"],"properties":{"listed":{"type":"boolean"},"source":{"type":["string","null"]},"category":{"type":["string","null"]}}},"attribution":{"description":"Credit the data source's licence asks for, when one matched"},"token_contract":{"type":"object","required":["known"],"properties":{"chain":{"type":"string"},"known":{"type":"boolean"},"symbol":{"type":"string"}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_P5clOmHMO92opjhnHPmeR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Screens a blockchain address for sanctions, scam listings, and known token contract status, returning an ok/warn/block verdict.","exampleAgentPrompt":"Before I send funds, can you screen the Ethereum address 0xAbC123...def456 on mainnet to check if it's sanctioned, flagged as a scam, or a known token contract?","exampleUseCases":[{"title":"Pre-send wallet safety check","prompt":"I'm about to send 500 USDC to 0x4e9ce36E442e55EcD9025B9a6E0D88485d628A67 on mainnet — can you screen it first and tell me if it's safe or flagged?"},{"title":"Scam address investigation","prompt":"Someone just sent me a payment request from TRX address TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE — can you check if it's been reported as a scam?"},{"title":"Token contract verification","prompt":"I found a token at address 0xdAC17F958D2ee523a2206206994597C13D831ec7 on mainnet — is this a legitimate recognized token contract or something suspicious?"}],"resultDescription":"Returns a JSON object with: the queried address and network, address family (evm/other), a verdict field (ok, warn, or block), a screening object with a listed boolean plus source and category if flagged, a token_contract object indicating if the address is a known token with its symbol and chain, an evidence array with supporting details, attribution for data sources, and an as_of timestamp.","failureModes":["Missing required address parameter returns an error","Address shorter than 20 or longer than 96 characters is rejected by schema validation","Unknown or malformed address format may return a non-evm family with limited screening data","Testnet addresses screened on mainnet (or vice versa) may return no results or misleading verdicts","Network outage or upstream sanctions database unavailability may cause timeouts","Payment of $0.003 USDC via x402 required; unpaid requests are rejected with 402"],"whenToPreferThis":"Use this endpoint when you need a real-time, per-address sanctions and scam verdict gating a financial transaction — especially within the SpendTheBits wallet ecosystem. Prefer this over generic risk APIs when you need multi-chain support (EVM, Solana, TRON, XRPL, Bitcoin) in a single call, or when you also need to verify whether an address is a recognized token contract. It is the same screen used natively by the STB wallet before every send.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:30:25.086Z","isFirstParty":false,"canonicalSlug":"spendthebits-address-risk-screening-b7a3e8b8"}