# YourAITools Credits Top-Up

> YourAITools Credits Top-Up is a paid API for AI agents from api.youraitools.co, paid per call via x402, $1/call, status unknown (last checked 2026-10-25).

Add $1 USD of credits to a YourAITools account balance for use across AI tools and APIs that accept crypto payments via x402

## Facts

- Endpoint: GET https://api.youraitools.co/credits/v1/topup/1?utm_source=zero.xyz
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-25
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/youraitools-credits-top-up-0ed4dc12
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h2jlm9rShUgtCbR5Aju_8

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 youraitools-credits-top-up-0ed4dc12
```

Example prompt: Top up my YourAITools account balance with $1 of credits using USDC so I can keep calling AI APIs through the x402 directory.

## When to prefer this

Use this endpoint when an AI agent or application needs to programmatically add $1 USD of credits to a YourAITools account balance, especially in automated pipelines where agents need to self-fund access to the x402-compatible AI tools directory. Prefer this over manual top-up when credit management is part of an autonomous agent workflow running on Base or Solana with USDC.

## Known failure modes

- Payment not received or insufficient USDC — top-up not applied, topped_up returns false
- Network or x402 protocol error — request fails to complete
- Account not found or authentication failure — credits cannot be applied
- Blockchain transaction not confirmed — balance may not update immediately

## How this service works

Top up an existing YourAITools credits key: one x402 payment of $1 USDC adds $1.00 of credits. Send the key as Authorization: Bearer <key>. Prepaid API usage only, not refundable.

## Output

Returns a JSON object confirming the top-up, including the pack identifier ('1'), a boolean 'topped_up' flag (true on success), the new balance in USD (e.g. '1.25'), and the amount credited in USD (e.g. '1.00').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {},
     "description": "Search intents: top up api credits, add api balance, prepaid api top up, usdc top up, x402 credits, agent api balance"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "pack": {
       "type": "string"
      },
      "topped_up": {
       "type": "boolean"
      },
      "balance_usd": {
       "type": "string"
      },
      "credited_usd": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pack": "1",
  "topped_up": true,
  "balance_usd": "1.25",
  "credited_usd": "1.00"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/youraitools-credits-top-up-0ed4dc12/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.youraitools.co](https://www.zero.xyz/host/api.youraitools.co/llms.txt)