# GET /token/report/cached: $0.05 per call

Full token report, cached tier (answers up to 15 minutes old, half price): 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), with an overall rating and headline. Base, Solana, Ethereum, BNB, Arbitrum, Polygon, Optimism, Avalanche. Pass ?address=...&chain=base. Fresh data: /token/report.

- **Price:** $0.05 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:** 15 min
- **Data sources:** GoPlus Security (free tier); DexScreener (free); GeckoTerminal (free, fallback); DefiLlama prices (free, fallback); Blockscout (free); Hacker News Algolia (free)
- **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-cached](/sample/token-report-cached). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

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

## 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/cached?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/cached?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-cached", {"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": "cached",
  "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
  },
  "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](/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/report/deep](/services/token-report-deep) ($0.25): Deep token report: everything in /token/report (safety (honeypot, taxes, owner powers), holders (concentration, exchange/fund/locked share), liquidity (depth, l
- [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](/).