Tally Protocol — /api/tally/*
The Tally Protocol is the financial backbone API. Every contract transition mints a token; transfers, burns, claims, and the public ledger all live here. Concept: Tally tokens.
Source: shared/api-core/src/routes/tallyProtocol.ts.
Endpoints
| Method | Path | Auth | Notes |
|---|---|---|---|
GET | /api/tally/account/:zid | optional | Aggregated balance + machines for a ZID |
GET | /api/tally/credits/:zid | optional | Balance, tier, daily rate |
POST | /api/tally/envelopes/transfer | Bearer | Transfer a ZEQ envelope coin to another ZID (credits are non-transferable fuel — credits/transfer returns 410) |
POST | /api/tally/credits/claim | Bearer | Claim daily free-tier allowance |
GET | /api/tally/credits/history/:zid | optional | Paginated transaction history |
POST | /api/tally/burn | Bearer | Burn-to-compute or voluntary burn |
GET | /api/tally/cost | none | Calculate cost for an operator sequence |
GET | /api/tally/ledger | none | Public mint/burn ledger |
GET | /api/tally/transparency | none | Foundation stats, burn rate |
GET | /api/tally/health | none | Tally system status |
GET | /api/tally/height | none | Current chain height |
GET | /api/tally/block/:n | none | Zeqond block data |
GET | /api/tally/clock | none | Live HulyaPulse |
GET | /api/tally/consensus | optional | Consensus snapshot |
GET | /api/tally/user/:zid | none | User aggregate (free tier safe) |
Common shapes
tier is one of free, pro, advanced, enterprise, architect, builder.
| Tier | Max supply | Daily rate |
|---|---|---|
free | 100/day → 36,500/year | 100/day |
pro | configurable | floor(maxSupply / 30) |
advanced, enterprise, architect, builder | tier-specific, see tallyEconomy.ts | tier-specific |
See also
- Tally chain endpoints — per-state-machine token surface (
/api/chain/:slug/tally/*) - Tally tokens concept