# 2s Wallet Prediction API

> 2s Wallet Prediction API is a paid API for AI agents from 2s.io, paid per call via x402, $0.004998/call, status unknown (last checked 2026-09-14).

Predicts or analyzes a blockchain wallet address, returning ground-truth insights about the wallet proxy.

## Facts

- Endpoint: GET https://2s.io/api/predict/wallet
- Price: $0.004998/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-wallet-prediction-api-bbd1eec1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Bj3IXvUL85a-4oj1boMgP

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 2s-wallet-prediction-api-bbd1eec1
```

Example prompt: Can you predict and analyze this wallet address for me: 0x1234abcd5678ef901234abcd5678ef901234abcd — I want to know what kind of wallet it is and any risk or behavioral insights about it.

## When to prefer this

Use this endpoint when you need AI-agent-accessible, pay-per-call ground-truth prediction or analysis for a specific blockchain wallet address without requiring API key signup. Prefer this over other wallet analytics services when using x402/USDC micropayments or when integrating into an autonomous agent pipeline that needs on-demand wallet intelligence.

## Known failure modes

- Missing or invalid 'address' query parameter returns a 400 or validation error
- Address too short (< 8 chars) or too long (> 60 chars) fails schema validation
- Unrecognized or unsupported chain address format may return empty or error result
- Payment not fulfilled via x402/USDC returns 402 Payment Required
- Network or upstream data source unavailable returns 5xx error

## How this service works

A Polymarket trader's portfolio by wallet address: total portfolio USD value plus open positions (market title, outcome, size, average vs current price, current value, and unrealized PnL). For tracking a wallet's prediction-market book. Read-only from Polymarket's Data API.

## Output

Returns a prediction or analytical profile for the given wallet (proxy) address, potentially including wallet type classification, behavioral predictions, risk signals, or ground-truth metadata about the address sourced from 2s.io's data 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "maxLength": 60,
       "minLength": 8,
       "description": "Wallet (proxy) address."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-wallet-prediction-api-bbd1eec1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)