# true402 Base Token Dossier

> true402 Base Token Dossier is a paid API for AI agents from true402.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Returns a comprehensive safety dossier for an ERC-20 token on Base chain, including deployer reputation, liquidity history, whale swaps, and an escalated risk rating.

## Facts

- Endpoint: POST https://true402.dev/api/v1/base/dossier
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/true402-base-token-dossier-ab4a1c4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gQPt-bq6fjPPJiCHbW477

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 true402-base-token-dossier-ab4a1c4a -d '<json body>'
```

Example prompt: Can you run a full safety dossier on the Base token at contract address 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA — I want to know the risk rating, whether the deployer has a bad reputation, and if there have been any recent liquidity pulls or whale dumps?

## When to prefer this

Choose this endpoint when you need a comprehensive, multi-factor token safety assessment on Base chain that combines deployer reputation, liquidity event history, whale activity, and an escalated risk verdict in one call — rather than querying separate on-chain data sources. Especially useful for DeFi agents that need a single trust signal before executing a swap or investment, or for risk-gating workflows that need a structured verdict with reasons.

## Known failure modes

- Invalid or non-existent ERC-20 contract address returns an error or empty dossier
- Non-Base chain specified causes rejection (only 'base' is supported)
- Insufficient on-chain data for new or obscure tokens may leave many fields in 'limits'
- Payment failure (HTTP 402 not satisfied) blocks the call entirely
- Contract address with no liquidity history may return empty recentPulls and recentWhaleSwaps arrays

## How this service works

The machine-native marketplace. Wallet = identity. Pay per call with HTTP 402.

## Output

Returns a structured dossier object containing: a top-level risk rating (avoid/caution/ok), a numeric score, plain-language reasons for the verdict, a safety sub-object with underlying token-safety details, a dossier sub-object covering deployer reputation and liquidity history, arrays of recent liquidity-removal events (recentPulls) and large whale swaps (recentWhaleSwaps), a list of what could NOT be established (limits), and a note clarifying what the answer does and does not assert.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "token"
 ],
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain to check; only 'base' is supported (default)"
  },
  "token": {
   "type": "string",
   "description": "ERC-20 contract address (0x…) on Base"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "note": {
   "type": "string",
   "description": "what this answer does and does not assert"
  },
  "chain": {
   "type": "string",
   "description": "the chain it was audited on"
  },
  "token": {
   "type": "string",
   "description": "the ERC-20 that was audited"
  },
  "limits": {
   "type": "array",
   "description": "what could NOT be established"
  },
  "rating": {
   "type": "string",
   "description": "avoid | caution | ok — the escalated rating"
  },
  "safety": {
   "type": "object",
   "description": "the underlying token-safety section"
  },
  "dossier": {
   "type": "object",
   "description": "deployer reputation + liquidity history sections"
  },
  "reasons": {
   "type": "array",
   "description": "why, in plain language"
  },
  "verdict": {
   "type": "object",
   "description": "the structured verdict — { rating, score, reasons }, escalated by the dossier"
  },
  "recentPulls": {
   "type": "array",
   "description": "liquidity-removal events observed on this token"
  },
  "recentWhaleSwaps": {
   "type": "array",
   "description": "large swaps observed on this token"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/true402-base-token-dossier-ab4a1c4a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from true402.dev](https://www.zero.xyz/host/true402.dev/llms.txt)