# GenVox Crypto Sentiment API

> GenVox Crypto Sentiment API is a paid API for AI agents from api.genvox.io, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-12).

Returns real-time Reddit-based sentiment score, signal, and top posts for major cryptocurrencies like BTC, ETH, and SOL

## Facts

- Endpoint: GET https://api.genvox.io/v1/sentiment?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-genvox-io-19d5a57a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UvyT5rLPVDpcaZhIUUS42

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-genvox-io-19d5a57a
```

Example prompt: What's the current Reddit sentiment on Bitcoin — is the community bullish or bearish, and what are the top posts driving that signal?

## When to prefer this

Choose this endpoint when you need real-time, Reddit-sourced sentiment analysis for popular cryptocurrencies with confidence scoring and supporting post evidence. It is specifically suited for agents that need to ground sentiment signals in actual community discourse rather than price-based indicators or Twitter/X data. Ideal for crypto trading assistants, market mood dashboards, or research tools that need VADER-scored NLP results with source traceability.

## Known failure modes

- Unsupported coin symbol returns an error or empty result
- Reddit API rate limits or downtime may cause stale or missing data
- Low post volume for smaller coins reduces confidence and accuracy
- Payment not processed (x402 flow failure) blocks the response
- Network timeout if Reddit crawl takes too long

## How this service works

Real-time crypto sentiment analysis powered by Reddit...

## Output

Returns a JSON object with the coin symbol and name, a numeric sentiment score (e.g. 0.271), a human-readable signal (BULLISH/BEARISH/NEUTRAL), confidence percentage, a plain-English summary, the analyzer used (VADER), and a ranked list of top Reddit posts with their titles, subreddits, engagement counts, and individual sentiment scores.

## Example request

```json
{
 "query": "{\\\"input\\\": {\\\"type\\\": \\\"http\\\", \\\"method\\\": \\\"GET\\\", \\\"queryParams\\\": {}}}"
}
```

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "coin",
  "name",
  "score",
  "signal",
  "source",
  "summary",
  "analyzer",
  "topPosts",
  "timestamp",
  "confidence",
  "neutralCount",
  "negativeCount",
  "paymentAmount",
  "paymentStatus",
  "positiveCount",
  "postsAnalyzed",
  "neutralPercent",
  "paymentNetwork",
  "negativePercent",
  "positivePercent",
  "scoreExplanation",
  "confidencePercent",
  "subredditsScanned"
 ],
 "properties": {
  "coin": {
   "type": "string"
  },
  "name": {
   "type": "string"
  },
  "score": {
   "type": "number"
  },
  "signal": {
   "type": "string"
  },
  "source": {
   "type": "string"
  },
  "summary": {
   "type": "string"
  },
  "analyzer": {
   "type": "string"
  },
  "topPosts": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "rank",
     "title",
     "sentiment",
     "subreddit",
     "engagement",
     "sentimentScore"
    ],
    "properties": {
     "rank": {
      "type": "number"
     },
     "title": {
      "type": "string"
     },
     "sentiment": {
      "type": "string"
     },
     "subreddit": {
      "type": "string"
     },
     "engagement": {
      "type": "number"
     },
     "sentimentScore": {
      "type": "string"
     }
    }
   }
  },
  "timestamp": {
   "type": "string"
  },
  "confidence": {
   "type": "number"
  },
  "neutralCount": {
   "type": "number"
  },
  "negativeCount": {
   "type": "number"
  },
  "paymentAmount": {
   "type": "string"
  },
  "paymentStatus": {
   "type": "string"
  },
  "positiveCount": {
   "type": "number"
  },
  "postsAnalyzed": {
   "type": "number"
  },
  "neutralPercent": {
   "type": "string"
  },
  "paymentNetwork": {
   "type": "string"
  },
  "negativePercent": {
   "type": "string"
  },
  "positivePercent": {
   "type": "string"
  },
  "scoreExplanation": {
   "type": "string"
  },
  "confidencePercent": {
   "type": "string"
  },
  "subredditsScanned": {
   "type": "array",
   "items": {
    "type": "string"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-genvox-io-19d5a57a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.genvox.io](https://www.zero.xyz/host/api.genvox.io/llms.txt)