# Webacy Docs

- [Introduction](https://docs.webacy.com/introduction.md): Build with Webacy's real-time onchain risk intelligence for wallets, tokens, stablecoins, smart contracts, and vaults across all major supported blockchains.
- [Fundamentals](https://docs.webacy.com/fundamentals.md): Learn how the Webacy Risk Framework calculates onchain risk scores from data ingestion through entity typing, risk factor analysis, and rating generation.
- [Entity Types](https://docs.webacy.com/entity-types.md): Reference for Webacy entity types including wallets, transactions, tokens, stablecoins, smart contracts, and vaults, each with its own risk model and signals.
- [Risk Factors](https://docs.webacy.com/risk-factors.md): Reference for the hundreds of independent risk factors Webacy combines into every score, spanning security, financial, operational, and compliance signals.
- [Risk Scores and Ratings](https://docs.webacy.com/risk-scores-and-ratings.md): Compare Webacy 0-100 numerical risk scores and A+ to F letter-grade ratings, and learn when to use each for automated policies or human-facing interpretation.
- [Severity Levels](https://docs.webacy.com/severity-levels.md): Reference for Webacy severity levels that translate numerical risk scores into low, medium, high, and critical actions for policies, alerts, and workflows.
- [Data Quality and Confidence](https://docs.webacy.com/data-quality-and-confidence.md): Understand how Webacy validates risk data across onchain sources and third-party providers, minimizes false positives, and produces explainable risk scores.
- [Historical Analysis](https://docs.webacy.com/historical-analysis.md): How Webacy mines historical onchain data on exploits, depegs, freezes, and governance failures to train risk detection and surface recurring attack patterns.
- [Wallet Screening](https://docs.webacy.com/wallet-screening.md): Screen wallets with Webacy for sanctions exposure, counterparty risk, fund-flow patterns, malicious behavior, and reputation signals across supported chains.
- [Transaction Monitoring](https://docs.webacy.com/transaction-monitoring.md): Every blockchain transaction tells a story. Transaction Monitoring uncovers the risk behind every movement of value, before and after it happens.
- [Smart Contract Analysis](https://docs.webacy.com/smart-contract-analysis.md): Analyze smart contracts with Webacy: source verification, bytecode inspection, proxy and admin key detection, honeypot checks, and exploit pattern matching.
- [Trading Intelligence](https://docs.webacy.com/trading-intelligence.md): Evaluate token markets with Webacy Trading Intelligence: holder analysis, distribution and unlock schedules, liquidity depth, and insider or sniper behavior.
- [Asset Integrity](https://docs.webacy.com/asset-integrity.md): Asset Integrity measures the conditions that influence token and stablecoin price, covering supply, liquidity, holder concentration, and peg stability signals.
- [Compliance and AML](https://docs.webacy.com/compliance.md): Run onchain compliance and AML checks with Webacy: sanctions screening, counterparty exposure, fund-flow tracing, and explainable wallet risk scoring.
- [Address Poisoning Detection](https://docs.webacy.com/address-poisoning.md): Detect and classify address poisoning attacks with Webacy's onchain analysis of lookalike addresses, transaction patterns, and attacker infrastructure.
- [Supported Blockchains](https://docs.webacy.com/supported-blockchains.md): Blockchain risk is chain-agnostic. Webacy is designed to deliver consistent, explainable risk intelligence across every supported ecosystem.
- [Stellar Support](https://docs.webacy.com/stellar.md): Stellar blockchain risk analysis with Webacy API including address scans, token risk checks, sanction screening, and supported endpoints overview.
- [Hedera Support](https://docs.webacy.com/hedera.md): Explore Hedera blockchain risk analysis with Token Service (HTS) checks, admin key detection, custom fees, and account status monitoring via Webacy.
- [Data Freshness](https://docs.webacy.com/data-freshness.md): Learn how Webacy delivers real-time risk intelligence with per-block updates, streaming ingestion, and continuous re-scoring of wallets, tokens, and vaults.
- [Pricing](https://docs.webacy.com/pricing.md): Compare Webacy API developer plans for wallet lookups, risk screening, fund flow tracing, simulation, and entity detection.
- [Getting Started](https://docs.webacy.com/getting-started.md): Start building with Webacy: create an API key, authenticate requests, choose the right entity endpoint, and set up webhooks for real-time risk monitoring.
- [Get an API Key](https://docs.webacy.com/get-an-api-key.md): Create a Webacy Developer Portal account, generate an API key, and rotate or revoke keys using the interim workflow until self-service ships.
- [Authentication](https://docs.webacy.com/authentication.md): Get started with the Webacy API in minutes — create an API key, authenticate, and run your first wallet, token, or contract risk-analysis request.
- [Rate Limits](https://docs.webacy.com/rate-limits.md): Webacy API rate limits by plan tier: Demo allows 500 requests per month at 1 rps with burst 2, plus 429 handling and endpoint access rules.
- [Errors](https://docs.webacy.com/errors.md): Reference for Webacy API errors, including HTTP status codes, standardized error response fields, and troubleshooting steps for common failure cases.
- [Example Addresses](https://docs.webacy.com/example-addresses.md): Test Webacy endpoints with curated example addresses for sanctioned wallets, risky contracts, and clean accounts to validate your integration logic.
- [API Considerations](https://docs.webacy.com/essentials/considerations.md): Learn how Webacy API caching, scan latency, error handling, and best practices work so you integrate blockchain risk analysis reliably at scale.
- [x402 Payments](https://docs.webacy.com/x402-payments.md): Call the Webacy API without an API key by paying per request in USDC on Base using the x402 protocol, with prepaid credit tokens for follow-up requests.
- [Build with AI](https://docs.webacy.com/integrations/build-with-ai.md): Build with Webacy using AI tools: llms.txt files, OpenAPI spec, Cursor docs source, Claude Code CLAUDE.md context, and per-page Open in Claude shortcuts.
- [Webacy API reference for AI coding agents](https://docs.webacy.com/integrations/agent-reference.md): Self-contained Webacy API reference for AI coding agents like Claude Code, Cursor, and Copilot, with endpoints, parameters, and ready-to-paste examples.
- [Webacy MCP Server for AI Coding Agents](https://docs.webacy.com/integrations/mcp-server.md): Connect Claude Code, Cursor, or Codex CLI to the Webacy MCP server to query blockchain risk data on addresses and tokens from your editor.
- [SDK Introduction](https://docs.webacy.com/sdk/introduction.md): Get started with the Webacy TypeScript SDK for blockchain risk analysis with type-safe clients, multi-chain support, retries, and structured error handling.
- [Webacy SDK Use Cases](https://docs.webacy.com/sdk/use-cases.md): See how wallets, DeFi protocols, exchanges, and compliance teams use the Webacy SDK for pre-transaction scanning, token screening, and rug pull detection.
- [Installation](https://docs.webacy.com/sdk/installation.md): Install the Webacy TypeScript SDK with npm, pnpm, yarn, or bun and configure ThreatClient or TradingClient with API keys, default chains, and debug logging.
- [Webacy SDK CLI Reference](https://docs.webacy.com/sdk/cli.md): Use the webacy CLI to call every ThreatClient and TradingClient method from your terminal, pipe JSON into scripts, and automate security checks in CI.
- [ThreatClient](https://docs.webacy.com/sdk/threat-client.md): Reference for ThreatClient methods covering address risk, sanctions screening, contract analysis, URL safety, vault scoring, and transaction simulation.
- [TradingClient](https://docs.webacy.com/sdk/trading-client.md): Use TradingClient methods for token holder distribution, sniper and bundler detection, trending pools, OHLCV charts, and Solana trading-lite analysis.
- [Supported Chains in the Webacy SDK](https://docs.webacy.com/sdk/chains.md): Reference for the Chain enum and supported blockchain networks in the Webacy SDK, including EVM, Solana, TON, Bitcoin, and address validation helpers.
- [Error Handling](https://docs.webacy.com/sdk/error-handling.md): Catch typed SDK errors like ValidationError, RateLimitError, and AuthenticationError with recovery hints, retry logic, and structured logging for production.
- [Webhook Alerts: real-time depeg and risk event delivery](https://docs.webacy.com/essentials/webhooks.md): Subscribe to Webacy webhooks for DEPEG_TIER_CHANGE stablecoin and RWA alerts with HMAC-signed delivery, tier and chain filters, and automatic retries.
- [Webhook Alerts integration tutorial](https://docs.webacy.com/essentials/webhooks-tutorial.md): Follow this end-to-end Webacy webhooks tutorial to stand up a signed DEPEG_TIER_CHANGE receiver, verify HMAC signatures, and subscribe by tier or chain.
- [Vault Risk Integration Guide](https://docs.webacy.com/digital-assets/vault-risk.md): Integrate Webacy vault risk ratings for ERC-4626 vaults with composite letter grades, per-category contributors, and continuous monitoring on nine chains.
- [Vault Risk Intelligence](https://docs.webacy.com/vault-risk-intelligence.md): Continuous DeFi vault risk scoring across six chains — composite scores, listing verdicts, real-time withdrawal signals, and 90-day history.
- [Vault Ratings](https://docs.webacy.com/vault-ratings.md): How Webacy scores DeFi vaults on a 0–100 composite risk scale from weighted sub-scores, additive penalties, and hard state floors.
- [Screen and Monitor Vault Risk](https://docs.webacy.com/digital-assets/vault-risk-screening.md): Screen ERC-4626 vaults before listing and monitor governance, liquidity, and code risk continuously across six EVM chains with sub-500ms verdicts.
- [Vault Incidents](https://docs.webacy.com/vault-incidents.md): Curated timeline of DeFi yield-vault exploits, depegs, and governance failures, with event categories and root-cause analysis for ERC-4626 stablecoin vaults.
- [Supply Flows](https://docs.webacy.com/supply-flows.md): Real-time stablecoin issuance and redemption tracking across 139+ tokens — see whether capital is flowing into or out of the stablecoin system.
- [Backing Map](https://docs.webacy.com/backing-map.md): Collateral and reserve composition of major stablecoins — see what assets actually back each dollar of supply across USDC, USDT, DAI, and other peg tokens.
- [Yield Scores: Safety-Weighted Ranking of Stablecoin Pools](https://docs.webacy.com/yield-scores.md): How Webacy ranks DeFi stablecoin yield pools with a safety-weighted rank score based on the risk rating of each pool's riskiest constituent.
- [Holder Concentration Index (HCI) Methodology](https://docs.webacy.com/holder-concentration.md): How Webacy measures, classifies, and uses on-chain holder concentration data for stablecoins and RWA tokens to assess structural depeg and centralization risk.
- [Stablecoin Graveyard: Defunct and Depegged Tokens](https://docs.webacy.com/graveyard.md): Registry of defunct, depegged, and discontinued stablecoins, excluded from live metrics but kept for historical research and depeg pattern recognition.
- [Depeg Monitor Scoring Methodology and Signals](https://docs.webacy.com/scoring-methodology.md): The full depeg risk scoring methodology — 16 weighted signals, tiers, velocity boost, and hysteresis behind each stablecoin's 0–100 score.
- [Risk Rating](https://docs.webacy.com/safety-grade.md): How Webacy maps a stablecoin's 0–100 risk score to an A+ to F letter grade on the standard 11-band scale — lower risk earns a better grade.
- [Peg Canary Score (PCS)](https://docs.webacy.com/pcs.md): Peg Canary Score (PCS) is a forward-looking stablecoin stress indicator that surfaces pre-depeg conditions 6–48 hours before price breaks.
- [Depeg Monitor data dictionary](https://docs.webacy.com/data-dictionary.md): Definitions for every column and filter on the Depeg Monitor overview table — risk score, grade, peg deviation, supply flow, holder concentration, and more.
- [Scoring Model & Methodology](https://docs.webacy.com/scoring-model-and-methodology.md): How Webacy calculates depeg risk scores for each stablecoin — weighted signals, risk tiers, threshold logic, and the 0–100 scoring model behind every grade.
- [Definitions](https://docs.webacy.com/glossary/definitions.md): Plain-language definitions of key blockchain, DeFi, and crypto risk terms used across the Webacy documentation, from address clustering to wash trading.
- [Label Types](https://docs.webacy.com/glossary/label-types.md): Reference for Webacy address label types including cex, dex, defi, nft, operator, and chadmin classifications used to identify wallet purpose.
- [Risk Assessment Modules](https://docs.webacy.com/glossary/modules.md): Choose Webacy risk assessment modules like Security Essentials, Token Security, Contract Analysis, and Market Data to focus your blockchain scans.
- [Webacy Data Sources for Risk Ratings and Intelligence](https://docs.webacy.com/data-sources.md): How Webacy combines real-time on-chain analysis with off-chain context to power risk ratings for wallets, tokens, contracts, vaults, and stablecoins.
- [What Technology Does Webacy Build In-House?](https://docs.webacy.com/what-technology-does-webacy-build-in-house.md): What Webacy builds in-house — risk engine, scoring models, contract and transaction analysis — versus where third-party blockchain infrastructure is used.
- [Threats and Labels](https://docs.webacy.com/glossary/threats-and-labels.md): Overview of Webacy threat categories and risk labels covering rugpulls, honeypots, reentrancy, drainers, and other smart contract security issues.
- [Hidden Mint](https://docs.webacy.com/glossary/hidden-mint.md): Spot hidden mint functions that let bad actors create unlimited tokens, crash prices, and devastate ERC-20 token holders through inflation attacks.
- [Hidden Balance Update](https://docs.webacy.com/glossary/hidden-balance-update.md): Detect hidden balance update vulnerabilities that let malicious smart contracts secretly alter ERC-20 token balances without authorization or events.
- [Reentrancy](https://docs.webacy.com/glossary/reentrancy.md): Learn how reentrancy attacks like the DAO hack exploit external calls to drain smart contracts, and how to detect and prevent these vulnerabilities.
- [Unchecked Low Level Calls](https://docs.webacy.com/glossary/unchecked-calls.md): Detect unchecked low-level call vulnerabilities in Solidity where ignored return values cause silent failures, lost funds, and corrupted contract state.
- [Malicious Bool Checks](https://docs.webacy.com/glossary/malicious-bool-checks.md): Detect malicious boolean checks in smart contracts that let owners freeze trading, block transfers, or trigger rug pulls through toggle switches.
- [Malicious Burn](https://docs.webacy.com/glossary/malicious-burn.md): Detect malicious burn functions that let attackers destroy tokens from any wallet or liquidity pool without consent, enabling theft and price manipulation.
- [Malicious External Call](https://docs.webacy.com/glossary/malicious-external-call.md): Detect malicious external calls in smart contracts, including arbitrary calls and unprotected delegatecall patterns that can drain funds or hijack state.
- [Digital Signature Module](https://docs.webacy.com/glossary/digital-signature-module.md): Learn how the Digital Signature Module detects signature replay attacks, forgery, and unauthorized access vulnerabilities in smart contracts.
- [Honeypots](https://docs.webacy.com/glossary/honeypots.md): Learn how honeypot tokens let you buy but block sales through blacklists, extreme sell taxes, and other traps, and how to detect them before trading.
- [Rug Pulls](https://docs.webacy.com/glossary/rug-pulls.md): Learn how rug pulls drain liquidity pools to crash token prices, the difference between hard and soft rugs, and how to spot scam projects early.
- [Fake Tokens](https://docs.webacy.com/glossary/fake-tokens.md): Spot fake tokens and impersonator scams that copy legitimate project names and symbols on DEXs, and learn how to verify contract addresses safely.
- [Tax Tokens](https://docs.webacy.com/glossary/tax-tokens.md): Learn how tax tokens use buy, sell, and transfer fees, when transaction taxes are legitimate, and how malicious owners exploit hidden fee mechanisms.
- [Liquidity Risks](https://docs.webacy.com/glossary/liquidity-risks.md): Understand liquidity risks in DeFi tokens, including low liquidity, unlocked LP tokens, slippage, and liquidity pull attacks that trap your funds.
- [Wash Trading](https://docs.webacy.com/glossary/wash-trading.md): Learn how wash trading inflates crypto token volume using coordinated wallets, why it signals manipulation, and how Webacy detects wash trade patterns.
- [Mixers & Tumblers](https://docs.webacy.com/glossary/mixers.md): Learn how crypto mixers and tumblers obscure transaction trails, why interacting with them can flag your wallet, and how compliance tools detect them.
- [Drainers](https://docs.webacy.com/glossary/drainers.md): Learn how wallet drainer contracts steal crypto through phishing sites, malicious token approvals, and signature exploits, and how to stay safe.
- [Phishing](https://docs.webacy.com/glossary/phishing.md): Learn how crypto phishing attacks steal funds through fake websites, malicious airdrops, social engineering, and impersonator support scams.
- [Address Poisoning](https://docs.webacy.com/glossary/address-poisoning.md): Learn how address poisoning attacks use look-alike wallet addresses and dust transactions to trick you into sending crypto to scam wallets.
- [Snipers & Bundlers](https://docs.webacy.com/glossary/snipers-bundlers.md): Learn how snipers and bundlers manipulate token launches by front-running liquidity adds, dumping on retail buyers, and inflating early holder counts.
- [Use Cases, Guides, and Walkthroughs](https://docs.webacy.com/use-cases-guides-walkthroughs.md): Guides and walkthroughs for building with Webacy: wallet screening, DEX token risk, vault due diligence, stablecoin monitoring, and trading bot integrations.
- [Monitor Stablecoin Depeg Risk](https://docs.webacy.com/monitor/stablecoin-depeg-monitoring.md): Build real-time stablecoin depeg alerts and portfolio monitoring across 600+ pegged tokens with continuous risk ratings on seven EVM chains and Solana.
- [Monitor Vaults, Stablecoins, and RWAs on a Cadence](https://docs.webacy.com/monitor/ongoing-risk-monitoring.md): Monitor allocated vaults, stablecoins, and RWAs: poll graded ratings, track depeg deviation and operational signals, and alert on threshold breaches.
- [Set up a webhook alert for a stablecoin depeg](https://docs.webacy.com/set-up-a-webhook-depeg.md): Set up a stablecoin depeg webhook alert with Webacy: subscribe to DEPEG_TIER_CHANGE events, verify HMAC signatures, and trigger a test delivery.
- [Trading Bot Risk Engine](https://docs.webacy.com/agentic/trading-bot-risk-engine.md): Add sub-200ms token risk screening to your trading bot or sniper to filter honeypots, hidden taxes, sniper clusters, and low-liquidity traps before buying.
- [Run Due Diligence on a New Asset](https://docs.webacy.com/digital-assets/new-asset-due-diligence.md): Pre-allocation due diligence for curators and allocators: chain contract and deployer risk, threat screening, liquidity depth, and graded v3 ratings.
- [Screen and Monitor Vault Risk](https://docs.webacy.com/digital-assets/vault-risk-screening.md): Screen ERC-4626 vaults before listing and monitor governance, liquidity, and code risk continuously across six EVM chains with sub-500ms verdicts.
- [Vault Risk Integration Guide](https://docs.webacy.com/digital-assets/vault-risk.md): Integrate Webacy vault risk ratings for ERC-4626 vaults with composite letter grades, per-category contributors, and continuous monitoring on nine chains.
- [Screen a Wallet for Risk](https://docs.webacy.com/screen-a-wallet-for-risk.md): Screen an onchain wallet with the Webacy API to check its risk score, transaction history, counterparty exposure, and contributing risk factors.
- [Exchange Wallet Screening](https://docs.webacy.com/wallets/exchange-wallet-screening.md): Implement deposit and withdrawal screening for your exchange with sub-500ms sanctions checks, fraud detection, and address poisoning coverage on 13 chains.
- [Consumer Wallet Security](https://docs.webacy.com/wallets/wallet-security.md): Build secure consumer wallets with address poisoning detection, transaction preview, EIP-712 signature analysis, and phishing URL screening under 500ms.
- [Transaction Simulation Overview](https://docs.webacy.com/transactions/transaction-simulation.md): Add pre-signing transaction simulation, EIP-712 permit analysis, and approval risk checks to your wallet or dApp so users see what they sign in advance.
- [Screen a Token for Risk](https://docs.webacy.com/screen-token-for-risk.md): Screen an onchain token with Webacy to review contract vulnerabilities, holder distribution, liquidity risks, and suspicious behavior before listing or trading.
- [Add Token Intelligence to Your App in Minutes](https://docs.webacy.com/tokens/add-token-intelligence-to-your-app-in-minutes.md): Add honeypot detection, liquidity checks, and real-time token risk scoring to your DEX swap UI or audit page with a single Webacy API integration.
- [DEX Token Screening](https://docs.webacy.com/tokens/dex-token-screening.md): Screen tokens in your DEX, aggregator, or swap UI for honeypots, hidden buy and sell taxes, holder concentration, and rug pull signals in real time.
- [dApp Browser Security](https://docs.webacy.com/apps/dapp-browser-security.md): Secure your dApp browser with URL phishing detection, transaction simulation, and contract verification to block lookalike domains before wallets connect.
- [Implement a Risk Rating in Your UI](https://docs.webacy.com/apps/implement-a-rating.md): Surface Webacy's A+ to F vault and RWA rating in your UI: call the v3 endpoint, pull grade and category breakdown, and render a badge in React or HTML.
- [How to Apply a Promo Code for Webacy Pro on DD.xyz](https://docs.webacy.com/apply-promo-code.md): Apply a promo code during Webacy Pro checkout on DD.xyz to unlock eligible discounts and promotional pricing, with step-by-step signup and checkout steps.
- [API Introduction](https://docs.webacy.com/api-reference/introduction.md): Get started with the Webacy Risk Score API for blockchain addresses, transactions, contracts, tokens, and URLs, and learn how the surface is organized.
- [Authenticate with the Webacy API using API keys](https://docs.webacy.com/api-reference/authentication.md): Learn how to authenticate with the Webacy API using API key headers, manage keys across environments, and handle rate limits for production traffic.
- [Get current API usage](https://docs.webacy.com/api-reference/api-usage/get-current-api-usage.md): Get current billing-period API usage by endpoint. Each route reports real served-request consumption from Datadog completion logs plus AWS quota state. `remaining` and `limit` are null for unlimited plans. Cache-served responses—requested with `use-cache=true` or used when a live provider is rate-li…
- [Get API usage for specified dates](https://docs.webacy.com/api-reference/api-usage/get-api-usage-for-specified-dates.md): Retrieve API usage statistics for a specified date range
- [Depeg Monitor](https://docs.webacy.com/api-reference/depeg-monitor.md): Use the Webacy depeg monitor endpoints to track stablecoin and RWA peg deviations in real time, with thresholds, severity bands, and event history.
- [List pegged tokens — stablecoins & RWAs](https://docs.webacy.com/api-reference/depeg-monitor/list-pegged-tokens-with-depeg-risk.md): Returns paginated rows of pegged tokens with score, tier, market data, optional cross-chain rollups, DEX market entries, migration lifecycle, audit provenance, and score deltas. The `aggregates` block (`aggregates.tier_counts`, `total_mcap`, `total_volume_24h`, leaderboards) is computed after `segme…
- [Get risk detail for a single stablecoin](https://docs.webacy.com/api-reference/depeg-monitor/get-depeg-risk-detail-for-a-pegged-token.md): Returns the full token detail: identity, classification, market data (with cross-chain rollups, DEX markets, migration lifecycle, audit provenance, score deltas), the latest depeg snapshot with full score decomposition, history series, and recorded depeg events. Address is resolved against the DB; s…
- [List Stablecoins](https://docs.webacy.com/api-reference/stablecoins/list-stablecoins.md): Stablecoin-only twin of `GET /v3/rwa`: the depeg list with `segment` fixed to `stablecoin`. `stablecoin` here is the derived segment, not `asset_class` fiat: membership also admits tokens for their stable peg behaviour, and those rows carry no `asset_class`. Read each row's `asset_class` to separate…
- [List Stablecoin Grades](https://docs.webacy.com/api-reference/stablecoins/get-stablecoin-grades.md): Stablecoin-only twin of `GET /v3/rwa/grades`: identical response, with `segment` fixed to `stablecoin` — `asset_class` fiat plus graded tokens that have not been classified yet, i.e. everything the `segment` rule does not resolve to `rwa`. `grade_counts` still covers the full graded set. A caller-su…
- [Get Stablecoin Risk Detail](https://docs.webacy.com/api-reference/stablecoins/get-stablecoin-detail.md): Stablecoin-only twin of `GET /v3/rwa/{address}`: identical response for a stablecoin; answers **404** when the token resolves to an RWA (`metadata.asset_type = rwa`) and names `GET /v3/rwa/{address}` as the route to use. The class is derived, not asserted: `stablecoin` means "pegged and not a classi…
- [Holder Concentration Index API](https://docs.webacy.com/api-reference/holder-concentration.md): Query on-chain holder concentration metrics for stablecoins and RWA tokens, including risk bands, top-holder shares, and ecosystem-wide distributions.
- [List all stablecoin and rwa holder data](https://docs.webacy.com/api-reference/holder-concentration/list-holder-concentration-index.md): Returns a paginated list of stablecoins and RWA tokens with daily-updated holder concentration data. Each record includes top-10 and top-30 cohort objects with an `index`, a `topSharePct` and a risk band. `topSharePct` is the share of supply (%) held by the top-N **organic** holders: wallets labelle…
- [RWA Risk (v3)](https://docs.webacy.com/api-reference/rwa-v3.md): Use the Webacy V3 RWA endpoints for structural risk on stablecoins and tokenized real-world assets — composite grades, category scores, and coverage.
- [Get risk detail for a single RWA](https://docs.webacy.com/api-reference/rwa-v3/get-rwa-risk-detail.md): Returns the v3 Webacy-native RWA / stablecoin decomposition: `composite` grade + per-category `contributors`, the dense `categories` criteria map, and `coverage` disclosure. No `risk` pass-through (the v2 RWA grade has none; `composite` carries the headline, floored by `upstream_risk`). POLARITY: sc…
- [List RWA & stablecoin grades](https://docs.webacy.com/api-reference/rwa-v3/get-rwa-grades.md): Paginated list of every graded RWA / stablecoin token with its v3 risk-polarity `composite` grade (letter + 0–100 score + per-category contributors). Filterable by chain / grade / minimum score, sortable, and paginated — the bulk companion to `GET /v3/rwa/{address}`. `grade_counts` is a histogram ov…
- [Batch structural risk data for RWAs](https://docs.webacy.com/api-reference/rwa-v3/post-batch-structural-health.md): Returns the live structural-health criteria (`mint_burn_anomaly`, `large_holder_concentration`) plus the v3 composite letter grade (`composite.grade`, identical derivation to the detail endpoint's) for up to 100 `{ address, chain }` tuples. Per-token failures are reported in-band as `{ ok: false, er…
- [V3 Vault Risk API Overview](https://docs.webacy.com/api-reference/vault-risk-v3/v3-overview.md): Explore the V3 vault risk surface — composite grades, per-category contributors, the full criteria taxonomy, and coverage disclosure for every vault.
- [V3 Framework Methodology](https://docs.webacy.com/api-reference/vault-risk-v3/framework-methodology.md): Learn how the Webacy V3 risk framework is structured, how composite vault scores are derived from category contributors, and why the taxonomy is API-driven.
- [Get risk data for a single vault](https://docs.webacy.com/api-reference/vault-risk-v3/get-vault-risk-detail-v3.md): Returns the v3 Webacy-native vault decomposition: `composite` grade + per-category `contributors`, the dense `categories` criteria map, `coverage` disclosure, plus pass-through v2 `metadata` and `risk`. POLARITY: scores are 0–100, higher = worse (A+ = 0, F = 100). `composite.score` is floored from b…
- [Batch vault ratings](https://docs.webacy.com/api-reference/vault-risk-v3/get-vault-grades-batch.md): Returns the v3 `composite` grade (letter + 0–100 risk score + per-category contributors) for up to 100 vaults in one request. Vault addresses travel in the POST body because the list is variable-length and may include non-EVM addresses; the endpoint is read-only. Per-vault failures are reported in-b…
- [Get vault risk data framework and taxonomy](https://docs.webacy.com/api-reference/vault-risk-v3/get-framework.md): Public methodology endpoint (no API key). Returns the full criteria taxonomy plus the supported framework / grading-scheme version lists. Unknown `framework_version` pins return 400 with the supported list. Cached 5 min.
- [Get Vault TVL History](https://docs.webacy.com/api-reference/vault-risk/get-vault-tvl-history.md): Returns a daily time series of total value locked (USD) for a single ERC-4626 vault. Each point is a UTC-midnight sample and carries a `quality_flag` describing whether the underlying TVL reading was marked trustworthy. The response also hoists the most recent passing point to a top-level `latest` a…
- [Get Vault Share Price History](https://docs.webacy.com/api-reference/vault-risk/get-vault-share-price-history.md): Returns a daily time series of share prices (USD) for a single ERC-4626 vault. Each point carries `apy_trailing_7d` — annualised against the sample 7 days earlier — which is `null` when the 7-day look-back sample is missing or the absolute APY exceeds 100 (clamped to suppress single-day pricing arti…
- [Risk Due Diligence](https://docs.webacy.com/api-reference/riskdd.md): Run risk due diligence on wallet addresses, tokens, smart contracts, and transactions with Webacy multi-chain risk analysis endpoints and signals.
- [Trading Due Diligence](https://docs.webacy.com/api-reference/tradingdd.md): Run trading due diligence with Webacy market-intelligence endpoints — real-time liquidity, holder, and risk signals for tokens you trade or list.
- [Risk intelligence for an address](https://docs.webacy.com/api-reference/threat-risks/threat-considerations-for-an-address.md): Analyze any address for security threats, fraud indicators, and risk factors across supported blockchains.
- [Check if a wallet address is sanctioned](https://docs.webacy.com/api-reference/sanction-checks/check-if-wallet-address-is-sanctioned.md): Verify if a wallet address appears on OFAC or other sanctions lists. The address-screening `sanctions_status` on this operation is distinct from the RWA token-attribute field with the same name: here, `clean` means screening completed without a match and `unknown` means authoritative screening could…
- [Detect address poisoning on a wallet address](https://docs.webacy.com/api-reference/address-poisoning/detect-address-poisoning-for-a-specific-wallet-address.md): Checks if a given wallet address has been targeted by similar-looking addresses in potential poisoning attacks.
- [Get open approvals with risk data on a wallet address](https://docs.webacy.com/api-reference/approval-risks/approvals-with-threat-risks.md): Retrieve token approvals for an address with associated threat risk analysis
- [Get the risk profile and exposure of a wallet address](https://docs.webacy.com/api-reference/exposure-risk/understand-the-risk-profile-risk-exposure-of-an-address.md): Get a summarized risk profile including exposure to known threats and malicious entities
- [Get risk details for a transaction hash](https://docs.webacy.com/api-reference/transaction-risks/risk-details-for-a-transaction.md): Get comprehensive risk analysis for a specific blockchain transaction
- [Simulate a raw EVM transaction for security risks](https://docs.webacy.com/api-reference/transaction-scanning/scan-raw-evm-transaction-for-security-risks.md): Analyzes a raw EVM transaction for security risks including malicious contracts, suspicious addresses, and potential threats. Supports Ethereum (1), BSC (56), Polygon (137), Optimism (10), Arbitrum (42161), and Base (8453).
- [Simulate an EIP-712 signed message for security risks](https://docs.webacy.com/api-reference/transaction-scanning/scan-eip-712-signed-message-for-security-risks.md): Analyzes an EIP-712 typed data signature for security risks including malicious domains, suspicious contracts, and potential phishing attempts. Only Ethereum mainnet is supported: the chain is `data.domain.chainId` (1, as a number or a decimal / `0x` hex string) and must agree with the `chain` query…
- [Get economic history for a token](https://docs.webacy.com/api-reference/token-analysis/get-token-economic-history.md): Retrieves historical token economics data for a specific date, including price, market cap, and trading volume across multiple currencies. This endpoint also provides risk assessment and token metadata to enable comprehensive analysis of token performance at a specified point in time.
- [Get pools with risk assessment for a token](https://docs.webacy.com/api-reference/token-analysis/get-token-pools-with-risk-assessment.md): Retrieves liquidity pools associated with a token and provides risk assessments for each related token in those pools. This endpoint helps in understanding the liquidity landscape and potential risks within the token's ecosystem.
- [Get trending tokens with risk analysis](https://docs.webacy.com/api-reference/token-analysis/get-trending-cryptocurrencies-with-risk-analysis.md): We index new trending tokens every 10 minutes and provide comprehensive risk analysis, token economics, and metadata for each. This endpoint returns a complete view of trending tokens and their associated risks.
- [Get Solana token risk with security indicators](https://docs.webacy.com/api-reference/trading-lite/get-simplified-token-analysis-with-security-indicators.md): Returns simplified token analysis including bundler detection, sniper detection, top holder distribution, developer activity, token authority status (mintable/freezable), and the fees a trader pays (Token-2022 transfer fee as buy/sell/transfer tax, plus the trade and creator fee of the primary Raydi…
- [Get detailed early holder analysis for a token](https://docs.webacy.com/api-reference/holder-analysis/get-detailed-early-holder-analysis-for-a-token.md): Analyzes token holders, buying patterns, and detects suspicious activity such as sniper bots and coordinated buys. This endpoint provides comprehensive insights into token ownership distribution, early investor behavior, and potential risk factors.
- [Get trending liquidity pools with risk data](https://docs.webacy.com/api-reference/pool-analysis/get-trending-pools-with-risk-analysis.md): Retrieves current trending liquidity pools with comprehensive risk analysis for the pools and their associated tokens. Data is refreshed every 24 hours.
- [Get OHLCV and risk data for a liquidity pool](https://docs.webacy.com/api-reference/pool-analysis/get-pool-ohlcv-data-with-risk-assessment.md): Retrieves OHLCV (Open, High, Low, Close, Volume) data for a liquidity pool along with risk assessment information for the pool and associated tokens. This endpoint enables comprehensive analysis of trading patterns and potential risks within a specific liquidity pool.
- [Get full risk analysis for a contract address](https://docs.webacy.com/api-reference/contract-risk/get-a-real-time-analysis-for-a-given-contract-address.md): Perform real-time security analysis on a smart contract including vulnerability detection. Returns the full contract risk report (score, tags, metadata, asset type, deployer, provider status). Source-code security analysis is included inline under source_code_analysis. To fetch only those source-cod…
- [Get only the source-code findings for a contract address](https://docs.webacy.com/api-reference/contract-risk/get-source-code-analysis-for-a-contract.md): Returns just the source-code (Solidity) analysis for a contract: the same source_code_analysis block already embedded in the real-time endpoint (GET /contracts/{contractAddress}). Use this when you want the source-code findings alone, without the rest of the risk payload. If you already call the rea…
- [Get verified source code for a contract address](https://docs.webacy.com/api-reference/contract-risk/get-verified-source-code-for-a-contract.md): Returns verified source code payload from the respective block explorer (EVM) or sources data (TON) if available. Caches results. This is the raw verified source code only, with no detector analysis; for source-code security findings use GET /contracts/{contractAddress}/code-analysis.
- [Get risk analysis of a URL](https://docs.webacy.com/api-reference/url-risks/project-url-risk-analysis.md): Analyze a URL for phishing, malware, and other security threats

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.