# Lumi Trades Crypto Sentiment

> Lumi Trades Crypto Sentiment is a paid API for AI agents from api.lumitrades.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-28).

Returns a real-time crypto sentiment snapshot including Fear & Greed index, BTC perpetual funding rate, open interest, total market cap, dominance, and breadth signal counts.

## Facts

- Endpoint: GET https://api.lumitrades.io/v1/sentiment?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lumi-trades-crypto-sentiment-252fff79
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HDGmAtxU9zZDptlMx_Jti

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 lumi-trades-crypto-sentiment-252fff79
```

Example prompt: What's the current crypto market sentiment? I want to know the Fear and Greed index, whether it's shifted since yesterday, BTC's funding rate and open interest, and the overall market cap and dominance right now.

## When to prefer this

Choose this endpoint when you need a cheap ($0.005), fast, single-call snapshot of overall crypto market sentiment — specifically the Fear & Greed index, BTC derivatives positioning (funding + open interest), and market cap/dominance breadth — without needing deep per-coin analysis or trading signals. Prefer it over the more expensive Lumi market backdrop ($0.02) when you only need sentiment indicators and not BTC price levels or macro context.

## Known failure modes

- Bad or malformed input returns an error without charging ($0.00)
- Stale data condition returns an error without charging
- API downtime or upstream data provider failure may return 5xx
- Rate limits or payment validation failures may block the request
- If the x402 payment is not correctly submitted, the request will be rejected

## How this service works

Crypto sentiment and positioning snapshot: Fear and Greed index value, band and day-over-day change; BTC perpetual funding rate with a plain-English read and open interest; total market cap and BTC dominance; and 24h breadth across tracked coins. Use when an agent needs a compact read of market sentiment and derivatives positioning. Analytics only, not financial advice. Not charged on stale data.

## Output

A JSON object with: Fear & Greed value (0-100), classification label (e.g. Neutral), previous value and day-over-day change; BTC perpetual funding rate percentage with plain-English interpretation and open interest in USD; total crypto market cap, BTC dominance percentage, and 24h breadth counts (coins up vs down vs total tracked); plus metadata fields: as_of, data_age_seconds, next_update, and stale_after timestamps. Also includes payment receipt details (payer, asset, amount, network, transaction).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kind": "sentiment",
  "as_of": "2026-10-22T11:05:00Z",
  "global": {
   "total_mcap_usd": 2742576601668,
   "btc_dominance_pct": 60.04
  },
  "breadth": {
   "up_24h": 1,
   "down_24h": 13,
   "coins_tracked": 14
  },
  "payment": {
   "asset": "USDC",
   "payer": "0x12ab...89cd",
   "amount": "0.005",
   "network": "eip155:8453",
   "transaction": "0x5f0c...e41a"
  },
  "fear_greed": {
   "value": 49,
   "change": -5,
   "previous": 54,
   "classification": "Neutral"
  },
  "derivatives": {
   "instrument": "BTC-USDT-SWAP (OKX)",
   "funding_rate_pct": 0.00657,
   "open_interest_usd": 2462680121
  },
  "next_update": "2026-10-22T17:05:00Z",
  "stale_after": "2026-10-22T23:05:00Z",
  "data_age_seconds": 600
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lumi-trades-crypto-sentiment-252fff79/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.lumitrades.io](https://www.zero.xyz/host/api.lumitrades.io/llms.txt)