# Onvexia Social Dominance

> Onvexia Social Dominance is a paid API for AI agents from onvexia.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-17).

Returns social dominance metrics for crypto assets over a specified time window, measuring relative share of social attention across the market.

## Facts

- Endpoint: GET https://onvexia.com/v1/social/dominance
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onvexia-social-dominance-0f6003e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LCS6bsXhKwDAm3HpOV02s

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 onvexia-social-dominance-0f6003e2
```

Example prompt: Pull social dominance data from Onvexia for the past 48 hours — I want to see which crypto assets are commanding the largest share of social attention right now.

## When to prefer this

Choose this endpoint when you need relative social attention share across the crypto market rather than raw mention counts or sentiment scores. It is particularly useful for detecting narrative shifts, tracking which assets are dominating discourse over a configurable lookback window, and comparing social presence across many assets in a single call. Prefer it over general social listening APIs when you need blockchain-native context and cross-asset dominance ranking rather than single-asset social volume.

## Known failure modes

- Empty data array returned when no rows exist for the specified hours window
- Invalid or missing `hours` parameter may return an error or empty result
- Rate limiting or payment failure via x402 protocol if USDC micropayment is not processed
- Endpoint may return incomplete coverage if certain assets are outside Onvexia's tracked universe

## How this service works

Thousands of assets across ten chains, half a million analysed documents, labelled addresses and supply-age history reaching back to 2008 — fused into one reading per asset. REST, SQL, GraphQL and MCP.

## Output

Returns a JSON object with a `data` array containing social dominance records for crypto assets over the requested time window, and a `meta` object describing coverage and provenance including a link to the full OpenAPI spec. An empty data array means no rows exist for the requested range, not that the metric is unsupported.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "hours": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "description": "The result — an array or object depending on the endpoint. An empty array means no rows in range, never that the metric is unsupported."
      },
      "meta": {
       "type": "object",
       "description": "Coverage and provenance: what was measured, and what is not held. A null label means no label is held, never that the subject is safe."
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [],
  "meta": {
   "docs": "https://onvexia.com/openapi.json",
   "endpoint": "/v1/social/dominance"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onvexia-social-dominance-0f6003e2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from onvexia.com](https://www.zero.xyz/host/onvexia.com/llms.txt)