# ChainRay Wallet Profile

> ChainRay Wallet Profile is a paid API for AI agents from chainray.online, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Retrieves a comprehensive on-chain intelligence profile for a given wallet address, including balances, transaction history, DeFi positions, and behavioral analytics across multiple blockchains.

## Facts

- Endpoint: GET https://chainray.online/wallet-profile/%7Baddress%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainray-wallet-profile-21d578a3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gtGKABywv9peHDk4EUy2f

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 chainray-wallet-profile-21d578a3
```

Example prompt: Pull up the full on-chain profile for wallet 0x742d35Cc6634C0532925a3b8D4C9C6B9d6e0f1A2 on Ethereum — I want to see their token balances, DeFi positions, and overall activity.

## When to prefer this

Use this endpoint when you need a comprehensive, aggregated on-chain profile of a wallet address — especially when you want multi-chain coverage and DeFi analytics in a single call rather than querying raw node data or piecing together multiple APIs. Ideal for agent workflows that need to assess wallet behavior, portfolio composition, or DeFi exposure quickly and verifiably.

## Known failure modes

- Invalid wallet address format returns a 400 error
- Unsupported chain identifier returns an error indicating the chain is not available
- Wallet address with no on-chain activity returns an empty or minimal profile
- Payment failure via x402 (insufficient USDC balance) returns a 402 Payment Required response
- Rate limiting if requests exceed per-account thresholds

## How this service works

The most complete blockchain data and intelligence service for AI agents. 93 endpoints across 46 chains, from gas fees to DeFi analytics, with real-time streams, intent routing, and verifiable proofs. Pay-per-request via x402.

## Output

A structured wallet intelligence profile including token holdings, native and ERC-20 balances, DeFi protocol positions, recent transaction activity, chain-specific analytics, and behavioral scoring — all aggregated for the specified wallet address on the requested blockchain network.

## 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"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Blockchain network"
      },
      "address": {
       "type": "string",
       "description": "Wallet or contract address"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainray-wallet-profile-21d578a3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainray.online](https://www.zero.xyz/host/chainray.online/llms.txt)