# GET /token/new: $0.01 per call

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, each with a safety pre-screen (honeypot, taxes, mint/freeze, owner powers, locks), price, volume, buys/sells and links. Solana, Base, Ethereum, BNB and more. Optional ?chain=solana&maxAgeMinutes=60&minLiquidityUsd=10000.

- **Price:** $0.01 in USDC, the same on Base, Solana, Polygon, Arbitrum. Failed calls are never charged.
- **Free trial:** yes, 20 free calls a day from Claude, Cursor or any MCP client ([set-up](/mcp/setup)).
- **Answers cached for:** 1 min
- **Data sources:** DexScreener (free); GeckoTerminal new pools (free); GoPlus Security (free tier)
- **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-new](/sample/token-new). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

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

## 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/new?chain=all&maxAgeMinutes=60&minLiquidityUsd=10000&limit=10"
```

## 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/new?chain=all&maxAgeMinutes=60&minLiquidityUsd=10000&limit=10");
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-new", {"chain":"all","maxAgeMinutes":60,"minLiquidityUsd":10000,"limit":10});
```

## Inputs

- `chain` (string; one of `all`, `base`, `solana`, `ethereum`, `bsc`, `arbitrum`, `polygon`, `optimism`, `avalanche`; default `all`): Blockchain, or all: base, solana, ethereum, bsc, arbitrum, polygon, optimism, avalanche.
- `maxAgeMinutes` (integer; default `60`): Only pools opened within this many minutes.
- `minLiquidityUsd` (number; default `10000`): Minimum total DEX liquidity in USD.
- `limit` (integer; default `10`): Most tokens to return (each is safety-screened).

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

## Example answer

```json
{
  "candidates": 72,
  "matched": 3,
  "tokens": [
    {
      "chain": "solana",
      "address": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
      "name": "Example Cat",
      "symbol": "ECAT",
      "launchedAt": "2026-09-28T11:24:00.000Z",
      "ageMinutes": 36,
      "priceUsd": 0.00042,
      "liquidityUsd": 29247,
      "marketCapUsd": 420000,
      "volume": {
        "m5": 3100,
        "h1": 88000
      },
      "txnsH1": {
        "buys": 812,
        "sells": 604
      },
      "priceChange": {
        "m5": 4.2,
        "h1": 180
      },
      "pool": {
        "dex": "raydium",
        "pairAddress": "Hk...",
        "quote": "SOL",
        "url": "https://dexscreener.com/solana/hk..."
      },
      "promotion": {
        "profile": true,
        "boosted": false,
        "communityTakeover": false
      },
      "description": "The cat that launched itself.",
      "links": [
        {
          "type": "twitter",
          "url": "https://x.com/example"
        }
      ],
      "safety": {
        "screened": true,
        "verdict": "caution",
        "score": 70,
        "dangers": [],
        "warnings": [
          "new_pool",
          "concentrated"
        ]
      }
    }
  ],
  "discovery": "DexScreener latest profiles, boosts and community takeovers",
  "source": "DexScreener latest profiles, boosts and community takeovers; GoPlus Security",
  "disclaimer": "",
  "checkedAt": "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/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/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](/).