# ADH Energy Price Signals

> ADH Energy Price Signals is a paid API for AI agents from agentdatum.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns quantitative momentum, volatility, z-score, and percentile-rank signals for energy price time series (e.g. WTI crude oil) derived from EIA and other sources

## Facts

- Endpoint: GET https://agentdatum.com/api/v1/d/sig-energy
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/adh-energy-price-signals-bb1100f4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qtZFVvJTw_SD2IKOm56PY

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 adh-energy-price-signals-bb1100f4
```

Example prompt: Can you pull the latest WTI crude oil price signals — I want to see the momentum, 20-day volatility, z-scores against 10 and 30-day windows, and percentile ranks so I can gauge where energy prices stand right now?

## When to prefer this

Choose this endpoint when you need pre-computed quantitative signals (momentum, volatility, z-score, percentile rank) for energy commodities like WTI crude oil, rather than raw price feeds. It is ideal for AI agents that need a ready-to-use signal layer without running their own time-series calculations. Prefer it over raw data APIs when your agent needs context on where prices stand historically (z-score, percentile rank) and how they are trending (momentum, log-return). Best suited for macro regime detection, quantitative trading signals, and energy market briefings.

## Known failure modes

- Payment not settled via x402 — endpoint returns 402 Payment Required if USDC payment is missing or invalid
- Series data temporarily unavailable — status field may return non-'ok' value with reduced or empty history array
- Stale data — generated_at timestamp may lag real-time if upstream EIA source has not updated
- Empty signals array — if no valid data points exist for the requested window, points field may be 0 and z-scores/ranks may be null or 0
- Malformed request — missing required 'type' or 'method' fields in input object returns a validation error

## How this service works

ADH 金融情报层：把 239 个原始数据源洗成带实体解析、时间同步、溯源与派生结论的情报（宏观regime / 加密尽调 / 事件窗口），免费注入你的 AI 上下文。Agent 走 x402 结算，人类订阅（PayPal）即将上线。

## Output

A JSON object containing one or more energy signal records, each with: the series identifier (e.g. energy-eia__DCOILWTICO), last price value, 1-day log return, 4-period momentum, 20-day rolling volatility, z-scores over 10- and 30-day windows, percentile ranks over 10- and 30-day windows, number of data points, a short price history array (timestamp + value), signal status, and metadata including generation timestamp, source label, and data type.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "raw": {
   "method": "x402 signals: log-return momentum / volatility / z-score / percentile rank over time-series library",
   "product": "能源价格信号",
   "signals": [
    {
     "mom_4": 0,
     "ret_1": 0,
     "points": 39,
     "series": "energy-eia__DCOILWTICO",
     "status": "ok",
     "vol_20": 0.005924,
     "history": [
      {
       "ts": 1785283200,
       "value": 86.08
      },
      {
       "ts": 1785283200,
       "value": 86.08
      }
     ],
     "zscore_10": 0,
     "zscore_30": -0.7268,
     "last_value": 81.96,
     "pctrank_10": 0,
     "pctrank_30": 3.3
    },
    {
     "mom_4": 0,
     "ret_1": 0,
     "points": 39,
     "series": "energy-eia__DCOILWTICO",
     "status": "ok",
     "vol_20": 0.005924,
     "history": [
      {
       "ts": 1785283200,
       "value": 86.08
      },
      {
       "ts": 1785283200,
       "value": 86.08
      }
     ],
     "zscore_10": 0,
     "zscore_30": -0.7268,
     "last_value": 81.96,
     "pctrank_10": 0,
     "pctrank_30": 3.3
    }
   ],
   "generated_at": "2026-08-14T00:22:02Z"
  },
  "source": "datum-signals",
  "data_type": "信号指标",
  "collected_at": "2026-08-14T00:22:02Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/adh-energy-price-signals-bb1100f4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdatum.com](https://www.zero.xyz/host/agentdatum.com/llms.txt)