# Token Brief: Metadata + Price + Holder Concentration + Contract Verification + Sanctions

> Token Brief: Metadata + Price + Holder Concentration + Contract Verification + Sanctions is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-01).

Returns a consolidated token report including metadata, current price, holder concentration, contract verification status, and sanctions screening for a given EVM token contract in one call.

## Facts

- Endpoint: POST https://twin.unykorn.org/token-brief?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-brief-metadata-price-holder-concentration-contract-verification-f163a434
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_atf8QDmdSc7nwvGHkVb4V

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 token-brief-metadata-price-holder-concentration-contract-verification-f163a434 -d '<json body>'
```

Example prompt: Can you pull a full token brief for the USDC contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — I need the price, holder concentration, whether the contract is verified, and any sanctions flags?

## When to prefer this

Choose this endpoint when you need a comprehensive token snapshot — metadata, price, holder concentration, contract verification, and sanctions — in a single API call rather than stitching together multiple specialized endpoints. Ideal for due diligence workflows, compliance checks, or portfolio enrichment on Base, Ethereum, Polygon, Arbitrum, or Optimism EVM tokens.

## Known failure modes

- Invalid contract address format returns a validation error
- Unsupported chain value returns an enum validation error
- Unverified or non-existent contract may return partial data or not-found error
- Sanctions data provider outage may cause incomplete screening results
- Payment failure (x402) blocks the request entirely

## How this service works

Token brief: metadata + price + holder concentration + contract verification + sanctions in ONE call — Genesis402 / UnyKorn Operator Network

## Output

A consolidated JSON object containing the token's metadata (name, symbol, decimals, supply), current USD price, holder concentration metrics (e.g. top-holder percentages), contract verification status on the target chain, and sanctions screening result — all in a single response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "chain": {
     "enum": [
      "base",
      "ethereum",
      "polygon",
      "arbitrum",
      "optimism"
     ],
     "type": "string"
    },
    "contract": {
     "type": "string",
     "pattern": "^0x[0-9a-fA-F]{40}$"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "token-brief",
  "parts": [
   {
    "name": "evm-token-info",
    "result": {},
    "available": true
   }
  ],
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.03,
   "receipt_id": "g402-<16hex>"
  },
  "parts_total": 5,
  "evidence_hash": "sha256:<64hex>",
  "parts_available": 5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-brief-metadata-price-holder-concentration-contract-verification-f163a434/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)