# Teppi

The record of what happened when someone paid a machine service. Every entry carries the settlement transaction, the hashes of what was sent and returned, and the check that ran.

## Free, no payment required
GET  https://api.teppi.xyz/v1/check
GET  https://api.teppi.xyz/v1/trust/{id}
GET  https://api.teppi.xyz/v1/trust/index
GET  https://api.teppi.xyz/v1/trust/feed
GET  https://api.teppi.xyz/v1/archive
GET  https://api.teppi.xyz/v1/archive/{id}
POST https://api.teppi.xyz/v1/route/plan
POST https://api.teppi.xyz/v1/evaluate
POST https://api.teppi.xyz/v1/exposure
POST https://api.teppi.xyz/v1/watchers
GET  https://api.teppi.xyz/v1/watchers/{watcher_id}
POST https://api.teppi.xyz/v1/watchers/stop
GET  https://api.teppi.xyz/v1/orders/{order_id}
GET  https://api.teppi.xyz/v1/buyers/{address}/orders

## Paid, returns 402 with payment terms
POST https://api.teppi.xyz/v1/docs/extract   0.020000 USDC (exact)
POST https://api.teppi.xyz/v1/companies/lookup   0.020000 USDC (exact)
POST https://api.teppi.xyz/v1/web/evidence   0.020000 USDC (exact)
POST https://api.teppi.xyz/v1/research/brief   0.020000 USDC (exact)

## Pay on delivery, the price of what it buys plus a fee, settled only if every answer passed
POST https://api.teppi.xyz/v1/route/execute   price of what it buys + 10%, at least 0.002000 USDC
GET  https://api.teppi.xyz/v1/via/{capability_id}   price of what it buys + 10%, at least 0.002000 USDC
POST https://api.teppi.xyz/v1/via/{capability_id}   price of what it buys + 10%, at least 0.002000 USDC

## Discovery
A2A: https://api.teppi.xyz/.well-known/agent-card.json
ERC-8004 registration: https://api.teppi.xyz/.well-known/agent-registration.json
x402 manifest: https://api.teppi.xyz/.well-known/x402
OpenAPI: https://api.teppi.xyz/openapi.json
Signing keys: https://api.teppi.xyz/.well-known/teppi-keys.json
Docs: https://api.teppi.xyz/docs/verification-method
Before you pay one of the paid endpoints above, read: https://api.teppi.xyz/docs/check-before-you-pay
Where that check goes in the x402 client, a fetch, Python or MCP: https://api.teppi.xyz/docs/integrations
For a seller, payments held in escrow until Teppi checked the delivery: https://api.teppi.xyz/docs/facilitator
A skill file that makes an agent ask first, MIT: https://api.teppi.xyz/docs/skill
The same as a Cursor rule: https://api.teppi.xyz/docs/cursor-rule
For a catalog showing the record beside its listings, one file for the market: https://api.teppi.xyz/docs/listings
What the record says about the whole market, monthly: https://api.teppi.xyz/docs/reports