# Venice AI x402 Credit Top-Up

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

Tops up a Venice AI credit balance using an x402 micropayment (USDC on Base or Solana), returning the credited amount and new balance.

## Facts

- Endpoint: POST https://api.venice.ai/api/v1/x402/top-up?utm_source=zero.xyz
- Price: $5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/venice-ai-x402-credit-top-up-f70357b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e5f1v6dlCqhrrNMxg3wla

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-x402-credit-top-up-f70357b9 -d '<json body>'
```

Example prompt: Top up my Venice AI credit balance using USDC so I can run inference — send the x402 payment now and tell me my new balance once it goes through.

## When to prefer this

Use this endpoint when an agent needs to fund a Venice AI account before calling inference endpoints (chat, image, audio, video). It is the canonical x402 payment entry point for Venice AI and accepts both Base and Solana USDC. Prefer this over any other top-up mechanism when operating in an x402-aware payment flow.

## Known failure modes

- Missing PAYMENT-SIGNATURE header returns 402 with Base and Solana USDC payment requirements
- Invalid or malformed payment signature returns 400/402 error
- Insufficient USDC in paying wallet causes payment rejection
- Network mismatch (wrong chain) causes payment failure
- Duplicate payment replay may be rejected

## How this service works

Add USDC credits via x402 payment.

## Output

Returns a success object with the payment ID, wallet address that was credited, the amount credited in USD, and the updated total balance in USD after the top-up.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {},
 "description": "No body fields are required. Payment is supplied via the PAYMENT-SIGNATURE header; send an empty object to discover payment requirements.",
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success",
  "data"
 ],
 "properties": {
  "data": {
   "type": "object",
   "required": [
    "walletAddress",
    "amountCredited",
    "newBalance",
    "paymentId"
   ],
   "properties": {
    "paymentId": {
     "type": "string",
     "example": "payment_01HZY8M4W4Y6QZ8B6Q4P0V3J2K",
     "description": "Unique identifier for the x402 payment."
    },
    "newBalance": {
     "type": "number",
     "example": 22.5,
     "description": "Updated wallet balance in USD after the top-up."
    },
    "walletAddress": {
     "type": "string",
     "example": "0xyour_wallet_address",
     "description": "Wallet that received the credited balance."
    },
    "amountCredited": {
     "type": "number",
     "example": 10,
     "description": "Amount credited to the wallet in USD."
    }
   },
   "additionalProperties": false
  },
  "success": {
   "enum": [
    true
   ],
   "type": "boolean"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/venice-ai-x402-credit-top-up-f70357b9/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)