# CurveCall Token Precheck

> CurveCall Token Precheck is a paid API for AI agents from curvecall.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Returns on-chain market math, price impact, and risk assessment for a token trade on a given chain

## Facts

- Endpoint: GET https://curvecall.onrender.com/v1/precheck/%7Bchain%7D/%7Baddress%7D?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/curvecall-token-precheck-6e060cda
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qmcAEvamTIODm9cXdlmjl

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 curvecall-token-precheck-6e060cda
```

Example prompt: Before I swap 0.5 ETH into the token at 0x4e84... on Base, can you run a precheck — I want to see the price impact, how much token I'd get out, and whether it's flagged as risky?

## When to prefer this

Use CurveCall's precheck endpoint when an AI agent needs to gate a token swap on risk and price-impact math before execution — especially in autonomous trading workflows where you want a structured risk verdict (score, label, flags) alongside a trade quote in a single call. Prefer this over generic DEX aggregator APIs when you need the risk assessment bundled with the quote, and over static token scanners when you need live price-impact simulation for a specific trade size.

## Known failure modes

- Invalid or unsupported chain ID returns an error — use Dexscreener-compatible IDs like 'base', 'solana', 'ethereum'
- Unknown or unindexed token contract address may return no market data
- Insufficient liquidity for the requested amount_in may produce extreme price impact values
- Payment failure via x402 protocol blocks the call before execution
- Malformed address format returns a validation error

## How this service works

Pay-per-call market math and token intel for AI agents, via x402.

## Output

Returns a JSON object containing: a trade quote (amount in/out with units, price impact %), market data (USD price, liquidity), a risk assessment (score 0-100, label, flags), a verdict string (e.g. 'caution'), any warnings, and a disclaimer. The verdict summarizes whether the trade looks safe to proceed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "pathParams": {
     "chain": {
      "type": "string",
      "required": true,
      "description": "Dexscreener chain id, e.g. base, solana, ethereum"
     },
     "address": {
      "type": "string",
      "required": true,
      "description": "Token contract address"
     }
    },
    "queryParams": {
     "side": {
      "enum": [
       "buy",
       "sell"
      ],
      "type": "string",
      "default": "buy",
      "required": false
     },
     "fee_bps": {
      "type": "number",
      "default": 100,
      "required": false
     },
     "amount_in": {
      "type": "number",
      "required": false,
      "description": "Amount to trade (quote-token units for buys, token units for sells)"
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "risk": {
      "flags": [],
      "risk_label": "medium",
      "risk_score": 45
     },
     "chain": "base",
     "quote": {
      "side": "buy",
      "amount_in": 0.5,
      "amount_out": 5136,
      "amount_in_unit": "WETH",
      "amount_out_unit": "TEST",
      "price_impact_pct": 2.39
     },
     "market": {
      "price_usd": 0.01,
      "liquidity_usd": 120000
     },
     "symbol": "TEST",
     "address": "0x...",
     "verdict": "caution",
     "warnings": [],
     "disclaimer": "Not financial advice."
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/curvecall-token-precheck-6e060cda/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from curvecall.onrender.com](https://www.zero.xyz/host/curvecall.onrender.com/llms.txt)