# Base DeFi Yield History & Risk Score Time Series

> Base DeFi Yield History & Risk Score Time Series is a paid API for AI agents from intel.fintechhodl.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Returns daily APY, TVL, and risk score history for a specific Base DeFi yield opportunity over a configurable look-back window.

## Facts

- Endpoint: GET https://intel.fintechhodl.com/api/v1/history/:id?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/base-defi-yield-history-risk-score-time-series-8bef9bd5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RgOqrwa5EWkU_dyjRoTHI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability base-defi-yield-history-risk-score-time-series-8bef9bd5
```

Example prompt: Pull the last 90 days of APY, TVL, and risk score history for Base DeFi opportunity e0672197-9f3e-4414-bca5-e6b4c90aa469 so I can see whether that yield has been stable or if it just spiked recently.

## When to prefer this

Use this endpoint when you need time-series historical data for a single Base DeFi opportunity — APY trend, TVL growth/decline, or risk score evolution over days or months. Prefer this over the snapshot/scoring endpoints when the user wants to assess stability, spot yield inflation, build charts, or compare current values to historical averages. Not suitable for discovering opportunities (use /api/v1/opportunities first to get valid ids) or for cross-protocol comparisons in a single call.

## Known failure modes

- 404 returned for unknown or unrecognized opportunity ids — agent must first fetch a valid id from the free /api/v1/opportunities endpoint
- 400 returned for malformed path parameters or invalid query arguments (e.g. days outside 1-730 range)
- 503 returned while underlying data is refreshing — agent should retry after a short delay
- Payment not charged on non-200 responses, so 404/400/503 are safe to retry without financial risk
- Data age (data_age_min) may be high during periods of upstream data lag

## How this service works

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.

## Output

A JSON object containing: an array of daily data points (each with date, TVL in USD, total APY, base APY, and reward APY), an array of risk score snapshots (timestamp, total risk, opportunity score, sustainability, confidence), model version, data freshness in minutes, and a disclaimer. Covers up to the requested look-back window (default 30 days, max 730 days).

## Request schema (JSON Schema)

```json
{
 "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"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "pattern": "^[A-Za-z0-9:._#+-]{1,120}$",
       "examples": [
        "e0672197-9f3e-4414-bca5-e6b4c90aa469"
       ],
       "description": "Opportunity id, as returned by the free /api/v1/opportunities route."
      }
     },
     "additionalProperties": false
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "days": {
       "type": "integer",
       "maximum": 730,
       "minimum": 1,
       "examples": [
        30
       ],
       "description": "Look-back in days (default 30)."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "as_of",
      "model_version",
      "id",
      "points"
     ],
     "properties": {
      "id": {
       "type": "string"
      },
      "days": {
       "type": "integer"
      },
      "as_of": {
       "type": "string",
       "description": "Hour the data describes (ISO 8601, UTC)."
      },
      "points": {
       "type": "array",
       "items": {
        "type": "object"
       },
       "description": "One per UTC day: day, tvl_usd, apy, apy_base, apy_reward."
      },
      "scores": {
       "type": "array",
       "items": {
        "type": "object"
       },
       "description": "Stored scores: ts, total_risk, opportunity_score, sustainability, confidence."
      },
      "disclaimer": {
       "type": "string"
      },
      "data_age_min": {
       "type": "number",
       "description": "Minutes since the newest pool data."
      },
      "model_version": {
       "type": "string",
       "description": "Scoring model version."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/base-defi-yield-history-risk-score-time-series-8bef9bd5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from intel.fintechhodl.com](https://www.zero.xyz/host/intel.fintechhodl.com/llms.txt)