# VectorWay Agent Onboard

> VectorWay Agent Onboard 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).

Onboards an autonomous AI agent via a $1 USDC x402 payment, returning a chat completions API key, funded USDC balance, JWT session, and persistent vector memory namespace derived from the payer wallet.

## Facts

- Endpoint: POST https://api.vectorway.io/v1/auth/agent-onboard
- 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-77222329
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dYqxDz4jm4zm6cr0RAp7Y

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-77222329 -d '<json body>'
```

Example prompt: Onboard me as a new autonomous agent on VectorWay — pay the $1 USDC x402 fee and give me back an API key, a funded balance, a JWT session, and a persistent vector memory namespace tied to my wallet so I can start making Gemini-backed chat completions with memory recall.

## When to prefer this

Choose this endpoint when an autonomous agent needs a complete, self-contained bootstrap in a single atomic x402 payment — getting API key, funded balance, JWT, and vector memory namespace in one call without any prior account registration. Ideal for walletless-to-ready agent provisioning workflows where the payer wallet doubles as the persistent memory namespace.

## Known failure modes

- Payment insufficient or invalid x402 signature — 402 Payment Required
- Payment exceeds $1000 max balance cap — 400 Bad Request
- Wallet derivation fails due to malformed signed payment — 400 Bad Request
- Gemini backend unavailable — 503 Service Unavailable
- Duplicate onboard attempt with same wallet — may return existing session or conflict error

## How this service works

Onboard an autonomous AI agent in one x402 USDC payment: receive a chat completions API key, a USDC-funded balance, a JWT session, and persistent vector memory. Authenticates against a Gemini-backed LLM runtime with optional RAG-style memory recall + write per call, plus semantic memory search and delete. Wallet is derived from the signed payment; balance is atomic USDC ($0.000001/unit, max $1000).

## Output

Returns a chat completions API key (OpenAI-compatible), a USDC-funded balance (in $0.000001 units, up to $1000), a JWT session token, and a persistent vector memory namespace derived from the signed payment wallet — enabling immediate authenticated calls to the Gemini LLM runtime with RAG-style memory.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "credits": {
   "type": "integer",
   "maximum": 1000000000,
   "minimum": 1000,
   "description": "Atomic USDC to pre-fund the agent account with (1_000_000 = $1.00). The balance is debited per chat call against a Gemini-backed LLM runtime with optional RAG-style vector memory recall + write. Calls are billed by real input/output tokens × Vertex list prices × the operator's discount multiplier."
  },
  "key_name": {
   "type": "string",
   "maxLength": 64,
   "minLength": 1,
   "description": "Optional human-readable label for the returned API key. The key authenticates the agent against the chat completions and memory endpoints; the label is shown in the Vectorway dashboard alongside the key id."
  },
  "agent_only": {
   "type": "boolean",
   "description": "True (default) creates a headless agent-only account with no Privy email/social login, suitable for autonomous LLM agents. False allows the same wallet to later log into the dashboard via SIWE."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tokens": {
   "expires_in": 900,
   "token_type": "bearer",
   "access_token": "<jwt>",
   "refresh_token": "<jwt>"
  },
  "api_key": "vw_<id>_<secret>",
  "created": true,
  "credits": 1000000,
  "agent_only": true,
  "wallet_address": "0xC0FFEE0000000000000000000000000000000001",
  "api_key_metadata": {
   "key_id": "<id>",
   "key_name": "my-agent",
   "created_at": 1730000000,
   "last_used_at": null
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-vectorway-io-77222329/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)