# HostDeFi Token Risk History

> HostDeFi Token Risk History is a paid API for AI agents from hostdefi.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-11).

Returns daily historical risk grades, scores, price, volume, and liquidity for a token on Solana or EVM chains over up to 365 days

## Facts

- Endpoint: GET https://hostdefi.com/api/v1/x402/token-risk/history/%7Bchain%7D/%7Baddress%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hostdefi-token-risk-history-652fdf32
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ksV9HYmh0ZI0ItZtwpzIv

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 hostdefi-token-risk-history-652fdf32
```

Example prompt: Pull the last 30 days of daily risk grade history for the Solana token at mint address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v — I want to see how the score, price, and liquidity have trended.

## When to prefer this

Use this endpoint when you need time-series risk intelligence for a specific token — such as trend analysis, due diligence before a swap, or monitoring a token's safety grade over days or weeks. It covers both Solana and 7 EVM chains in one API, making it preferable to chain-specific analytics tools. Choose this over a current-snapshot endpoint when historical trend matters, not just the latest grade.

## Known failure modes

- Invalid or unsupported chain ID returns an error
- Malformed token address (wrong format for the chain) returns an error
- Token not found or untracked returns empty rows array
- limit parameter out of range (< 1 or > 365) returns a validation error
- Payment of 0.02 USDC not provided results in 402 response
- Network or upstream data unavailability causes 5xx error

## How this service works

HostDeFi is a non-custodial Solana DEX. Best-route swaps through Jupiter, EVM trading across 7 chains, native bridging, and live token risk grades. No KYC, no accounts, no custody.

## Output

A JSON array of daily rows ordered oldest-first, each containing a timestamp, letter risk grade (e.g. A–F), numeric risk score (0–100), price in USD, 24-hour volume, and liquidity in USD. Also returns the chain identifier, token address, and row count.

## 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": [
      "chain",
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Chain id: solana, ethereum, bsc, base, arbitrum, optimism, polygon, avalanche"
      },
      "address": {
       "type": "string",
       "description": "Token contract address (base58 mint on Solana, 0x… on EVM)"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 365,
       "minimum": 1,
       "description": "Daily rows returned: the most recent N days, oldest first (default 90)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "rows": [
   {
    "ts": "2026-08-16T00:00:00.000Z",
    "grade": "B",
    "score": 78,
    "priceUsd": 0.00001,
    "volume24h": 5000,
    "liquidityUsd": 100000
   }
  ],
  "chain": "solana",
  "count": 1,
  "address": "…"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hostdefi-token-risk-history-652fdf32/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hostdefi.com](https://www.zero.xyz/host/hostdefi.com/llms.txt)