# APEX Faucet Wallet Portfolio Lookup

> APEX Faucet Wallet Portfolio Lookup is a paid API for AI agents from apexfaucet.xyz, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-10).

Returns a full on-chain portfolio summary for a given X1 wallet address, including PnL, positions, top winners and losers.

## Facts

- Endpoint: GET https://apexfaucet.xyz/api/x402/wallet/%7Baddress%7D?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apex-faucet-wallet-portfolio-lookup-b9d9ec8d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eRAvpRqqktzHWwfY_m7gc

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 apex-faucet-wallet-portfolio-lookup-b9d9ec8d
```

Example prompt: Pull up the full portfolio summary for X1 wallet HYiepS7mNCVVKoaDmZLQ6rNtMWHTQqKheM1NLGn1 — I want to see the win rate, total PnL, and top positions.

## When to prefer this

Use this endpoint when you need a comprehensive on-chain portfolio and PnL summary for a specific X1 wallet address. It is ideal for evaluating trader performance, screening smart money wallets, or reviewing your own holdings on the X1 chain. Prefer this over generic block explorers when you want structured analytics (win rate, top positions, realized vs unrealized PnL) rather than raw transaction data.

## Known failure modes

- Invalid or malformed base58 wallet address returns an error or empty data
- Wallet with no on-chain activity may return empty positions and zero trade counts
- Rate limiting or payment failure results in a 402 or error response
- Network issues with the X1 chain may cause stale or unavailable data

## How this service works

Free APEX on X1, and free USDC plus APEX on Arc, three times a day. No gas, no sign-up. Plus a swap, a screener, APEX City and token checks.

## Output

Returns a JSON object with ok: true, a paid amount (0.004 USDC), and a data object containing the wallet address, a summary (win rate, total trades, winners, losers, total PnL in XNT, realized PnL, unrealized PnL, current portfolio value), an array of current positions, top winners, and top losers.

## 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",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "X1 wallet address (base58)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "properties": {
   "ok": {
    "type": "boolean"
   },
   "data": {
    "type": "object"
   },
   "paid": {
    "type": "number"
   }
  }
 },
 "example": {
  "ok": true,
  "data": {
   "addr": "HYiepS7mNCVVKoaDmZLQ6rNtMWHTQqKheM1NLGn1…",
   "summary": {
    "losers": 0,
    "winRate": 100,
    "winners": 2,
    "heldAtLoss": 2,
    "tokenCount": 7,
    "totalPnlXnt": -15.17119355322834,
    "totalTrades": 2037,
    "winRateBasis": "positions of at least 0.1 XNT, closed pr…",
    "heldAtLossXnt": -18.4727611645249,
    "totalRealizedXnt": 1.240383755101552,
    "totalUnrealizedXnt": -16.41157730832989,
    "totalCurrentValueXnt": 37.12696953383886
   },
   "positions": [
    {}
   ],
   "topLosers": [],
   "topWinners": [
    {}
   ]
  },
  "paid": 0.004
 }
}
```

## More

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