--- name: base-intel-api.jakemaxsigal.workers.dev description: base-intel-api.jakemaxsigal.workers.dev provides on-chain intelligence endpoints exclusively for the Base L2 chain, covering wallet scoring, DEX pool analytics, token launch risk assessment, yield comparisons, gas fee tiers, and USDC flow tracking. All endpoints return structured snapshots rather than streaming data. The host is narrowly scoped to Base and does not support other EVM chains. host: base-intel-api.jakemaxsigal.workers.dev --- # base-intel-api.jakemaxsigal.workers.dev This host serves agents and developers who need structured, Base-specific on-chain data for decision support — including DeFi LP analysis, wallet due diligence, new token screening, and transaction cost estimation. It aggregates and scores raw chain data into opinionated outputs (grades, risk labels, sustainability classifications) rather than exposing raw RPC data. It is not a general-purpose multi-chain data provider or a real-time price/balance feed. ## When to use this host Use this host when the task is Base-chain-specific and requires opinionated, pre-scored outputs — wallet grades, pool sustainability labels, yield rankings, or launch risk scores — rather than raw RPC data. It is well-suited for DeFi decision support, onboarding screening, and gas-aware transaction planning on Base. Do not use this host for: wallets or pools on Ethereum mainnet or other EVM chains (use a multi-chain provider instead); real-time token price or swap quote lookups (use a DEX aggregator or price feed API); historical trend analysis beyond short recent windows; or profit/loss accounting across multiple token types (the USDC leaderboard covers USDC flow only). The fetch-wallet-score skill appears twice in the input with identical behavior — treat them as the same endpoint. ## Capabilities ### Wallet Intelligence Scores and profiles Base wallet addresses using on-chain activity, balances, and smart wallet status, producing a 0–100 numeric score, letter grade, and behavioral profile useful for onboarding screening or risk assessment. - **`fetch-wallet-score`** — Returns a numeric score (0–100), letter grade, profile label, and detailed activity/balance breakdown for a Base chain wallet address. ### DEX Pool Analytics Provides a ranked snapshot of active Base DEX liquidity pools, classifying them as healthy or degen based on vol/TVL ratios, and surfaces fee APR and TVL to inform LP decisions. - **`fetch-base-hot-pools`** — Returns ranked Base DEX pools split into 'healthy' (sustainable vol/TVL) and 'degen' (high vol/TVL, likely pump or wash) categories with TVL, 24h volume, fee APR, and sustainability labels. ### Yield Intelligence Returns current APYs, TVL, impermanent loss risk, and risk scores across Base lending and LP pools, plus a per-asset best-yield recommendation map for USDC, ETH, WETH, and USDT. - **`fetch-base-yields`** — Returns current APYs, TVL, IL risk, and risk scores for lending pools and LP pools on Base, plus a per-asset best-yield recommendation map. ### Token Launch Risk Screening Evaluates recently launched Base tokens from Bankr with risk scores, letter grades, deployer identity, and per-signal breakdowns to support new-launch due diligence and filtering. - **`fetch-bankr-launch-scores`** — Returns a ranked list of recent Base token launches with risk scores, letter grades, risk labels, deployer identity, and per-signal score breakdowns. ### Gas Fee Estimation Returns current Base L2 gas fee tiers (slow, standard, fast) with gwei values, expected wait blocks, and USD swap cost estimates to support transaction fee selection. - **`fetch-base-gas-oracle`** — Returns current Base L2 gas fee tiers (slow, standard, fast) with maxFeeGwei, waitBlocks, and USD swap cost estimates, plus a base fee and routing recommendation. ### USDC Flow Tracking Identifies the most active Base wallets by USDC net flow over the last ~120 blocks, classifying them as accumulators, distributors, or routers and providing aggregate flow summary stats. - **`fetch-base-usdc-leaderboard`** — Returns a ranked leaderboard of the most active Base wallets by USDC net flow over the last ~120 blocks, with per-wallet classification, portfolio value, and aggregate summary stats. ## Workflows ### LP Opportunity Evaluation *Use when an agent needs to identify the best current yield opportunity on Base and validate that gas costs make entry economically viable.* 1. **`fetch-base-yields`** — Retrieve current APYs, TVL, and risk scores across Base lending and LP pools to identify the highest-yield option for the target asset. 2. **`fetch-base-hot-pools`** — Cross-reference the top-yield pool against active DEX pools to confirm sustainability classification (healthy vs. degen) and validate vol/TVL ratios. 3. **`fetch-base-gas-oracle`** — Estimate the USD cost of entering the position at current gas tiers to confirm the yield opportunity is not negated by transaction costs. ### Wallet Onboarding Due Diligence *Use when an agent needs to screen a Base wallet address for onboarding eligibility and also assess whether the wallet is a notable USDC flow participant.* 1. **`fetch-wallet-score`** — Score the target wallet address to obtain its activity grade, profile label, smart wallet status, and balance breakdown. 2. **`fetch-base-usdc-leaderboard`** — Check whether the wallet appears in the recent USDC flow leaderboard to identify if it is a significant accumulator, distributor, or router. ### New Token Launch Screening with Gas Check *Use when an agent needs to evaluate recent Base token launches for risk and determine whether current gas conditions make an entry transaction cost-effective.* 1. **`fetch-bankr-launch-scores`** — Retrieve ranked recent token launches with risk grades and deployer identity to filter for acceptable-risk candidates. 2. **`fetch-base-gas-oracle`** — Check current gas fee tiers and USD swap cost estimates to confirm transaction costs are acceptable before acting on a screened launch. ## Skill reference ### `fetch-wallet-score` **Wallet Score API** — Returns a numeric score (0–100), letter grade, profile label, and detailed activity breakdown for a Base chain wallet address. *Use when:* Use when an agent needs to assess the quality or activity level of a Base wallet address, including its transaction count, ETH/USDC balances, smart wallet status, and an overall score and grade. *Not for:* Do not use for wallets on chains other than Base; this endpoint only scores Base chain addresses. Not suitable for real-time balance lookups — use a dedicated balance API instead. **Inputs:** - `address` (string, required) — Base chain wallet address to score, provided as a path parameter in the URL. **Returns:** Returns a score (0–100), letter grade, profile label, smart wallet flag, wallet age, and a full breakdown of activity, ETH/USDC balances, and sub-scores for a Base wallet address. **Example:** `GET https://base-intel-api.jakemaxsigal.workers.dev/wallet/score/0x4200000000000000000000000000000000000006` --- ### `fetch-base-hot-pools` **Hot Pools Tracker** — Returns ranked Base DEX pools split into 'healthy' (sustainable vol/TVL) and 'degen' (high vol/TVL, likely pump or wash) categories with TVL, 24h volume, fee APR, and sustainability labels. *Use when:* Use when an agent needs a current snapshot of the most active Base DEX liquidity pools, including protocol, pair, TVL, 24h volume, vol/TVL ratio, fee APR, and sustainability classification, to inform LP decisions or DeFi analytics. *Not for:* Do not use for token price lookups, swap quotes, or cross-chain pool data; this endpoint covers Base chain DEX pools only. **Returns:** Returns a JSON object with a timestamp, chain='base', a 'healthy' array of top sustainable pools (with TVL, 24h/7d volume, fee APR, vol/TVL ratio, IL risk, and underlying token addresses), and a 'degen' array of high-churn pools. **Example:** `GET https://base-intel-api.jakemaxsigal.workers.dev/pools/hot` --- ### `fetch-bankr-launch-scores` **Bankr Score** — Returns a ranked list of recent Base token launches with risk scores, letter grades, risk labels, deployer identity, and per-signal score breakdowns. *Use when:* Use when an agent needs to evaluate the quality or risk level of recently launched tokens on Base, such as when screening new launches for due diligence, filtering by risk grade, or identifying deployer identity and social presence. *Not for:* Do not use for historical token analysis or price/liquidity data; this endpoint covers only recent Bankr launches and provides signal scores, not trading advice or market data. **Inputs:** - `limit` (integer) — Maximum number of launch entries to return. Defaults to 10. **Returns:** Returns a timestamp, count, and array of up to 10 recent Base token launches each with a 0–100 score, letter grade, risk label, deployer identity, social links, per-signal breakdown, and a DYOR warning. **Example:** `GET https://base-intel-api.jakemaxsigal.workers.dev/bankr/score?limit=10` --- ### `fetch-base-yields` **Base Yields Intel** — Returns current APYs, TVL, IL risk, and risk scores for lending pools and LP pools on Base, plus a per-asset best-yield recommendation map. *Use when:* Use when an agent needs to compare yield opportunities on Base across lending protocols and LP pools, or to find the highest-APY option for a specific asset (USDC, ETH, WETH, USDT) with risk context. *Not for:* Do not use for yield data on chains other than Base; use a multi-chain yield API instead. Not suitable for real-time streaming price feeds — this is a single-shot snapshot. **Returns:** Returns a JSON object with chain='base', a timestamp, a lending array and lp array of quality-filtered pool entries with APY/TVL/risk data, and a bestByAsset map naming the top-yield pool per asset with a recommendation label. **Example:** `GET https://base-intel-api.jakemaxsigal.workers.dev/yields` --- ### `fetch-wallet-score` **Wallet Score** — Returns a numeric score (0–100), letter grade, profile label, and detailed activity/balance breakdown for a Base chain wallet address. *Use when:* Use when an agent needs to assess the quality or activity level of a Base wallet address, such as for onboarding screening, risk scoring, or eligibility checks based on on-chain behavior. *Not for:* Do not use for wallets on chains other than Base. Not suitable for real-time balance lookups or token price queries — use a chain RPC or price feed API instead. **Inputs:** - `address` (string, required) — The Base wallet address to score, provided as a path parameter in the URL. **Returns:** Returns a score of 31, grade C, profile 'casual', isSmartWallet false, plus a breakdown with txCount, ETH/USDC balances, activity scores, and USDC flow metrics for the queried Base wallet. **Example:** `GET https://base-intel-api.jakemaxsigal.workers.dev/wallet/score/0x7e571E959cC7C75Ccdd2eAC24f8775ea2eAa2F09` --- ### `fetch-base-gas-oracle` **Base Gas Oracle** — Returns current Base L2 gas fee tiers (slow, standard, fast) with maxFeeGwei, waitBlocks, and USD swap cost estimates, plus a base fee and routing recommendation. *Use when:* Use when an agent needs to assess current Base L2 gas conditions before submitting a transaction, selecting a fee tier, or estimating swap costs in USD. *Not for:* Do not use for Ethereum mainnet or other EVM chain gas estimates; this endpoint is Base-specific only. **Returns:** Returns baseFeeGwei, three fee tiers (slow/standard/fast) each with maxFeeGwei, waitBlocks, and swapCostUsd, plus a recommendation string such as 'very_cheap' and an ISO timestamp. **Example:** `GET https://base-intel-api.jakemaxsigal.workers.dev/gas` --- ### `fetch-base-usdc-leaderboard` **Base Intel USDC Leaderboard** — Returns a ranked leaderboard of the most active Base wallets by USDC net flow over the last ~120 blocks, with per-wallet classification, portfolio value, and aggregate summary stats. *Use when:* Use when an agent needs to identify top USDC accumulators, distributors, or passthrough routers on Base over a recent short window (~10 minutes), or to retrieve aggregate flow stats such as total net flow and wallet counts. *Not for:* Do not use for profit/loss analysis across all token types — this measures USDC flow only, not ETH or other token positions. Do not use for historical or 24h+ trend data; the window is limited to the last ~120 blocks. **Returns:** Returns chain, period, timestamp, summary stats (walletsTracked, accumulators, distributors, totalNetFlowUsd), and a ranked leaderboard array of wallets with USDC net flow, portfolio value, and classification over the last ~120 Base blocks. **Example:** `GET https://base-intel-api.jakemaxsigal.workers.dev/leaderboard` ---