# YRUZ Wallet Lookup

> YRUZ Wallet Lookup is a paid API for AI agents from yruz.one, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-21).

Looks up or validates a Solana or Base blockchain wallet address and returns wallet-related information via the YRUZ platform.

## Facts

- Endpoint: POST https://yruz.one/api/wallet?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yruz-wallet-lookup-ed4ecd1c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_FkbOnNVQM7fa5tUutqI86

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 yruz-wallet-lookup-ed4ecd1c -d '<json body>'
```

Example prompt: Can you look up wallet info for the Solana address 4Zw1fXuYuJhWhu9KLEYMhiPEiqcpKd6akw3WRZt4a5 on YRUZ?

## When to prefer this

Use this endpoint when you need to look up or validate a Solana or Base blockchain wallet address within the YRUZ platform context, especially when already integrating with YRUZ social or community features and needing wallet identity verification as part of that workflow.

## Known failure modes

- Missing required 'address' field returns an error
- Invalid or malformed wallet address (non-base58 for Solana or non-0x for Base) may return empty result or error
- Payment of 0.002 USDC required; missing payment returns 402
- Network timeout or service unavailability returns 5xx

## How this service works

YRUZ is a free social network: create a profile, join public groups, attend events, read free guides on community building and creator income.

## Output

Returns a JSON object with a 'tool' field set to 'wallet' and a 'result' object containing wallet-related data for the provided address. The result structure is minimal and may include validation or metadata about the wallet.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "amount": {
   "type": "string",
   "description": "optional USDC price to test, e.g. 0.01"
  },
  "address": {
   "type": "string",
   "description": "Solana (base58) or Base (0x) address (required)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "wallet",
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yruz-wallet-lookup-ed4ecd1c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from yruz.one](https://www.zero.xyz/host/yruz.one/llms.txt)
