# xspy Smart Followers List

> xspy Smart Followers List is a paid API for AI agents from xspy.pro, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-08).

Returns a paginated list of high-signal crypto accounts ('smart followers') who follow a given Twitter/X username, including each follower's profile and their own smart-follower count.

## Facts

- Endpoint: GET https://xspy.pro/api/v1/pro/twitter/%7Busername%7D/smart-followers
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xspy-smart-followers-list-d512c0b7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xaKW19HiPVWnW8X_VCPKe

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 xspy-smart-followers-list-d512c0b7
```

Example prompt: Who are the smart followers of @0xDamien on Twitter — show me the high-signal crypto accounts following that handle.

## When to prefer this

Use this endpoint when you need to identify which high-signal, on-chain-active crypto accounts follow a specific Twitter/X user — ideal for KOL vetting, influence mapping, or understanding the quality of an account's audience. Prefer this over raw follower count endpoints when signal quality (not volume) matters.

## Known failure modes

- Username not found or account does not exist — likely returns resolved:false or empty data array
- Private or suspended account — may return empty results or an error code
- Payment not received (x402 flow incomplete) — request blocked before data is returned
- Rate limiting or quota exceeded — HTTP 429 or equivalent
- Malformed username in path parameter — HTTP 400 or similar validation error

## How this service works

Real-time KOL intelligence, smart follower graphs, and on-chain token signals from tweets. Pay only for the calls you make in USDC on Base or Solana. Agent-ready, no API keys required.

## Output

A JSON object containing a list of smart followers for the queried Twitter username, including each follower's display name, Twitter handle, Twitter user ID, total follower count, and their own smart follower count, plus a total count of smart followers found and a resolution status flag.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": 200,
  "data": {
   "meta": {
    "resolved": true
   },
   "totalCount": 13,
   "smartFollowers": [
    {
     "name": "Damien",
     "twitter": "0xDamien",
     "twitterId": "837985489",
     "followersCount": 30123,
     "smartFollowersCount": 837
    }
   ]
  },
  "status": true,
  "message": "success"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xspy-smart-followers-list-d512c0b7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from xspy.pro](https://www.zero.xyz/host/xspy.pro/llms.txt)
