# YRUZ IP Lookup Utility

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

Returns IP address information for the caller or a specified request via the YRUZ platform utility API.

## Facts

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

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-ip-lookup-utility-774455dc -d '<json body>'
```

Example prompt: What is my current public IP address? Use the YRUZ IP utility to look it up right now.

## When to prefer this

Choose this endpoint when you need a quick, pay-per-use IP address lookup via the x402 micropayment protocol and are already integrated with the YRUZ platform or bazaar ecosystem. Useful for agents that need to programmatically determine their outbound IP without maintaining a separate IP-lookup service subscription.

## Known failure modes

- Empty result object if IP metadata is unavailable
- HTTP 402 if payment is not attached or insufficient
- Network timeout if the YRUZ platform is unavailable
- Malformed request body returns an error
- Missing required 'input' field causes validation failure

## 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 'ip' and a 'result' object containing IP address information for the caller, such as the detected public IP and any associated metadata the service provides.

## 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": {
    "body": {
     "type": "object",
     "properties": {}
    },
    "type": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "POST"
     ]
    },
    "bodyType": {
     "const": "json"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yruz-ip-lookup-utility-774455dc/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)