# SperaxOS DeFi Portfolio Data API

> SperaxOS DeFi Portfolio Data API is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-20).

Retrieves DeFi portfolio data for a wallet address using AI-powered intelligence, payable per-request with USDC via x402

## Facts

- Endpoint: GET https://chat.sperax.io/api/x402/v1/data/portfolio?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-defi-portfolio-data-api-e1c1c0cb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_j33CB4UAUJqbrTsU4zdsm

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 speraxos-defi-portfolio-data-api-e1c1c0cb
```

Example prompt: Pull up my DeFi portfolio for wallet address 0xABC123... on Base and show me all my positions, token holdings, and their current values.

## When to prefer this

Choose this endpoint when you need real-time DeFi portfolio intelligence for a specific wallet address and want pay-per-request pricing without API key setup. Ideal for agents that need on-demand portfolio snapshots without a subscription, leveraging x402 micropayment infrastructure on Base.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Insufficient USDC payment via x402 results in 402 Payment Required response
- Wallet with no DeFi activity may return empty portfolio
- Network timeout if on-chain data aggregation takes too long
- Unsupported chain or protocol may result in incomplete data

## How this service works

AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.

## Output

Returns structured DeFi portfolio data for the queried wallet address, including token balances, protocol positions, current values, yield data, and allocation breakdowns across DeFi protocols on Base and potentially other supported chains.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-defi-portfolio-data-api-e1c1c0cb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chat.sperax.io](https://www.zero.xyz/host/chat.sperax.io/llms.txt)