# Tokenguard Brief Market

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

Returns a concise crypto market brief for a given perp symbol, including sentiment score, funding rate, market cap, regime label, and positioning analysis.

## Facts

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

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-brief-market-f9bb2d7b -d '<json body>'
```

Example prompt: What's the current market brief for BTC — is sentiment greedy or fearful, how crowded are longs, and what's the annualized funding rate on perps right now?

## When to prefer this

Use this endpoint when you need a fast, opinionated market brief for a specific crypto perp symbol, combining sentiment, funding rate, and regime in a single call. Prefer this over raw exchange APIs when you want pre-interpreted analyst notes alongside the raw metrics, and when you are building an agent that needs a concise signal rather than raw tick data.

## Known failure modes

- Unknown or unsupported symbol returns an error or empty response
- Symbol defaults to BTC if not provided — may return BTC data unintentionally
- Stale data if underlying data providers are delayed
- Rate limiting or payment failure via x402 micropayment protocol
- Hugging Face Space cold-start latency causing timeout

## How this service works

One-call crypto market regime: total market cap and 24h change, Fear & Greed sentiment, and perp funding/open interest, resolved into risk-on / neutral / risk-off plus a crowded-long / crowded-short positioning read. Surfaces leverage fragility that price alone does not show.

## Output

Returns a JSON object with: market regime (e.g. 'risk-on'), positioning label (e.g. 'crowded_long'), sentiment score (0-100), sentiment label (e.g. 'Greed'), annualized funding rate percentage, market cap in USD, 24h market cap change percentage, and plain-English analyst notes flagging risks like leveraged fragility or flush risk.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "symbol": {
   "type": "string",
   "description": "Perp symbol for positioning (default BTC)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "notes": [
   "funding 41.2%/yr paid by longs — leveraged, fragile to a flush"
  ],
  "regime": "risk-on",
  "positioning": "crowded_long",
  "market_cap_usd": 2410000000000,
  "sentiment_label": "Greed",
  "sentiment_score": 68,
  "funding_annualized_pct": 41.2,
  "market_cap_change_24h_pct": 1.8
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-brief-market-f9bb2d7b/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)
