llms.txt
Compare with other sites' llms.txt files →# tula
> Open-source CLI: exposure and liquidation risk on Hyperliquid, Aave, Kraken, Binance, Coinbase, Stripe and wallets. Read-only; placing trades will come later.
You are long ETH spot on one venue, short ETH perp on another, and holding ETH
as collateral against a debt on a lending protocol. Each venue is right about its
own piece and blind to the other two. tula reads all of them and answers the two
questions none of them can: **what is my real exposure**, and **what breaks
first**. Every figure is computed in plain code; a language model only explains
the results and never does the arithmetic.
## What it reads
Hyperliquid (every account mode, whether standard, unified or portfolio margin,
with balances as the venue states them; perps on the first-party dex and every
builder-deployed dex, with the liquidation price or the account ratio the venue
liquidates on; portfolio-margin borrowing; what each balance is held against;
staked HYPE, vault equity and sub-accounts), Aave v3 across twelve markets on
Ethereum, Arbitrum One, Base, Polygon, Optimism, Avalanche, Gnosis, Scroll and
Linea (collateral, debt and health factor, each market's own), and a wallet's
native and ERC-20 balances on those same nine chains — all three from one public
address alone. Then Kraken, Binance, Coinbase Advanced and Stripe, each from a
read-only key. A key proven to withdraw or trade
is turned away rather than warned about; where a venue exposes no way to check —
Stripe, for both powers — tula says so rather than calling it safe.
A venue that publishes no read-only key at all is not offered: there is nothing
to connect it with that tula would hold. A venue may hold more than one address
or key, and every figure counts all of them.
tula states what it does not read, and states it where it is asked. Each
connector declares its own gaps — Aave V4, the endpoints of each venue nothing
here calls, the chains outside the nine — and `/venues` names every one of
them, area by area, with what each may hide. A venue that answered holding
nothing says so on the spot, since that is the case where a gap and an empty
account look identical.
## Commands
- `/exposure` — net exposure per asset across every venue, with notional and the venues that contributed
- `/breaks` — everything that can be liquidated, nearest first, with the move required to get there
- `/shock <asset> <percent>` — reprice the whole book and report what changes and what liquidates
- `/positions [asset]` — every position, as each venue reports it, or only those of one asset
- `/position <asset>` — one position in full: entry, mark, PnL, funding, margin and what liquidates it
- `/venues` — per-venue counts, freshness and failures
A slash means a command; anything else is a question, answered in plain English
from the same figures. Every command works without signing in to a model.
## Install
```sh
curl --proto '=https' --tlsv1.2 -LsSf https://usetu.la/install.sh | sh
```
Also `brew install hsnice16/tap/tula` and `npm install -g @hsnice16/tula` — the same
binary. macOS 13 or later and Linux, 64-bit Intel and ARM; Windows through WSL. Every release
carries a published checksum, which the installer always checks and refuses on,
and a sigstore-backed build attestation, which it checks wherever the GitHub CLI
is installed and signed in to read one.
## Pages
- [Overview](https://usetu.la/): How one asset held spot, short and as collateral nets out, what breaks first, and asking in plain English instead.
- [Install](https://usetu.la/install/): One command, with every download checked. Homebrew and npm, what it runs on, and how to go back a version.
- [Security](https://usetu.la/security/): What tula promises about your keys and your funds, what enforces each promise, and where the limits are.
- [Privacy](https://usetu.la/privacy/): What this site measures about a visit, the analytics choice and how to change it, and what the binary sends: nothing.
- [Keys](https://usetu.la/keys/): Every key the shell answers to, grouped by what it is for, and which ones need a terminal that sends them.
- [Liquidation risk](https://usetu.la/liquidation-risk/): Every liquidatable position across venues, in one list ordered by the move that liquidates it.
- [Exposure](https://usetu.la/exposure/): Spot, perps and collateral netted per asset across venues, and an Equity total that never adds a perp’s notional.
- [Stress test](https://usetu.la/stress-test/): One price move across every venue at once: the new total, each health factor and account ratio, and what liquidates.
- [Wallets](https://usetu.la/wallets/): One public address read on nine EVM chains — the gas token and the ERC-20s a token list names — with no key.
- [Hyperliquid](https://usetu.la/hyperliquid/): Liquidation price or account ratio by Hyperliquid account mode, builder dexes, sub-accounts, vaults and staked HYPE.
- [Aave](https://usetu.la/aave/): Aave health factor and the move to liquidation, across twelve v3 markets on nine chains, from one address.
- [Kraken](https://usetu.la/kraken/): A read-only Kraken API key, in Kraken’s own permission names, and what tula refuses.
- [Binance](https://usetu.la/binance/): A read-only Binance API key, in Binance’s own restriction names, and what tula refuses.
- [Coinbase](https://usetu.la/coinbase/): A read-only Coinbase CDP key, in Coinbase’s own permission names, and what tula refuses.
- [Hyperliquid calculator](https://usetu.la/hyperliquid-liquidation-calculator/): A Hyperliquid liquidation price for any perp, isolated or cross, with its real max leverage and margin tiers.
- [Aave calculator](https://usetu.la/aave-health-factor-calculator/): An Aave v3 health factor and each collateral’s liquidation price, with every market’s thresholds and eMode.
- [Funding calculator](https://usetu.la/hyperliquid-funding-calculator/): What Hyperliquid funding costs or pays a position: per hour, per day, and in a year.
- [Hyperliquid tracker](https://usetu.la/hyperliquid-portfolio-tracker/): A Hyperliquid account from its public address: perps, spot, sub-accounts, funding and liquidation price.
- [Terminal trackers](https://usetu.la/crypto-portfolio-tracker-cli/): Open-source crypto portfolio trackers for the terminal, and what each one reads.
- [Sitemap](https://usetu.la/sitemap.xml): every URL this site publishes
## Source
- [Repository](https://github.com/hsnice16/tula): MIT-licensed, open from the first commit — the only way anyone can check the claims above
- [Security policy](https://github.com/hsnice16/tula/blob/main/SECURITY.md): what is in scope and how to report privately
- [Changelog](https://github.com/hsnice16/tula/blob/main/CHANGELOG.md) and [roadmap](https://github.com/hsnice16/tula/blob/main/ROADMAP.md): read in the repository, where they are written