FinTech Hodl Base DeFi risk intel

Search and filter every tracked Base yield opportunity, with total risk and opportunity scores. Useful for finding candidates and their ids before buying a card, score, history or dependency graph. Free, at most 60 calls an hour per client. Free; at most 60 calls an hour per client.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "pattern": "^[A-Za-z0-9 ._-]{0,60}$",
      "description": "Search words over protocol, market and asset names (letters, digits, spaces, dots, dashes, underscores; at most 60).",
      "examples": [
        "usdc morpho"
      ]
    },
    "type": {
      "type": "string",
      "enum": [
        "lending",
        "vault",
        "staking",
        "fixed_yield",
        "lp",
        "stable_lp",
        "concentrated",
        "rwa"
      ],
      "description": "Opportunity type."
    },
    "asset": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._-]{1,20}$",
      "description": "Token symbol the opportunity holds.",
      "examples": [
        "USDC"
      ]
    },
    "risk_max": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Highest total risk score to include (0-100, lower is lower modelled risk)."
    },
    "min_apy": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000,
      "description": "Lowest APY to include, in percent."
    },
    "stable_only": {
      "type": "boolean",
      "description": "Only opportunities whose principal is a stablecoin."
    },
    "management": {
      "type": "string",
      "enum": [
        "passive",
        "active",
        "any"
      ],
      "description": "Passive (hold), active (needs rebalancing) or any (default)."
    },
    "include_direct": {
      "type": "boolean",
      "description": "Also list plain token holdings."
    },
    "capital": {
      "type": "number",
      "minimum": 1,
      "maximum": 1000000000,
      "description": "Capital in USD for the expected-return figures (default 10000).",
      "examples": [
        10000
      ]
    },
    "duration": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1825,
      "description": "Holding period in days for the expected-return figures (default 365).",
      "examples": [
        365
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "At most this many results (default 20)."
    }
  },
  "additionalProperties": false
}

Realized APY for Base vaults and lending markets: the APY depositors actually earned over 7 and 30 days, read from on-chain share prices, next to the quoted APY, with a verdict (matches, overstated, understated) and a risk score. Useful for finding the best yields on Base and spotting advertised yields that are not being paid. Ids work with every other route. 404 for unknown paths and 400 for invalid arguments, before any payment; 503 while data refreshes; charged only for a 200. Price: $0.01 USDC on Base (x402), charged only for a successful answer.

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._-]{1,20}$",
      "description": "Token symbol, e.g. USDC or WETH.",
      "examples": [
        "USDC"
      ]
    },
    "type": {
      "type": "string",
      "enum": [
        "lending",
        "vault",
        "staking",
        "fixed_yield",
        "lp",
        "stable_lp",
        "concentrated",
        "rwa"
      ],
      "description": "Opportunity type."
    },
    "stable_only": {
      "type": "boolean",
      "description": "Only stablecoin principal."
    },
    "realized_only": {
      "type": "boolean",
      "description": "Only opportunities with a realized on-chain APY."
    },
    "min_apy": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000,
      "description": "Minimum quoted APY, percent."
    },
    "risk_max": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Maximum risk score (0-100, lower is lower modelled risk)."
    },
    "sort": {
      "type": "string",
      "enum": [
        "risk_adjusted",
        "realized_apy",
        "quoted_apy",
        "sustainable_apy",
        "tvl"
      ],
      "description": "Order: risk_adjusted (default) ranks by opportunity score; realized_apy by the 30-day realized APY; sustainable_apy by the APY expected once incentives fade."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "How many items (default 20)."
    }
  },
  "additionalProperties": false
}

Lending rates on Base: supply APY for every tracked money market and lending vault (Aave, Morpho, Compound, Moonwell and others), quoted next to the APY lenders actually earned over 7 and 30 days, read on-chain, with a risk score. Useful for choosing where to lend USDC, ETH or stablecoins. Ids work with every other route. 404 for unknown paths and 400 for invalid arguments, before any payment; 503 while data refreshes; charged only for a 200. Price: $0.01 USDC on Base (x402), charged only for a successful answer.

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._-]{1,20}$",
      "description": "Token symbol, e.g. USDC or WETH.",
      "examples": [
        "USDC"
      ]
    },
    "stable_only": {
      "type": "boolean",
      "description": "Only stablecoin principal."
    },
    "realized_only": {
      "type": "boolean",
      "description": "Only opportunities with a realized on-chain APY."
    },
    "min_apy": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000,
      "description": "Minimum quoted APY, percent."
    },
    "risk_max": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Maximum risk score (0-100, lower is lower modelled risk)."
    },
    "sort": {
      "type": "string",
      "enum": [
        "risk_adjusted",
        "realized_apy",
        "quoted_apy",
        "sustainable_apy",
        "tvl"
      ],
      "description": "Order: risk_adjusted (default) ranks by opportunity score; realized_apy by the 30-day realized APY; sustainable_apy by the APY expected once incentives fade."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "How many items (default 20)."
    }
  },
  "additionalProperties": false
}

Yield farming opportunities on Base: liquidity pools, concentrated liquidity (Aerodrome Slipstream) and auto-compounding vaults, ranked risk-adjusted, with quoted APY split into fees and token rewards, the sustainable APY once incentives fade, TVL, a risk score, and realized APY where measured. Useful for picking farms worth their risk. Ids work with every other route. 404 for unknown paths and 400 for invalid arguments, before any payment; 503 while data refreshes; charged only for a 200. Price: $0.01 USDC on Base (x402), charged only for a successful answer.

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._-]{1,20}$",
      "description": "Token symbol, e.g. USDC or WETH.",
      "examples": [
        "USDC"
      ]
    },
    "type": {
      "type": "string",
      "enum": [
        "lp",
        "stable_lp",
        "concentrated",
        "vault"
      ],
      "description": "lp, stable_lp (stablecoin pairs), concentrated (concentrated liquidity) or vault (auto-compounding vaults)."
    },
    "stable_only": {
      "type": "boolean",
      "description": "Only stablecoin principal."
    },
    "realized_only": {
      "type": "boolean",
      "description": "Only opportunities with a realized on-chain APY."
    },
    "min_apy": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000,
      "description": "Minimum quoted APY, percent."
    },
    "risk_max": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Maximum risk score (0-100, lower is lower modelled risk)."
    },
    "sort": {
      "type": "string",
      "enum": [
        "risk_adjusted",
        "realized_apy",
        "quoted_apy",
        "sustainable_apy",
        "tvl"
      ],
      "description": "Order: risk_adjusted (default) ranks by opportunity score; realized_apy by the 30-day realized APY; sustainable_apy by the APY expected once incentives fade."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "How many items (default 20)."
    }
  },
  "additionalProperties": false
}

The list of paid routes with their prices. Free.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Full risk card for one Base yield opportunity: 0-100 risk score with the main risks and their evidence, yield sources, sustainable APY, expected return, liquidity, dependencies and recent risk events. Useful before depositing into, recommending or comparing a Base yield. The id comes from the free /api/v1/opportunities. Unknown ids answer 404 and invalid arguments 400 before any payment; 503 while data refreshes; charged only for a 200. Price: $0.01 USDC on Base (x402), charged only for a successful answer. In this MCP server, ids come from search_opportunities.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:._#+-]{1,120}$",
      "description": "Opportunity id, as returned by the free /api/v1/opportunities route.",
      "examples": [
        "e0672197-9f3e-4414-bca5-e6b4c90aa469"
      ]
    },
    "capital": {
      "type": "number",
      "minimum": 1,
      "maximum": 1000000000,
      "description": "Capital in USD for the expected-return figures (default 10000).",
      "examples": [
        10000
      ]
    },
    "duration": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1825,
      "description": "Holding period in days for the expected-return figures (default 365).",
      "examples": [
        365
      ]
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Scoring breakdown for one opportunity: total risk, the eight risk dimensions with every factor and its input, sustainability, liquidity, slippage, position size and confidence. Useful for auditing or explaining a risk score. The id comes from the free /api/v1/opportunities. Unknown ids answer 404 and invalid arguments 400 before any payment; 503 while data refreshes; charged only for a 200. Price: $0.01 USDC on Base (x402), charged only for a successful answer. In this MCP server, ids come from search_opportunities.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:._#+-]{1,120}$",
      "description": "Opportunity id, as returned by the free /api/v1/opportunities route.",
      "examples": [
        "e0672197-9f3e-4414-bca5-e6b4c90aa469"
      ]
    },
    "capital": {
      "type": "number",
      "minimum": 1,
      "maximum": 1000000000,
      "description": "Capital in USD for the expected-return figures (default 10000).",
      "examples": [
        10000
      ]
    },
    "duration": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1825,
      "description": "Holding period in days for the expected-return figures (default 365).",
      "examples": [
        365
      ]
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Daily history of one opportunity's APY, TVL and risk scores. Useful for checking whether a yield is stable or newly inflated, and for trend charts. The id comes from the free /api/v1/opportunities. Unknown ids answer 404 and invalid arguments 400 before any payment; 503 while data refreshes; charged only for a 200. Price: $0.01 USDC on Base (x402), charged only for a successful answer. In this MCP server, ids come from search_opportunities.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:._#+-]{1,120}$",
      "description": "Opportunity id, as returned by the free /api/v1/opportunities route.",
      "examples": [
        "e0672197-9f3e-4414-bca5-e6b4c90aa469"
      ]
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 730,
      "description": "Look-back in days (default 30).",
      "examples": [
        30
      ]
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

What one opportunity depends on: protocols, stablecoins and their issuers, oracles, bridges and vault curators, as a graph. Useful for finding hidden shared exposure before combining positions. The id comes from the free /api/v1/opportunities. Unknown ids answer 404 and invalid arguments 400 before any payment; 503 while data refreshes; charged only for a 200. Price: $0.01 USDC on Base (x402), charged only for a successful answer. In this MCP server, ids come from search_opportunities.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:._#+-]{1,120}$",
      "description": "Opportunity id, as returned by the free /api/v1/opportunities route.",
      "examples": [
        "e0672197-9f3e-4414-bca5-e6b4c90aa469"
      ]
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Everything an entity (protocol, asset, stablecoin, curator) depends on, transitively, as a graph. Useful for tracing what a protocol or stablecoin ultimately relies on. Entity ids appear in dependency graphs, for example protocol:morpho-blue. Unknown ids answer 404 and invalid arguments 400 before any payment; 503 while data refreshes; charged only for a 200. Price: $0.01 USDC on Base (x402), charged only for a successful answer.

{
  "type": "object",
  "properties": {
    "entity": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:._#+-]{1,120}$",
      "description": "Entity id: protocol:<slug>, stablecoin:<id>, oracle:<name>, curator:<name> or issuer:<name>, as found in dependency graphs.",
      "examples": [
        "protocol:morpho-blue",
        "protocol:aave-v3"
      ]
    }
  },
  "required": [
    "entity"
  ],
  "additionalProperties": false
}

Which tracked Base opportunities depend on an entity (protocol, stablecoin, oracle, curator), with their total TVL. Useful for sizing the impact of an exploit, depeg or oracle failure. Entity ids appear in dependency graphs, for example protocol:morpho-blue. Unknown ids answer 404 and invalid arguments 400 before any payment; 503 while data refreshes; charged only for a 200. Price: $0.01 USDC on Base (x402), charged only for a successful answer.

{
  "type": "object",
  "properties": {
    "entity": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:._#+-]{1,120}$",
      "description": "Entity id: protocol:<slug>, stablecoin:<id>, oracle:<name>, curator:<name> or issuer:<name>, as found in dependency graphs.",
      "examples": [
        "protocol:morpho-blue",
        "protocol:aave-v3"
      ]
    }
  },
  "required": [
    "entity"
  ],
  "additionalProperties": false
}

Why one opportunity pays more than a reference: the APY gap in percentage points, explained by risk dimensions, incentives and extra dependencies. Useful for judging whether a higher yield is worth its extra risk. The id comes from the free /api/v1/opportunities. Unknown ids answer 404 and invalid arguments 400 before any payment; 503 while data refreshes; charged only for a 200. Price: $0.01 USDC on Base (x402), charged only for a successful answer. In this MCP server, ids come from search_opportunities.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:._#+-]{1,120}$",
      "description": "Opportunity id, as returned by the free /api/v1/opportunities route.",
      "examples": [
        "e0672197-9f3e-4414-bca5-e6b4c90aa469"
      ]
    },
    "benchmark": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:._#+-]{1,120}$",
      "description": "Reference opportunity id (optional); by default a low-risk lending market on the same asset.",
      "examples": [
        "e0672197-9f3e-4414-bca5-e6b4c90aa469"
      ]
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Risk profile of one protocol on Base: age, TVL history, audits, exploit history, governance (admin, timelock, multisig, upgradeability, pause) and the risk of its opportunities. Useful for due diligence on a protocol. Unknown ids answer 404 and invalid arguments 400 before any payment; 503 while data refreshes; charged only for a 200. Price: $0.02 USDC on Base (x402), charged only for a successful answer.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:._#+-]{1,120}$",
      "description": "DeFiLlama protocol slug.",
      "examples": [
        "morpho-blue",
        "aave-v3"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Peg and supply risk of one stablecoin on Base: price history, supply change, mechanism and the opportunities that hold it. Useful before holding or lending a stablecoin, or when a depeg is suspected. Unknown ids answer 404 and invalid arguments 400 before any payment; 503 while data refreshes; charged only for a 200. Price: $0.02 USDC on Base (x402), charged only for a successful answer.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:._#+-]{1,40}$",
      "description": "Stablecoin symbol.",
      "examples": [
        "USDC",
        "USDS"
      ]
    }
  },
  "required": [
    "symbol"
  ],
  "additionalProperties": false
}

Recent risk events on Base DeFi: TVL drops, depegs, exploits, APY moves and Morpho vault setting changes, with severity. Useful for monitoring positions or screening protocols for recent trouble. Entity ids appear in dependency graphs. Unknown ids answer 404 and invalid arguments 400 before any payment; 503 while data refreshes; charged only for a 200. Price: $0.02 USDC on Base (x402), charged only for a successful answer.

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90,
      "description": "Look-back in days (default 7).",
      "examples": [
        7
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "At most this many events (default 100)."
    },
    "entity": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:._#+-]{1,120}$",
      "description": "Only events for this entity (optional).",
      "examples": [
        "protocol:morpho-blue",
        "protocol:aave-v3"
      ]
    },
    "severity": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "critical"
      ],
      "description": "Lowest severity to include (default low)."
    }
  },
  "additionalProperties": false
}

Labelled incidents (exploits, oracle failures, depegs, TVL collapses) affecting Base protocols and stablecoins. Useful for a protocol or stablecoin track record before trusting it with funds. Entity ids appear in dependency graphs. Unknown ids answer 404 and invalid arguments 400 before any payment; 503 while data refreshes; charged only for a 200. Price: $0.02 USDC on Base (x402), charged only for a successful answer.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "At most this many incidents (default 100)."
    },
    "entity": {
      "type": "string",
      "pattern": "^[A-Za-z0-9:._#+-]{1,120}$",
      "description": "Only incidents for this entity (optional).",
      "examples": [
        "protocol:morpho-blue",
        "protocol:aave-v3"
      ]
    }
  },
  "additionalProperties": false
}