Skip to main content
GET
List
Return every wallet CabalSpy tracks for a given chain and wallet type. Each entry carries the public profile (display name, avatar, Twitter/Telegram and the copytrade link) so you can label wallets across your terminal. This is the starting point of most integrations: fetch the list once, cache the profiles, then resolve those addresses against the token and transaction endpoints.
Without a limit you get all wallets in a single response. For paged loading, set limit and walk through pages using the next_cursor from the previous response. Addresses are sorted alphabetically, so pagination stays deterministic.

Query Parameters

string
required
Chain of the wallets. One of solana, bnb, base, eth, rh (Robinhood Chain).
string
required
Wallet category kol, smart or whale. Availability per chain. Solana has kol, smart, whale. BNB, Base and Robinhood Chain (rh) have kol, smart. ETH has kol.
integer
Maximum number of wallets per page. Omit to return all wallets in one response.
string
Cursor for the next page, the pagination.next_cursor value from the previous response. Empty means from the start.
string
Your API key, required on https://api.cabalspy.xyz. Alternatively pass it as an Authorization Bearer header. Not needed on the demo server https://demo-api.cabalspy.xyz.
Try it without an API key: Try it runs on the demo server https://demo-api.cabalspy.xyz (20 requests per IP per day, data delayed 15 minutes, at most 5 rows), so you can send a request without a key. For live data, switch the server to https://api.cabalspy.xyz and enter your API key. Your own integration always calls api.cabalspy.xyz with your API key, as in the usage examples below. Get a free key · About the demo

Usage Example

Response

boolean
True on success.
object

Errors