# VectorWay Credits Purchase

> VectorWay Credits Purchase is a paid API for AI agents from api.vectorway.io, paid per call via x402, $1000/call, status unknown (last checked 2026-09-15).

Top up a USDC credit balance for VectorWay's pay-per-call Gemini LLM and vector memory service via x402 payment, crediting the payer's wallet-derived account.

## Facts

- Endpoint: POST https://api.vectorway.io/v1/credits/purchase
- Price: $1000/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-vectorway-io-5d4991d9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Zr3r5Qr7EsDoXlT7mAAfF

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-vectorway-io-5d4991d9 -d '<json body>'
```

Example prompt: Add $5 worth of USDC credits to my VectorWay account so I can use the Gemini chat completions and vector memory API — that's 5000000 atomic units.

## When to prefer this

Use this endpoint when an agent or user needs to pre-fund a VectorWay account with USDC before making pay-per-call Gemini LLM or vector memory requests; ideal when the credit balance is exhausted or when onboarding without a subscription, leveraging the x402 payment protocol to tie credits directly to the payer's wallet.

## Known failure modes

- Invalid or missing x402 signed payment — payment not authorized
- Amount below minimum ($0.001) or above maximum ($1000) — rejected
- Malformed atomic unit amount — validation error
- Payment signature does not match expected buyer wallet — credits not applied
- x402 facilitator unavailable — payment processing failure

## How this service works

Top up the buyer's USDC balance via x402 payment. Funds chat completions on a Gemini-backed LLM runtime with optional RAG-style vector memory recall and write, plus semantic memory search and delete. Wallet is derived from the signed payment so credits always land on the payer's own account. Amount is in atomic USDC ($0.000001/unit, ticket $0.001 to $1000). Chat is billed per token.

## Output

Confirmation that the USDC payment was processed and the corresponding credit amount has been applied to the payer's wallet-derived VectorWay account, ready for use with chat completions and vector memory endpoints.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "credits": {
   "type": "integer",
   "maximum": 1000000000,
   "minimum": 1000,
   "description": "Atomic USDC to add to the buyer's existing balance (1_000_000 = $1.00). Funds chat completions on a Gemini-backed LLM runtime with optional RAG-style vector memory recall and write. Chat is billed per real input/output token, embeddings + memory search are free; the balance is just deducted from the settled per-call USDC amount."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "created": false,
  "credits": 2000000,
  "agent_only": false,
  "wallet_address": "0xC0FFEE0000000000000000000000000000000001"
 }
}
```

## More

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