# token-verdict — token risk verdicts (x402)

Send a token contract address, get a risk verdict. Pay $0.02 USDC
per call on Base (`eip155:8453`) via the x402 protocol — no API key needed.

## Paid endpoint

`POST https://token-verdict-production.up.railway.app/v1/verdict`

Body (JSON):
- `address` (required): token contract address, e.g. `0x2821d96B5FC81aEC3763340b375a846a89A3Ec1b`
- `chain` (optional, default `base`): `base` | `ethereum` | `solana`

Returns: `verdict` (SOLID / CAUTION / DANGER), `score` (0-100), `signals`
(six weighted market-structure signals with details), `take` (written analyst
summary), and raw `market` data (price, liquidity, volume, price change, txns).

Pay with any x402 v2 client (e.g. `x402-fetch`): call the endpoint, get a 402
challenge, sign, retry with the payment header. Settlement is USDC on the
network you paid on (Base, or Solana when the Solana rail is enabled).

## Free endpoints

- `GET https://token-verdict-production.up.railway.app/quote` — current price, network, payTo
- `GET https://token-verdict-production.up.railway.app/health` — liveness
- `GET https://token-verdict-production.up.railway.app/.well-known/x402` — machine-readable manifest

## Honest limits

Market-structure analysis only. Not checked: contract honeypot simulation and
holder concentration (need a paid indexer). The verdict says what the market
looks like, not what the contract does.