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 /trenches/token-verdict

Comprehensive risk assessment for any PumpFun token. Combines data from multiple sources — holder distribution, sniper detection, dev wallet history, bonding curve progress, and metadata — into a single AI verdict. This is the most thorough token analysis endpoint, combining the data from /trenches/token, /trenches/token-snipers, and /trenches/curve into one call. Price: $0.015 per request Signal vocabulary: snipe | watch | avoid Sources: Solana RPC, PumpPortal

​
Parameters

​
mint
string
required
Solana token mint address.
​
curve_key
string
Bonding curve account address. Optional — if omitted, the API attempts to derive it from the mint.

​
Example Request

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

​
Example Response

{
  "data": {
    "token": {
      "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "name": "ExampleToken",
      "symbol": "EXT",
      "holders": 847,
      "top_holders_pct": 34.2,
      "dev_wallet": "vhu9Nc7E...",
      "dev_holds_pct": 8.1,
      "freeze_authority": null,
      "mint_authority": null
    },
    "snipers": {
      "count": 3,
      "total_pct": 12.4,
      "risk_level": "medium"
    },
    "curve": {
      "progress_pct": 72.3,
      "sol_in_curve": 234.5,
      "estimated_graduation_hours": 4.2
    }
  },
  "insight": "EXT shows medium risk. 3 sniper wallets hold 12.4% — not catastrophic but worth monitoring. Dev wallet retains 8.1% with no freeze/mint authority. Bonding curve at 72% suggests graduation in ~4 hours. Top 5 holders concentrated at 34%.",
  "signal": "watch",
  "confidence": 0.79,
  "sources": ["solana-rpc", "pumpportal"],
  "model_used": "deepseek-v3.2",
  "latency_ms": 1847,
  "timestamp": "2026-04-17T10:30:00.000Z"
}

​
Verdict Components

The AI considers these factors when generating the verdict:
FactorWeightDescription
Sniper concentrationHighWallets that bought in the first 3 blocks
Dev wallet holdingsHighPercentage of supply held by creator
Freeze/mint authorityCriticalWhether the dev can freeze accounts or mint more tokens
Top holder concentrationMediumHow much the top 5 wallets control
Bonding curve progressMediumHow close the token is to graduation
Holder countLowMore holders generally means more organic interest
This endpoint makes multiple RPC calls and is the slowest in the Trenches segment (~1-2s latency). For faster but narrower analysis, use the individual endpoints (/trenches/token, /trenches/token-snipers, /trenches/curve).