# 1Tx

> One API to discover, compare, deposit, rebalance and withdraw stablecoin yield across Aave, Morpho, Compound, Euler and Fluid — on Base, Arbitrum and Unichain. Self-custody, policy-bounded, agent-ready.

1Tx is yield-access infrastructure for agents and developers: an instrument
registry (one bytes32 id per protocol/chain/market), an atomic router
(swap and deposit settle in one transaction), cross-chain settlement via
Circle CCTP, and gasless Safe smart accounts (gas paid in USDC).

Self-custody by construction: the router never holds funds beyond a single
transaction. 1Tx builds the transaction; your wallet signs it.

## Links

- API base: https://api.1tx.fi/api/v1 (auth: x-api-key header)
- Get an API key: https://app.1tx.fi/settings
- Docs: https://docs.1tx.fi
- App: https://app.1tx.fi
- GitHub: https://github.com/1tx-fi
- Examples (TypeScript, no SDK required): https://github.com/1tx-fi/api-examples
- open-allocator (MIT, policy-bounded agent allocator): https://github.com/ialberquilla/open-allocator
- Live agent dashboard (a real mandate-driven book on the 1Tx API): https://agents.1tx.fi
- For teams (fintechs, wallets, exchanges): https://1tx.fi/for-teams
- Contact: hello@1tx.fi

## Key endpoints

- GET /instruments — discover yield instruments; filter by chainId, protocol,
  assetCategory; sort by apy or tvl
- POST /transactions/buy — build the unsigned deposit transaction set
  (approve, then buy); cross-chain routes over CCTP in the same call
- POST /transactions/sell — build unsigned exit transactions
- POST /positions — read positions for an address
- GET /transactions/operations/{id} — track operation / CCTP settlement status
- Safe smart account (gasless): GET /account, POST /authorize/prepare,
  POST /authorize/confirm, POST /buy, POST /sell, POST /withdraw,
  GET /actions/{id}

## Live agent

https://agents.1tx.fi runs a real book on this API. A plain-English
mandate derives the policy; a daily job keeps the book inside it. The agent
proposes; deterministic code validates, signs and executes — no model in the
signing path. Published per run: the book, the shelf it was screened against,
every knob of the mandate with its rationale, and every transaction with the
USDC gas it cost.

## Coverage

- Protocols: Aave, Morpho, Compound V3, Euler, Fluid
- Chains: Base, Arbitrum, Unichain (mainnet)
- The live, queryable list is the registry itself: GET /instruments

## Honest status

- The 1Tx router is unaudited; the underlying protocols are audited.
  Experimental software — use small amounts. Audit in progress.
- No 1Tx platform fee. Integrators may attach an optional referral fee
  (referralFeeBps, max 5%) on executed flow.
- Yield rates are variable. Nothing here is financial advice.