# EthyAI Token Score

> EthyAI Token Score is a paid API for AI agents from api.ethyai.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Returns a composite 0-100 Ethy Score for a crypto token with a component breakdown rating its overall quality or risk profile.

## Facts

- Endpoint: POST https://api.ethyai.app/paid/v1/base/score
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-ethyai-app-d5c3b28c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i_H65dvH_leHCabQOH6jN

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-d5c3b28c -d '<json body>'
```

Example prompt: What's the Ethy composite score for the AERO token on Base? Give me the full component breakdown so I can see how it's rated.

## When to prefer this

Use this endpoint when you need a single, holistic quality or risk score for a token rather than raw technical indicators. It is ideal when a user wants a quick, interpretable rating (0-100) with component transparency rather than raw RSI/MACD values. Prefer this over the technical indicators endpoint when the goal is overall token evaluation or due diligence rather than timing a trade entry.

## Known failure modes

- Unknown or unsupported token symbol returns an error or null score
- Invalid blockchain/network identifier causes a 400 error
- Token too new or illiquid to be scored returns incomplete component data
- Payment not processed correctly (x402 flow failure) results in 402 or auth error
- Server-side data unavailability causes 500 or timeout

## Output

A composite score between 0 and 100 (the 'Ethy Score') representing the overall quality or risk rating of the token, along with a breakdown of the individual component scores that contributed to the final composite rating.

## Example request

```json
{
 "asset": "AERO",
 "chain": "base"
}
```

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "asset",
  "chain",
  "score",
  "rationale",
  "timestamp",
  "components"
 ],
 "properties": {
  "asset": {
   "type": "string"
  },
  "chain": {
   "type": "string"
  },
  "score": {
   "type": "number"
  },
  "rationale": {
   "type": "string"
  },
  "timestamp": {
   "type": "string"
  },
  "components": {
   "type": "object",
   "required": [
    "momentum",
    "structure",
    "technical",
    "volatility"
   ],
   "properties": {
    "momentum": {
     "type": "number"
    },
    "structure": {
     "type": "number"
    },
    "technical": {
     "type": "number"
    },
    "volatility": {
     "type": "number"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-ethyai-app-d5c3b28c/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)