# Pre-Trade Token Check

> Pre-Trade Token Check is a paid API for AI agents from chain.tollkit.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Fetches on-chain token facts, current price, wallet position, pool depth, and trade impact estimate before executing a trade on Base, Ethereum, or Solana.

## Facts

- Endpoint: POST https://chain.tollkit.dev/chain/pretrade?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pre-trade-token-check-aebaed95
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Hmp6rPx0WxlhlK6TfsjfB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pre-trade-token-check-aebaed95 -d '<json body>'
```

Example prompt: Before I buy $500 worth of JUP on Solana using wallet 9xQe...abc, can you check the token at JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN — I want to see the current price, any warnings, pool depth, and how much price impact that trade size would have?

## When to prefer this

Use this endpoint when an agent needs a comprehensive pre-trade snapshot for a specific token — combining price, pool depth, trade impact, wallet position, on-chain safety signals (mint/freeze authority), and recent news in a single call. Prefer this over the Token Safety Check endpoint when you also need trade sizing analysis and pool depth, and over the Token Info endpoint when you need wallet-specific position data and impact estimation. Ideal for DeFi trading agents that need a go/no-go data bundle before executing a swap.

## Known failure modes

- Invalid token contract address format returns validation error
- Token not found on specified chain returns empty or error response
- Wallet address provided but has no position returns null position
- Very illiquid token may have no pool depth data
- Unsupported chain value returns enum validation error
- Network timeouts or RPC errors may cause partial data
- Payment failure (x402) results in 402 response before data is returned

## How this service works

Wallet balances, tokens, transactions and prices on Base, Ethereum and Solana. Other Tollkit tools are described at: https://extract.tollkit.dev/openapi.json, https://attest.tollkit.dev/openapi.json, https://web.tollkit.dev/openapi.json, https://data.tollkit.dev/openapi.json.

## Output

Returns a JSON object with the token's name, symbol, decimals, current USD price, total supply, mint and freeze authority status, pool depth in USD, a trade size analysis (flag, price impact percentage, share of pool), your wallet's current position if provided, a list of warnings, a warning count, recent news headlines with URLs, a note that data is factual not advisory, the explorer URL, and the price source details (DEX, pool, fee tier, quote token).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "ethereum",
    "solana"
   ],
   "type": "string",
   "default": "base",
   "description": "Which chain to read: \"base\" (default), \"ethereum\" or \"solana\"."
  },
  "token": {
   "type": "string",
   "pattern": "^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$",
   "description": "ERC-20 contract or SPL mint."
  },
  "wallet": {
   "type": "string",
   "pattern": "^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$",
   "description": "Optional: your wallet, to see your current holding."
  },
  "amount_usd": {
   "type": "number",
   "description": "Optional: planned trade size in USD.",
   "exclusiveMinimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "Jupiter",
  "note": "Facts read from the chain and the web, not a rating or advice. No warnings does not mean safe.",
  "chain": "solana",
  "token": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  "symbol": "JUP",
  "decimals": 6,
  "position": null,
  "warnings": [],
  "news_note": "Top web results for the token's name and symbol; titles and links as published.",
  "price_usd": 0.336803,
  "checked_at": "2026-10-05T08:43:25.149Z",
  "trade_size": {
   "flag": "ok",
   "amount_usd": 500,
   "pool_depth_usd": 407369,
   "share_of_pool_pct": 0.12,
   "rough_price_impact_pct": 0.12
  },
  "recent_news": [
   {
    "url": "https://thedefiant.io/news/defi/jupiter-token-spikes-as-dex-aggregator-plans-to-spend-half-its-fees-on-buybacks",
    "date": null,
    "title": "Jupiter Token Spikes as DEX Aggregator Plans to Spend Half its Fees On Buybacks",
    "snippet": null
   },
   {
    "url": "https://www.theblock.co/amp/post/337071/jupiter-spikes-40-as-founder-says-50-of-fees-will-go-to-token-buybacks",
    "date": null,
    "title": "Jupiter spikes 40% as founder says 50% of fees will go to token buybacks",
    "snippet": null
   }
  ],
  "explorer_url": "https://solscan.io/token/JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  "price_source": {
   "dex": "Orca Whirlpools",
   "pool": "C1MgLojNLWBKADvu9BHdtgzz1oZX4dZ5zGdGcgvvW8Wz",
   "fee_tier": 500,
   "quote_token": "SOL",
   "tick_spacing": 8
  },
  "total_supply": "6861486339.419214",
  "warning_count": 0,
  "mint_authority": null,
  "pool_depth_usd": 407369,
  "freeze_authority": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pre-trade-token-check-aebaed95/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chain.tollkit.dev](https://www.zero.xyz/host/chain.tollkit.dev/llms.txt)