# EthyAI 4H LLM Chart Analysis

> EthyAI 4H LLM Chart Analysis is a paid API for AI agents from api.ethyai.app, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-15).

Uses an LLM to analyze a trading symbol's 4-hour chart and return support/resistance levels, chart patterns, directional bias, and a narrative summary.

## Facts

- Endpoint: POST https://api.ethyai.app/paid/v1/base/analysis
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-ethyai-app-58064460
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-wRYzx1ILqZmQ5mmC0Cak

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 api-ethyai-app-58064460 -d '<json body>'
```

Example prompt: Can you run an LLM chart analysis on Bitcoin (BTC) for the 4-hour timeframe and tell me the key support and resistance levels, any chart patterns you spot, and the overall directional bias?

## When to prefer this

Choose this endpoint when you need a narrative, human-readable AI interpretation of a chart rather than raw numeric indicator values. It is best suited for agents that need to explain market context, identify visual patterns, or generate a directional bias summary on the 4-hour timeframe specifically. Prefer this over the technical indicators endpoint when the goal is a synthesized opinion or chart story rather than individual indicator readings.

## Known failure modes

- Invalid or unsupported symbol returns an error or empty analysis
- Payment not included or insufficient USDC triggers a 402 Payment Required response
- Symbol with insufficient price history may return incomplete analysis
- LLM service timeout results in a 503 or timeout error
- Malformed request body returns a 400 Bad Request

## Output

Returns an AI-generated chart analysis for the specified symbol on the 4-hour timeframe, including identified support and resistance levels, detected chart patterns (e.g. triangles, flags, H&S), directional bias (bullish/bearish/neutral), and a narrative summary of the price action and outlook.

## Example request

```json
{
 "tf": "4h",
 "asset": "BTC",
 "chain": "base"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "tf",
  "asset",
  "chain"
 ],
 "properties": {
  "tf": {
   "type": "string"
  },
  "asset": {
   "type": "string"
  },
  "chain": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "bias",
  "asset",
  "chain",
  "summary",
  "patterns",
  "timeframe",
  "analyzedAt",
  "supportLevels",
  "resistanceLevels"
 ],
 "properties": {
  "bias": {
   "type": "string"
  },
  "asset": {
   "type": "string"
  },
  "chain": {
   "type": "string"
  },
  "summary": {
   "type": "string"
  },
  "patterns": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name",
     "type",
     "confidence"
    ],
    "properties": {
     "name": {
      "type": "string"
     },
     "type": {
      "type": "string"
     },
     "confidence": {
      "type": "number"
     }
    }
   }
  },
  "timeframe": {
   "type": "string"
  },
  "analyzedAt": {
   "type": "string"
  },
  "supportLevels": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "price",
     "strength"
    ],
    "properties": {
     "price": {
      "type": "number"
     },
     "strength": {
      "type": "string"
     }
    }
   }
  },
  "resistanceLevels": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "price",
     "strength"
    ],
    "properties": {
     "price": {
      "type": "number"
     },
     "strength": {
      "type": "string"
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-ethyai-app-58064460/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ethyai.app](https://www.zero.xyz/host/api.ethyai.app/llms.txt)