# RobinX Smart Holders

> RobinX Smart Holders is a paid API for AI agents from api.robinx.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns token holders with a measured cross-chain extraction and deployer history, indexed only by RobinX on Robinhood Chain (chain 4663)

## Facts

- Endpoint: GET https://api.robinx.io/structure/:token/smart-holders
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/robinx-smart-holders-44f71d43
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h5h-8TC3B0LwIgClS6fl-

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 robinx-smart-holders-44f71d43
```

Example prompt: Pull up the smart holders for token 0xcdfc08a1c1fbafb355645e5ddc32122e5716ca90 on Robinhood Chain — I want to see which wallets have a strong deployer score and low extractor rank percentile.

## When to prefer this

Use this endpoint when you need to go beyond raw holder lists and assess the behavioral quality of token holders on Robinhood Chain — specifically when you want wallets cross-referenced against deployer credibility and extraction history. Prefer this over generic holder endpoints when vetting token legitimacy, identifying smart money, or filtering out extractive actors. Not suitable for chains other than Robinhood Chain (4663).

## Known failure modes

- Token contract address not found or not indexed on Robinhood Chain — returns empty data array
- Invalid or malformed token address in path parameter — may return 400 or empty response
- Token has no holder snapshots yet — smart_holders array will be empty
- Rate limiting or payment failure via x402 protocol — call blocked
- Network latency on chain 4663 data freshness — scores may lag recent on-chain activity

## How this service works

Holders with a measured chain-wide extraction/deployer history — the cross-reference only RobinX indexes

## Output

A list of wallet addresses currently holding the specified token, each annotated with a deployer record score (0–100 numeric rating of on-chain deployer credibility) and an extractor rank percentile (lower percentile = less extractive behavior), sourced from RobinX's cross-chain snapshot index on Robinhood Chain (chain 4663).

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "queryParams": {
     "type": "object",
     "required": [
      "token"
     ],
     "properties": {
      "token": {
       "type": "string",
       "description": "token contract address 0x…"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "data": {
      "smart_holders": [
       {
        "address": "0xcdfc08a1c1fbafb355645e5ddc32122e5716ca90",
        "deployer_record": {
         "score": 78
        },
        "extractor_rank_pct": 3
       }
      ]
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/robinx-smart-holders-44f71d43/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.robinx.io](https://www.zero.xyz/host/api.robinx.io/llms.txt)