For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Field
Type
Description

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.json
import 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.

Field
Type
Description

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

Status
Meaning

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