# 54ch10 for agents

Pre-interact JSON briefs for **addresses**, **tokens**, and **URLs**. Brand: **54ch10** (not “SACHIO”). Analytics-only tooling — not financial, legal, or investment advice.

Base URL: `https://54ch10.uk`

## Why call this before a wallet interact

Agents that can sign, approve, bridge, or open a dapp URL should brief the counterparty **before** spending gas or privileges:

1. Resolve the target (`address` / `token` / `url`).
2. `GET /v1/brief` → `score` (0–100, higher = more concerning), `band`, `flags[]`, `summary`, `sources[]`.
3. Gate the next tool call on policy (e.g. refuse `critical`, require human confirm on `elevated`).
4. Log `cached_at` + `sources[].status` so operators can audit stub vs live signals.

Do **not** treat a low score as clearance. Scores are imperfect heuristics and can be wrong or incomplete.

## Auth

| Mode | Header | Limits |
|------|--------|--------|
| Free | none | 20 briefs / UTC day / IP |
| Paid | `Authorization: Bearer 54k_…` | Solo 500 / Pro 5k / Team 25k per month |

Keys are minted after Stripe Checkout; claim via landing `?paid=1&session_id=cs_…`. Invalid `54k_` keys return `401`.

## Endpoint

```
GET /v1/brief?type=address|token|url&q=<query>
```

Response fields (success): `ok`, `type`, `q`, `score`, `band` (`clear` \| `caution` \| `elevated` \| `critical` \| `unknown`), `flags`, `summary`, `sources`, `cached_at`, `cache_hit`, `tier`, `disclaimer`, `meta`.

Cache TTL ≈ 15 minutes. CORS: `*`.

## Example curl

```bash
# Free — URL before connect-wallet click
curl -sS 'https://54ch10.uk/v1/brief?type=url&q=https://example.com/connect-wallet'

# Free — EVM address
curl -sS 'https://54ch10.uk/v1/brief?type=address&q=0x0000000000000000000000000000000000000000'

# Paid
curl -sS 'https://54ch10.uk/v1/brief?type=token&q=ETH' \
  -H 'Authorization: Bearer 54k_YOUR_KEY'
```

Agent-shaped policy sketch:

```text
brief = GET /v1/brief?type=…&q=…
if brief.band in {elevated, critical}: halt_or_escalate(brief)
else: proceed_with_interact()
```

## Pricing (Stripe Payment Links)

| Plan | Price | Included |
|------|-------|----------|
| Solo | $29/mo | 500 briefs / mo, API key |
| Pro | $99/mo | 5k briefs + watchlists |
| Team | $299/mo | 25k briefs + seats / keys |

- Solo: https://buy.stripe.com/dRmcN69Gu3yI6Pd6bu28800
- Pro: https://buy.stripe.com/aFa28s8Cq8T2c9x57q28802
- Team: https://buy.stripe.com/3cI6oI9Gu4CMgpNbvO28801

Also: `GET /health`, `GET /LEGAL_DISCLAIMER.txt`.

## Disclaimer

Informational tooling only. Not financial, investment, legal, or tax advice. Not an offer or recommendation to buy, sell, hold, stake, bridge, swap, or interact with any asset, protocol, or URL. No custody, trading, or token promotion. You are solely responsible for decisions. Full text: https://54ch10.uk/LEGAL_DISCLAIMER.txt