# Haris Guardian Token Diff

> Haris Guardian Token Diff is a paid API for AI agents from haris-api.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-17).

Re-checks a Solana token and reports what changed versus a previous snapshot, covering authorities, LP, liquidity, holders, sellability, and risk score.

## Facts

- Endpoint: POST https://haris-api.vercel.app/v1/paid/diff?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/haris-guardian-token-diff-896e9c94
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k2oZ-9BzdqQOU-zAIn4Hd

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 haris-guardian-token-diff-896e9c94 -d '<json body>'
```

Example prompt: Check if anything has changed for Solana token 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU since my last snapshot — look for any shifts in LP, mint authority, liquidity, or risk score.

## When to prefer this

Use this endpoint when you already have a prior Haris check result for a token and need to detect what specifically changed over time — it is purpose-built for watch/alert workflows. Prefer it over a fresh /check call when change detection (not just current state) is the goal, especially for monitoring LP pulls, authority revocations, or score degradation over time.

## Known failure modes

- Invalid or malformed mint address returns a validation error
- Previous snapshot from a different mint address causes a mismatch error
- Network or RPC issues on Solana may delay or fail the re-check
- Providing a snapshot from an incompatible endpoint version may cause parsing errors
- Rate limiting or payment failure at $0.02 USDC per call blocks execution

## How this service works

Read-only scam/rug risk checks for Solana tokens (SPL + Token-2022), by Haris Guardian.

**Score: 0-100, HIGHER = RISKIER.** Levels: low (<20), medium (20-49), high (50-74), critical (75+).
The score is the capped sum of published flag weights; every flag comes with a plain-English reason.

Free tier: 3 checks per UTC day per IP. Optional `X-API-Key` header for higher limits.
After the free tier: **$0.01 USDC per check via [x402](https://x402.org), on Solana or Base (eip155:8453)** (HTTP 402 -> retry with
`X-PAYMENT` (v1) or `PAYMENT-SIGNATURE` (v2); the facilitator pays network fees; failed checks are not charged).
`/v1/paid/check` (POST JSON `{"mint": ...}` or GET `?mint=`) and `/v1/paid/check/{mint}` always use x402.

Higher-value paid endpoints (x402, POST JSON, flat price per call):
* `/v1/paid/deep-check` `{"mint"}`: holder concentration, linked top wallets (shared funder), LP lock/burn, authorities.
* `/v1/paid/batch-check` `{"mints": [...]}`: up to 20 mints in one call.
* `/v1/paid/diff` `{"mint", "previous"}`: what changed since your previous snapshot (stateless watch).

Results are cached for 60 s. Signals, not guarantees. Not financial advice.
Also available over MCP at `/mcp` (streamable HTTP): `check_solana_token`, `diff_solana_token` (free tier) and
`deep_check_solana_token`, `batch_check_solana_tokens` (return x402 payment instructions).

## Output

A structured diff report showing which fields changed between the previous snapshot and the current token state, including authority changes (mint, freeze, upgrade), LP status, liquidity amounts, holder distribution, sellability flags, and the overall risk score delta.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mint": {
   "type": "string",
   "maxLength": 44,
   "minLength": 32,
   "description": "Base58 Solana token mint address (SPL or Token-2022)"
  },
  "previous": {
   "type": "object",
   "description": "A previous Haris result for the same mint (from /v1/paid/check, /v1/check, /v1/paid/deep-check or the 'current' field of an earlier diff)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
  "alerts": [],
  "changed": false,
  "changes": {},
  "current": {
   "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
   "name": "Bonk",
   "flags": [],
   "level": "low",
   "score": 5,
   "verdict": "No major red flags found."
  },
  "severity": "none"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/haris-guardian-token-diff-896e9c94/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from haris-api.vercel.app](https://www.zero.xyz/host/haris-api.vercel.app/llms.txt)
