# AgentDrives Credit Top-Up

> AgentDrives Credit Top-Up is a paid API for AI agents from agentdrives.com, paid per call via x402, $6.05/call, status unknown (last checked 2026-10-26).

Purchase API credits for AgentDrives by topping up your account balance with a one-time USDC payment, receiving an API key in return.

## Facts

- Endpoint: POST https://agentdrives.com/api/credits/topup?utm_source=zero.xyz
- Price: $6.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-26
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentdrives-credit-top-up-b2536ced
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TCJvMXjmpTS-Xbi2NqgbG

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

Example prompt: Top up my AgentDrives account with $20 of credits — my agent is called 'ResearchBot' — so I have enough calls for the next batch of tasks.

## When to prefer this

Use this endpoint when an AI agent needs to self-provision or refund its AgentDrives account using an x402 micropayment. Prefer this over manual dashboard top-ups when running in fully automated, agent-driven workflows where a human is not available to log in. It is the only way to obtain a valid AgentDrives API key programmatically.

## Known failure modes

- Payment declined or USDC transfer fails — no credits or key issued
- Invalid amount_usd value (must be 5, 20, or 50) — returns validation error
- Balance is not low and force flag is not set — top-up rejected with balance-not-low error
- Malformed buyer invoice fields — validation error on vat_id or country
- API key shown only once — if not stored immediately it cannot be retrieved again

## How this service works

Prepaid credit for AgentDrives tool searches: $5 buys 500, $20 buys 2,000 and $50 buys 5,000. Without a key it returns a new API key that holds the credit. Each search with that key (POST /api/paid/find-tools) takes $0.01 from the balance, with no payment per call.

## Output

Returns a one-time-shown API key (to be stored immediately), the number of calls added, the resulting credit balance in cents, and a payment receipt URL. The key must be passed as the x-api-key header on subsequent AgentDrives API calls.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "agent": {
   "type": "string",
   "description": "Your name as an agent, kept on the new account"
  },
  "buyer": {
   "type": "object",
   "description": "For an invoice: vat_id, country, company, address"
  },
  "force": {
   "type": "boolean",
   "description": "Top up although the balance isn't low"
  },
  "amount_usd": {
   "enum": [
    5,
    20,
    50
   ],
   "description": "US dollars"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "key": {
   "header": "x-api-key",
   "shown_once": true
  },
  "topup": {
   "calls": 500,
   "amount_cents": 500
  },
  "credit": {
   "balance_cents": 500
  },
  "api_key": "<shown once>",
  "payment": {
   "rail": "x402",
   "currency": "usd",
   "receipt_url": "https://agentdrives.com/api/credits/<id>/receipt",
   "amount_cents": 500
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentdrives-credit-top-up-b2536ced/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdrives.com](https://www.zero.xyz/host/agentdrives.com/llms.txt)