# Tellr — Agent ATM

> Decision logic for an agent spend. Six calls. One price. Moves nothing.

Each endpoint returns a decision or a description of what a sale would look like. It does not read a wallet, hold keys, or move funds. An unpaid request returns HTTP 402. A 200 arrives only after the x402 payment settles.

## Endpoints

All six are POST, JSON in, JSON out. Each call costs 0.05 USDC on Base.
An unpaid request returns HTTP 402 Payment Required with a PAYMENT-REQUIRED header. Payment settles on-chain before the 200 response.

- `tellr-fund-checkout` — Decide how to fund a checkout before paying it. — https://x402.bankr.bot/0xcdc493fb6f0fa17b213ac2195bc454b39c1228ec/tellr-fund-checkout
- `tellr-check` — Decide whether a spend can auto-execute, needs a human, or must be refused, against configured per-transaction ceilings, a daily cap and pool rules. — https://x402.bankr.bot/0xcdc493fb6f0fa17b213ac2195bc454b39c1228ec/tellr-check
- `tellr-sell-plan` — Build a descriptive sell plan that raises a target amount from a set of holdings. — https://x402.bankr.bot/0xcdc493fb6f0fa17b213ac2195bc454b39c1228ec/tellr-sell-plan
- `tellr-privilege-audit` — Audit a privilege-affecting event before honouring it. — https://x402.bankr.bot/0xcdc493fb6f0fa17b213ac2195bc454b39c1228ec/tellr-privilege-audit
- `tellr-classify` — Classify a holding as liquidity or growth for policy purposes. — https://x402.bankr.bot/0xcdc493fb6f0fa17b213ac2195bc454b39c1228ec/tellr-classify
- `tellr-top-off` — Decide whether a card top-off is worth making toward a target balance, and whether limits allow it. — https://x402.bankr.bot/0xcdc493fb6f0fa17b213ac2195bc454b39c1228ec/tellr-top-off

## Reference

- OpenAPI: https://tellrmachine.com/openapi.json
- Full reference: https://tellrmachine.com/llms-full.txt
- Machine-readable index: https://tellrmachine.com/agents.json
- Agent card: https://tellrmachine.com/.well-known/agent-card.json

## Boundaries

Decision logic only. No keys. No wallet access. Moves nothing.
Verdicts describe. They do not execute.
tellr-classify fails closed to growth when a holding is untagged. Missing information never becomes a permissive default.