# GET /token/report/deep: $0.25 per call

Deep token report: everything in /token/report (safety (honeypot, taxes, owner powers), holders (concentration, exchange/fund/locked share), liquidity (depth, locks, pools), price action, social/news buzz and smart-money signals (trade sizes, buy pressure, exchange and fund flows, whale transfers)) plus top 25 labelled holders, more transfer history, top traders when available, and an AI analyst verdict (stance, summary, risks, positives, what to watch). ?address=...&chain=base

- **Price:** $0.25 in USDC, the same on Base, Solana, Polygon, Arbitrum. Failed calls are never charged.
- **Free trial:** no, paid only (it uses a paid AI model or data source, or costs more than the trial covers). Try [token-safety](/services/token-safety) free instead. Other ways to pay: x402 or [prepaid credits](/credits).
- **Answers cached for:** 5 min
- **Data sources:** GoPlus Security (free tier); DexScreener (free); GeckoTerminal (free, fallback); DefiLlama prices (free, fallback); Blockscout (free); Hacker News Algolia (free); Workers AI; Birdeye (paid, when BIRDEYE_API_KEY is set)
- **Lane:** Crypto & on-chain ([OpenAPI](/openapi/crypto.json))
- **Live health:** [status page](/status)

## Free sample

See an answer for the demo input first, free (no payment, 10 a minute): [https://aayatai.com/sample/token-report-deep](/sample/token-report-deep). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

```bash
curl "https://aayatai.com/sample/token-report-deep"
```

## 1. See the price (free)

Call it without paying: you get `402 Payment Required` and a `PAYMENT-REQUIRED` header with the exact price and where to pay.

```bash
curl -i "https://aayatai.com/token/report/deep?address=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed&chain=base"
```

## 2. Pay and call (TypeScript)

```bash
npm install @x402/fetch @x402/evm viem
```

```ts
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

// A wallet used only by your agent, holding a little USDC on Base.
const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await pay("https://aayatai.com/token/report/deep?address=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed&chain=base");
console.log(await res.json());
```

## 3. Or as an MCP tool

```ts
// MCP server: https://aayatai.com/mcp (Streamable HTTP). With the x402 MCP client (see /start):
const result = await client.callTool("token-report-deep", {"address":"0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed","chain":"base"});
```

## Inputs

- `address` **(required)** (string): Token contract address (0x...) or Solana mint address.
- `chain` (string; one of `base`, `solana`, `ethereum`, `bsc`, `arbitrum`, `polygon`, `optimism`, `avalanche`; default `base`): Blockchain: base, solana, ethereum, bsc, arbitrum, polygon, optimism, avalanche.

Bad inputs are rejected with HTTP 400 before any payment is asked for.

## Example answer

```json
{
  "address": "0x1111111111111111111111111111111111111111",
  "chain": "base",
  "tier": "deep",
  "name": "Example Token",
  "symbol": "EXMPL",
  "summary": {
    "rating": "ok",
    "headline": "EXMPL: no major red flags; safety score 90/100, smart-money bias neutral.",
    "highlights": [
      "Trading for more than 6 months."
    ],
    "risks": [
      "Owner can mint new tokens."
    ]
  },
  "safety": {
    "verdict": "low-risk",
    "score": 90,
    "verdictReason": "All checks ran.",
    "checksNotRun": [],
    "flags": [
      {
        "level": "warning",
        "code": "mintable",
        "message": "Owner can mint new tokens."
      }
    ],
    "contract": {
      "token_name": "Example Token",
      "token_symbol": "EXMPL",
      "is_open_source": "1",
      "is_honeypot": "0",
      "is_mintable": "1",
      "buy_tax": "0",
      "sell_tax": "0"
    }
  },
  "holders": {
    "count": 1225688,
    "top1Percent": 22.57,
    "top10Percent": 48.1,
    "top10SellablePercent": 21.3,
    "byKind": {
      "exchange": 3.2,
      "fund": 0,
      "pool": 0.4,
      "locked": 0,
      "contract": 26.8,
      "wallet": 17.7
    },
    "top": [
      {
        "address": "0x2222222222222222222222222222222222222222",
        "percent": 22.57,
        "label": "GnosisSafeProxy",
        "kind": "contract"
      }
    ],
    "source": "Blockscout"
  },
  "liquidity": {
    "totalUsd": 401000,
    "depth": "ok",
    "lockedPercent": 98,
    "lpHolders": 120,
    "liquidityToMarketCapPercent": 0.35,
    "topPoolSharePercent": 99.8,
    "pools": [
      {
        "dex": "uniswap",
        "pairAddress": "0x3333333333333333333333333333333333333333",
        "quote": "WETH",
        "liquidityUsd": 400000,
        "sharePercent": 99.8,
        "createdAt": "2024-01-15T10:00:00.000Z"
      }
    ]
  },
  "priceAction": {
    "priceUsd": 0.0031,
    "change": {
      "m5": 0.1,
      "h1": -0.4,
      "h6": 2.1,
      "h24": -3.5
    },
    "trend": "flat",
    "volumeUsd": {
      "m5": 0,
      "h1": 319,
      "h6": 4586,
      "h24": 70227
    },
    "txns": {
      "m5": {
        "buys": 0,
        "sells": 0
      },
      "h1": {
        "buys": 1,
        "sells": 23
      },
      "h6": {
        "buys": 89,
        "sells": 80
      },
      "h24": {
        "buys": 813,
        "sells": 666
      }
    },
    "buySellRatio": {
      "h1": 0.04,
      "h24": 1.22
    },
    "volumeToLiquidity24h": 0.18
  },
  "buzz": {
    "score": 45,
    "level": "medium",
    "links": {
      "websites": [
        "https://example.com"
      ],
      "socials": [
        {
          "type": "twitter",
          "url": "https://x.com/example"
        }
      ]
    },
    "promotion": {
      "dexscreenerProfile": false,
      "paidOrders": [],
      "activeBoosts": 0,
      "note": "Paid DexScreener profiles and boosts are marketing spend, not organic interest."
    },
    "news": {
      "hackerNewsMentions30d": 1,
      "top": [
        {
          "title": "Example Token explained",
          "url": "https://example.com",
          "points": 12,
          "date": "2026-09-20T10:00:00Z"
        }
      ],
      "query": "Example Token"
    }
  },
  "smartMoney": {
    "bias": "neutral",
    "signals": [
      {
        "direction": "neutral",
        "code": "exchange_held",
        "message": "Exchanges hold about 5.1% of supply among the top holders (listed and liquid)."
      }
    ],
    "flows": {
      "window": {
        "transfers": 50,
        "from": "2026-09-28T03:40:00Z",
        "to": "2026-09-28T03:52:33Z"
      },
      "exchangeFlowsUsd": {
        "deposits": 0,
        "withdrawals": 12000,
        "net": 12000
      },
      "dexFlowsUsd": {
        "buys": 3400,
        "sells": 5100
      },
      "fundFlowsUsd": {
        "received": 0,
        "sent": 0
      },
      "largeTransfers": []
    },
    "topTraders": null,
    "sources": [
      "DexScreener trade counts",
      "Blockscout holder labels",
      "Blockscout recent transfers"
    ],
    "note": "Heuristic signals from labelled exchange wallets, pools and trade sizes; not a curated smart-money list."
  },
  "market": {
    "name": "Example Token",
    "symbol": "EXMPL",
    "priceUsd": 0.0031,
    "priceNative": 0.0000012,
    "liquidityUsd": 401000,
    "volume24hUsd": 70227,
    "priceChange": {
      "m5": 0.1,
      "h1": -0.4,
      "h6": 2.1,
      "h24": -3.5
    },
    "txns24h": {
      "buys": 813,
      "sells": 666
    },
    "marketCapUsd": 115000000,
    "fdvUsd": 115000000,
    "pairs": 2,
    "topPair": null,
    "oldestPairCreatedAt": "2024-01-15T10:00:00.000Z",
    "links": {
      "websites": [],
      "socials": [],
      "image": null
    },
    "marketSource": "DexScreener",
    "liquidityKnown": true
  },
  "analysis": {
    "stance": "speculative",
    "summary": "EXMPL has a clean contract and a long trading history, but liquidity is small relative to its market cap and a few wallets hold much of the supply.",
    "keyRisks": [
      "Thin liquidity versus market cap."
    ],
    "positives": [
      "Verified contract, no taxes, locked liquidity."
    ],
    "watchFor": [
      "Exchange deposits by top holders."
    ],
    "model": "Workers AI (Mistral Small 3.1 24B)"
  },
  "sources": [
    "GoPlus Security",
    "DexScreener",
    "Blockscout",
    "Hacker News (Algolia)"
  ],
  "disclaimer": "Automated analysis of public data, not financial advice. Signals are heuristics; a good report does not guarantee a token is safe.",
  "generatedAt": "2026-09-28T12:00:00.000Z"
}
```

## Related

- [GET /token/price](/services/token-price) ($0.005): Live price of any token on Base, Solana, Ethereum, BNB, Arbitrum, Polygon, Optimism or Avalanche from DEX data: USD price, total liquidity, 24h volume, buys/sel
- [GET /token/safety](/services/token-safety) ($0.02): Rug-pull and scam check for any token on Base, Solana, Ethereum, BNB, Arbitrum, Polygon, Optimism or Avalanche.
- [GET /token/report/cached](/services/token-report-cached) ($0.05): Full token report, cached tier (answers up to 15 minutes old, half price): safety (honeypot, taxes, owner powers), holders (concentration, exchange/fund/locked 
- [GET /token/report](/services/token-report) ($0.10): Full token report, live: safety (honeypot, taxes, owner powers), holders (concentration, exchange/fund/locked share), liquidity (depth, locks, pools), price act
- [GET /token/new](/services/token-new) ($0.01): New token launches with real liquidity: tokens whose first DEX pool opened in the last hour (up to 24h) with at least $10k liquidity (adjustable), newest first,
- [GET /token/whales](/services/token-whales) ($0.02): Whale and exchange flows for a token on Base, Ethereum, Arbitrum, Optimism or Polygon, from its latest ~250 transfers: large transfers, deposits/withdrawals per
- [GET /wallet](/services/wallet) ($0.01): Wallet profile on Base, Ethereum or Solana: native balance, token holdings with USD values (top 25), total portfolio value, whether it is a contract, ENS name, 
- [GET /wallet/deep](/services/wallet-deep) ($0.03): Deep wallet report on Base, Ethereum or Solana: everything in /wallet (balances, tokens, USD value) plus recent transactions and token transfers, in/out directi

New here? [Getting started in 60 seconds](/start). All services: [Aayat AI](/).