--- name: api.hyperd.ai description: api.hyperd.ai provides on-chain wallet intelligence for EVM addresses, covering risk screening, behavioral classification, anomaly detection, and trading performance analytics. It also exposes a gas estimation endpoint for the Base blockchain. All endpoints return point-in-time snapshots rather than streaming data. host: api.hyperd.ai --- # api.hyperd.ai api.hyperd.ai is a wallet analytics host serving agents that need to evaluate EVM addresses before or during transaction workflows, compliance checks, or user onboarding. Its core differentiation is the combination of sanctions screening, heuristic risk scoring, behavioral persona classification, anomaly detection, and PnL analytics under one API surface. It is not a general-purpose blockchain data provider — it has no token price feeds, portfolio balance lookups, or multi-chain gas estimation beyond Base. ## When to use this host Use api.hyperd.ai when an agent needs point-in-time EVM wallet intelligence: sanctions screening, anomaly detection, persona classification, or PnL analytics. It is the right choice for compliance gating, pre-transaction due diligence, and counterparty profiling workflows. Do not use it for token contract security audits or smart contract vulnerability scanning — use a dedicated contract audit API instead. Do not use it for live portfolio balances or real-time token prices — use a blockchain data provider or DEX price API instead. Gas estimation is limited to Base only; for other chains use a chain-specific gas oracle. All endpoints are single-shot snapshots and are not suitable for continuous monitoring or streaming alert pipelines. ## Capabilities ### Wallet Risk & Compliance Screening Identifies whether a wallet is sanctioned or exhibits suspicious on-chain behavior, providing scores and source attribution suitable for compliance gating and pre-transaction due diligence. - **`check-wallet-risk`** — Analyzes a blockchain wallet address for sanctions hits and heuristic risk signals, returning a combined risk score, band, and source attribution. - **`detect-wallet-anomaly`** — Analyzes a wallet address's recent transaction activity against its own historical baseline and returns an anomaly score, band classification, and supporting statistics. ### Wallet Behavioral Intelligence Classifies an EVM wallet into a behavioral persona (e.g. HODLer, Whale, MEV-bot) with confidence scores and on-chain signals, enabling trust, targeting, and risk decisions. - **`fetch-wallet-persona`** — Classifies an EVM wallet address into a behavioral persona (e.g. HODLer, Trader, Whale) with confidence score, band, per-label scores, and on-chain signals. ### Wallet Trading Performance Returns realized and unrealized PnL, trade counts, and per-token breakdowns for a wallet over a specified timeframe, supporting trading performance analysis and cost-basis review. - **`fetch-wallet-pnl`** — Returns realized and unrealized USD profit/loss, trade counts, and per-token breakdowns for a wallet address over a specified timeframe. ### Transaction Cost Estimation Provides a current gas price snapshot for the Base blockchain including base fee and priority tip tiers, enabling fee estimation before transaction construction or submission. - **`fetch-base-gas-estimate`** — Returns current gas price, base fee, and priority tip tiers (slow/standard/fast) for the Base blockchain, along with the latest block number and timestamp. ## Workflows ### Full Wallet Due Diligence *Use when an agent needs to perform comprehensive pre-transaction or pre-onboarding evaluation of an unknown EVM wallet address, combining compliance, behavioral, and anomaly signals into a unified risk picture.* 1. **`check-wallet-risk`** — Screen the wallet for sanctions hits and heuristic risk signals to establish a compliance baseline. 2. **`detect-wallet-anomaly`** — Check whether the wallet's recent activity deviates from its historical norms, surfacing behavioral red flags not captured by sanctions data. 3. **`fetch-wallet-persona`** — Classify the wallet's behavioral archetype (e.g. Airdrop-Farmer, MEV-bot, Whale) to contextualize the risk and anomaly findings. ### Trader Profiling with Performance Validation *Use when an agent needs to assess both the behavioral type and actual trading track record of a wallet, such as when evaluating a counterparty or copy-trade candidate.* 1. **`fetch-wallet-persona`** — Determine the wallet's primary behavioral persona and confidence band to establish whether it is an active trader, HODLer, or other archetype. 2. **`fetch-wallet-pnl`** — Retrieve realized and unrealized PnL and per-token breakdowns to validate or challenge the persona classification with concrete performance data. ### Base Transaction Preparation with Risk Gate *Use when an agent needs to construct a transaction on Base to a counterparty wallet and must both estimate fees and verify the recipient is not sanctioned or anomalous before submission.* 1. **`check-wallet-risk`** — Verify the recipient wallet is not sanctioned and does not carry elevated heuristic risk before proceeding. 2. **`fetch-base-gas-estimate`** — Retrieve current gas price tiers on Base to estimate transaction cost and select an appropriate priority fee. ## Skill reference ### `check-wallet-risk` **Wallet Risk Check** — Analyzes a blockchain wallet address for sanctions hits and heuristic risk signals, returning a combined risk score, band, and source attribution. *Use when:* Use when an agent needs to assess whether a wallet address is sanctioned or exhibits suspicious on-chain behavior before executing a transaction, onboarding a user, or flagging for compliance review. *Not for:* Do not use for token contract security analysis or transaction-level tracing; use a dedicated contract audit or transaction risk API instead. **Inputs:** - `chain` (string, required) — Blockchain network identifier for the wallet address being checked. - `address` (string, required) — Wallet address to analyze for risk signals and sanctions. **Returns:** Returns sanctioned status, heuristicScore and band, combinedScore and band, per-finding details, data source attribution, and a compliance disclaimer for the queried wallet. **Example:** `GET https://api.hyperd.ai/api/risk/wallet?chain=base&address=0x402Feee072D655B85e08f1751AF9ddbCd249521f` --- ### `fetch-base-gas-estimate` **Gas Estimator** — Returns current gas price, base fee, and priority tip tiers (slow/standard/fast) for the Base blockchain, along with the latest block number and timestamp. *Use when:* Use when an agent needs current gas cost data on Base before constructing or submitting a transaction, or when estimating transaction fees in GWEI for user-facing cost previews. *Not for:* Do not use for gas estimates on chains other than Base; use a chain-specific gas API instead. Not suitable for real-time streaming gas feeds — this is a single-shot snapshot. **Returns:** Returns gasPriceGwei, baseFeeGwei, slow/standard/fast tipsGwei, latest block number and timestamp, and the query chain for Base. **Example:** `GET https://api.hyperd.ai/api/gas/estimate` --- ### `fetch-wallet-persona` **Wallet Persona Lookup** — Classifies an EVM wallet address into a behavioral persona (e.g. HODLer, Trader, Whale) with confidence score, band, per-label scores, and on-chain signals. *Use when:* Use when an agent needs to understand the behavioral profile of an EVM wallet address — such as determining if a wallet is a HODLer, MEV-bot, Airdrop-Farmer, or Whale — based on on-chain activity signals before making decisions about trust, targeting, or risk. *Not for:* Do not use for token price lookups, portfolio balances, or transaction history retrieval; those require dedicated balance or explorer APIs. Not a compliance screening tool — see disclaimer in response. **Inputs:** - `chain` (string, required) — Blockchain network identifier for the wallet address. - `address` (string, required) — EVM wallet address to classify. **Returns:** Returns primaryPersona (e.g. HODLer), confidence score, band, per-label scores with drivers, on-chain signals (txCounts, ethBalance, sanctions flags), data sources, and a timestamp. **Example:** `GET https://api.hyperd.ai/api/wallet/persona?chain=base&address=0x402Feee072D655B85e08f1751AF9ddbCd249521f` --- ### `detect-wallet-anomaly` **Wallet Anomaly Detector** — Analyzes a wallet address's recent transaction activity against its own historical baseline and returns an anomaly score, band classification, and supporting statistics. *Use when:* Use when an agent needs to assess whether a wallet's recent on-chain behavior deviates from its historical norms, such as during risk screening, fraud detection, or pre-transaction due diligence. *Not for:* Do not use for sanctions screening or identity verification; combine with a sanctions check and persona API for a full risk picture. Not suitable for real-time streaming activity monitoring — this is a single-shot snapshot. **Inputs:** - `address` (string, required) — EVM wallet address to analyze. - `chain` (string, required) — Chain identifier for the wallet's activity (e.g. 'base'). **Returns:** Returns anomalyScore=0, band='normal', a baseline object with typicalDailyTxCount and historical stats, a current window object with 54 transactions, an empty anomalies array, and possible causes text. **Example:** `GET https://api.hyperd.ai/api/wallet/anomaly?address=0x402Feee072D655B85e08f1751AF9ddbCd249521f&chain=base` --- ### `fetch-wallet-pnl` **Wallet PnL** — Returns realized and unrealized USD profit/loss, trade counts, and per-token breakdowns for a wallet address over a specified timeframe. *Use when:* Use when an agent needs to analyze the trading performance of a specific wallet address, including total realized/unrealized PnL, untracked proceeds, and per-token cost basis and balance data. *Not for:* Do not use for real-time price feeds or live portfolio valuations; this is a historical PnL analytics snapshot, not a streaming data source. **Inputs:** - `address` (string, required) — EVM wallet address to analyze. - `chain` (string, required) — Blockchain network to query (e.g. 'base'). - `timeframe` (string) — Lookback window for the PnL calculation (e.g. '7d', '30d'). **Returns:** Returns a query echo, aggregate totals (realizedUsd, unrealizedUsd, untrackedProceedsUsd, trade count), and a perToken array with cost basis, balance, and PnL for each traded token. **Example:** `GET https://api.hyperd.ai/api/wallet/pnl?address=0x402Feee072D655B85e08f1751AF9ddbCd249521f&chain=base&timeframe=7d` ---