# SperaxOS Four.meme Top Holders Lookup

> SperaxOS Four.meme Top Holders Lookup is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-19).

Returns the top token holders for a given BSC token contract on the Four.meme platform, ranked by holding size.

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/tools/four-meme/getTopHolders?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-four-meme-top-holders-lookup-1ab2f913
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ESpvrT6PGQz3CS9Vo9rAp

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-four-meme-top-holders-lookup-1ab2f913 -d '<json body>'
```

Example prompt: Who are the top 15 holders of the BSC token at contract address 0x1234567890abcdef1234567890abcdef12345678 on Four.meme?

## When to prefer this

Use this endpoint when you need on-chain holder distribution data specifically for tokens traded on the Four.meme platform on BSC, paid per-request with USDC via x402 and without needing a traditional API key. Prefer this over general blockchain explorers when you want structured, ranked holder data directly consumable by an AI agent.

## Known failure modes

- Invalid or malformed token contract address returns an error
- Token address not found on Four.meme or BSC returns empty or 404-style response
- Limit parameter out of expected range may cause unexpected behavior
- Payment via x402 fails if wallet has insufficient USDC on Base
- Rate limiting or network congestion on BSC may delay response

## 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

An ordered list of the top N wallet addresses holding the specified BSC token, including their holdings amounts and relative share of supply, drawn from Four.meme on-chain data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Max holders to return (default 10)."
  },
  "tokenAddress": {
   "type": "string",
   "description": "BSC token contract address (0x…)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-four-meme-top-holders-lookup-1ab2f913/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)