walletLabels (experimental)
Every labelled wallet with its trader tag and market-maker / delta-neutral / new-wallet flags, as one gzip download. Experimental add-on.
Returns the full wallet label list (about 250k wallets) in a single response. The list is refreshed hourly, so polling more often returns the same data. The response header x-fetched-at-ms tells you when the current copy was fetched.
The body is always gzip-compressed (Content-Encoding: gzip, about 6 MB on the wire, about 36 MB decoded). Python requests/httpx, JavaScript fetch, and Rust reqwest decompress it automatically. With cURL, pass --compressed.
Rate limit: 10 requests per 10 minutes per API key, separate from your per-minute points budget.
POST Request
type
string
Must be "walletLabels"
curl --compressed -X POST https://api.hydromancer.xyz/info \
-H "Authorization: Bearer $HYDROMANCER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "walletLabels"}' \
-o wallet_labels.jsonimport os
import requests
response = requests.post(
"https://api.hydromancer.xyz/info",
headers={"Authorization": f"Bearer {os.environ['HYDROMANCER_API_KEY']}"},
json={"type": "walletLabels"},
)
response.raise_for_status()
wallets = response.json() # requests decompresses gzip automatically
print(len(wallets), response.headers["x-fetched-at-ms"])Response
A JSON array with one object per wallet, sorted by address.
address
string
Wallet address, lowercase 0x-prefixed hex
name
string | null
Known name for the wallet, if any
tag
string
Trader classification, for example "New wallet", "+ day", "- swing", "+ intraday", "- scalper"
marketMaker
bool
Wallet is classified as a market maker
deltaNeutral
bool
Wallet is classified as delta-neutral
newWallet
bool
Wallet is classified as new
Errors
403
Your API key does not have the wallet-labels add-on.
429
More than 10 requests in 10 minutes.
503
The list has not loaded yet after a restart. Retry in a few minutes.
Last updated