# TokenGuard Price API

> TokenGuard Price API is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns the current USD price, liquidity depth, and 24-hour price change for a given crypto token symbol

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/price
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-price-api-01aa4703
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1le8UkPGyHkbGnq1et1M8

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 tokenguard-price-api-01aa4703 -d '<json body>'
```

Example prompt: What's the current USD price and liquidity situation for WETH — is the market deep enough to trade, or is it thin right now?

## When to prefer this

Choose this endpoint when you need a quick, low-cost ($0.005/call) on-chain price lookup for a specific ERC-20/DeFi token including liquidity depth and short-term price momentum, especially within an agent workflow that already uses x402 micropayments on Base and needs DeFi-native data rather than a general exchange ticker.

## Known failure modes

- Unknown or unsupported token symbol returns an error or empty result
- HuggingFace Spaces cold-start latency may cause timeout on first request
- Stale or unavailable on-chain data may return outdated price
- Payment failure via x402 micropayment blocks the request
- Rate limiting or capacity issues on the HuggingFace Space infrastructure

## How this service works

Live token price, liquidity, FDV, 24h volume & change via DEX aggregation.

## Output

A JSON object containing the token symbol, current price in USD, total liquidity in USD, a boolean flag indicating whether liquidity is thin, and the percentage price change over the past 24 hours.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon",
    "bsc"
   ],
   "type": "string",
   "description": "Preferred chain (default base)"
  },
  "address": {
   "type": "string",
   "description": "Token contract address (0x…40 hex)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "symbol": "WETH",
  "price_usd": "1669.94",
  "liquidity_usd": 99000000,
  "thin_liquidity": false,
  "price_change_24h_pct": -0.46
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-price-api-01aa4703/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)