# Venice AI Usage Analytics

> Venice AI Usage Analytics is a paid API for AI agents from api.venice.ai, paid per call via x402, $10/call, status unknown (last checked 2026-10-11).

Returns aggregated API usage analytics for the authenticated user, broken down by date, model, and API key, with daily trend data.

## Facts

- Endpoint: GET https://api.venice.ai/api/v1/billing/usage-analytics?utm_source=zero.xyz
- Price: $10/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402, ai_ml
- Canonical page: https://www.zero.xyz/c/venice-ai-usage-analytics-0eec6857
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gUWUOg47btyfW_lifyzM-

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 venice-ai-usage-analytics-0eec6857
```

Example prompt: Can you pull my Venice AI usage analytics for the last 30 days and show me the breakdown by model and API key — I want to see which models and keys are driving the most spend?

## When to prefer this

Use this endpoint when you need aggregated, dashboard-ready usage summaries with multi-dimensional breakdowns (by date, model, and key) rather than raw paginated transaction logs. Prefer this over the sibling Usage endpoint when you need trend data, top-model rankings, or daily time series. Ideal for building usage dashboards or cost monitoring alerts.

## Known failure modes

- Missing or invalid auth token returns 401 Unauthorized
- If startDate is provided without endDate (or vice versa), returns 400 Bad Request
- Lookback period exceeding 90d returns 400 Bad Request
- Invalid date format (not YYYY-MM-DD) returns 400 Bad Request
- Beta instability may cause intermittent 500 errors or schema changes without notice
- Cached data may be up to 10 minutes stale

## How this service works

**Beta**: This endpoint is currently in beta and may be unstable. Request/response schemas and behavior may change without notice.

Get aggregated usage analytics for the authenticated user with breakdowns by date, model, and API key. This endpoint provides summary views of your API usage, ideal for dashboards and usage monitoring. Data is cached for 10 minutes.

## Output

Returns a JSON object with: daily usage arrays (USD and DIEM per day), per-model breakdowns (total USD, DIEM, units, input vs output split), per-API-key totals, daily model trends, daily key trends, top model names, top key names, and the lookback period used. Data is cached for 10 minutes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "endDate": {
   "type": "string",
   "example": "2024-01-01",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
   "description": "End date for filtering records (YYYY-MM-DD). If provided, startDate is also required."
  },
  "lookback": {
   "type": "string",
   "default": "7d",
   "example": "7d",
   "pattern": "^[1-9]\\d*d$",
   "description": "Lookback period for usage data. Format: number followed by \"d\" (e.g., \"7d\", \"30d\"). Maximum: 90d"
  },
  "startDate": {
   "type": "string",
   "example": "2024-01-01",
   "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
   "description": "Start date for filtering records (YYYY-MM-DD). If provided, endDate is also required."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "example": {
  "byKey": [
   {
    "apiKeyId": "key_abc123",
    "totalUsd": 0.8,
    "totalDiem": 15,
    "totalUnits": 75000,
    "description": "Production Key"
   },
   {
    "apiKeyId": null,
    "totalUsd": 0,
    "totalDiem": 4,
    "totalUnits": 25000,
    "description": "Web App"
   }
  ],
  "byDate": [
   {
    "USD": 0.5,
    "DIEM": 10.25,
    "date": "2024-01-15T00:00:00.000Z"
   },
   {
    "USD": 0.3,
    "DIEM": 8.75,
    "date": "2024-01-14T00:00:00.000Z"
   }
  ],
  "byModel": [
   {
    "totalUsd": 0.4,
    "unitType": "tokens",
    "breakdown": [
     {
      "usd": 0.3,
      "diem": 10,
      "type": "Output",
      "units": 35000
     },
     {
      "usd": 0.1,
      "diem": 2.5,
      "type": "Input",
      "units": 15000
     }
    ],
    "modelName": "GLM 5.1",
    "modelType": "LLM",
    "totalDiem": 12.5,
    "totalUnits": 50000
   }
  ],
  "lookback": "7d",
  "topModels": [
   "GLM 5.1",
   "Kimi K2.6"
  ],
  "byKeyDaily": [
   {
    "date": 1705276800000,
    "Web App": 2,
    "Production Key": 8.5
   }
  ],
  "topKeyNames": [
   "Production Key",
   "Web App"
  ],
  "byModelDaily": [
   {
    "date": 1705276800000,
    "GLM 5.1": 5.5,
    "Kimi K2.6": 3.2
   }
  ]
 },
 "required": [
  "lookback",
  "byDate",
  "byModel",
  "byModelDaily",
  "topModels",
  "byKey",
  "byKeyDaily",
  "topKeyNames"
 ],
 "properties": {
  "byKey": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "apiKeyId",
     "description",
     "totalUsd",
     "totalDiem",
     "totalUnits"
    ],
    "properties": {
     "apiKeyId": {
      "type": "string",
      "nullable": true,
      "description": "API key ID, or null if usage was from web app"
     },
     "totalUsd": {
      "type": "number",
      "description": "Total USD usage for this key"
     },
     "totalDiem": {
      "type": "number",
      "description": "Total DIEM usage for this key"
     },
     "totalUnits": {
      "type": "number",
      "description": "Total units consumed for this key"
     },
     "description": {
      "type": "string",
      "example": "My Production Key",
      "description": "API key description or \"Web App\""
     }
    }
   },
   "description": "Usage breakdown by API key, sorted by total spend (highest first)"
  },
  "byDate": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "date",
     "USD",
     "DIEM"
    ],
    "properties": {
     "USD": {
      "type": "number",

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/venice-ai-usage-analytics-0eec6857/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.venice.ai](https://www.zero.xyz/host/api.venice.ai/llms.txt)