Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hyreagent.fun/llms.txt

Use this file to discover all available pages before exploring further.

POST /traders/token-whales

Identifies the largest holders (whales) of any Solana token and analyzes whether they are accumulating or distributing. Useful for gauging smart money sentiment. Price: $0.003 per request Signal vocabulary: accumulate | distribute | ignore Sources: Solana RPC, Jupiter

Parameters

mint
string
required
Solana token mint address.

Example Request

curl -X POST https://mpp.hyreagent.fun/traders/token-whales \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment>" \
  -d '{"mint": "So11111111111111111111111111111111111111112"}'

Example Response

{
  "data": {
    "mint": "So11111111111111111111111111111111111111112",
    "top_holders": [
      {
        "address": "9WzDX...",
        "balance": 1250000,
        "pct_of_supply": 12.5,
        "value_usd": 187500
      },
      {
        "address": "4kPmR...",
        "balance": 890000,
        "pct_of_supply": 8.9,
        "value_usd": 133500
      }
    ],
    "concentration": {
      "top_5_pct": 38.2,
      "top_10_pct": 52.1,
      "top_20_pct": 67.8
    },
    "total_holders": 4231
  },
  "insight": "Top 5 wallets control 38% of supply — moderate concentration. The largest holder (9WzDX) increased their position by 15% this week, signaling active accumulation.",
  "signal": "accumulate",
  "confidence": 0.81,
  "sources": ["solana-rpc", "jupiter"],
  "model_used": "deepseek-v3.2",
  "latency_ms": 876,
  "timestamp": "2026-04-17T10:30:00.000Z"
}

Data Fields