# Tetlith

> Integrate crypto custody, deposits, withdrawals and treasury into your product.

- [Introduction](https://docs.tetlith.com/introduction.md): Crypto custody, deposits, withdrawals and treasury, behind a ledger API
- [Quickstart](https://docs.tetlith.com/quickstart.md): Create a customer, take a deposit, and move money — in four calls
- [Authentication](https://docs.tetlith.com/authentication.md): Bearer keys for reading, signed requests for anything that moves money
- [Entities & accounts](https://docs.tetlith.com/concepts/entities-and-accounts.md): How customers, accounts, addresses and chains relate
- [Idempotency & amounts](https://docs.tetlith.com/concepts/idempotency.md): Safe retries, and why amounts are strings
- [Errors](https://docs.tetlith.com/concepts/errors.md): One shape, everywhere — branch on the code, not the message
- [Networks](https://docs.tetlith.com/concepts/networks.md): Testnet and mainnet are fully separate, end to end
- [Overview](https://docs.tetlith.com/webhooks/overview.md): Verify the signature, deduplicate the delivery, respond fast
- [Events](https://docs.tetlith.com/webhooks/events.md): Every event KeyPair can deliver, with its data payload
- [TypeScript SDK](https://docs.tetlith.com/sdks/typescript.md): The official TypeScript SDK — generated types, request signing and webhook verification included.
- [Create a customer](https://docs.tetlith.com/api-reference/entities/create-a-customer.md)
- [List customers](https://docs.tetlith.com/api-reference/entities/list-customers.md)
- [List assets a customer account can be opened in](https://docs.tetlith.com/api-reference/entities/list-assets-a-customer-account-can-be-opened-in.md)
- [Find a customer by your own id](https://docs.tetlith.com/api-reference/entities/find-a-customer-by-your-own-id.md)
- [Get a customer](https://docs.tetlith.com/api-reference/entities/get-a-customer.md)
- [Get a customer's balances and addresses](https://docs.tetlith.com/api-reference/entities/get-a-customers-balances-and-addresses.md)
- [Issue a deposit address for a customer, optionally per payment](https://docs.tetlith.com/api-reference/entities/issue-a-deposit-address-for-a-customer-optionally-per-payment.md)
- [Open accounts for a customer](https://docs.tetlith.com/api-reference/entities/open-accounts-for-a-customer.md)
- [List your customers' accounts, with currency and balance](https://docs.tetlith.com/api-reference/accounts/list-your-customers-accounts-with-currency-and-balance.md): Every `user_wallet` account across every customer, flat and paginated — never your own company wallets or the pool float, which live on the platform's own side of the books. For one customer's accounts, use `GET /v1/entities/{entityId}/holdings` instead; this is the cross-customer, tenant-wide read.
- [List every account holding a currency, across its chains](https://docs.tetlith.com/api-reference/accounts/list-every-account-holding-a-currency-across-its-chains.md): `kind`, if given, must be `user_wallet`, `company_wallet`, or `pool_account` — the rest of the chart of accounts isn't yours to filter by.
- [Get the total owed to customers, per currency](https://docs.tetlith.com/api-reference/accounts/get-the-total-owed-to-customers-per-currency.md)
- [Get many balances in one call](https://docs.tetlith.com/api-reference/accounts/get-many-balances-in-one-call.md)
- [Get one balance](https://docs.tetlith.com/api-reference/accounts/get-one-balance.md)
- [Get an account statement](https://docs.tetlith.com/api-reference/accounts/get-an-account-statement.md)
- [Verify one account against its entries](https://docs.tetlith.com/api-reference/accounts/verify-one-account-against-its-entries.md)
- [Issue a deposit address for one account](https://docs.tetlith.com/api-reference/accounts/issue-a-deposit-address-for-one-account.md)
- [Create Transaction](https://docs.tetlith.com/api-reference/transactions/create-transaction.md): Moves a customer's balance out — to another customer of yours (`toEntityId`), or to a blockchain address (`toAddress`). This is the operation behind the dashboard's own Transfer and Withdraw actions; a merchant's own backend key reaches the identical rail.
- [List Transactions](https://docs.tetlith.com/api-reference/transactions/list-transactions.md): `counterpartyKind` is `external` for a deposit or withdrawal, `user_wallet` / `company_wallet` / `pool_account` for a transfer between two accounts you can see, or `internal` for one that touched an account outside those three kinds — a platform-side fee or FX leg, never something your integration n…
- [Get a transaction](https://docs.tetlith.com/api-reference/transactions/get-a-transaction.md)
- [Get holdings per currency, summed across chains](https://docs.tetlith.com/api-reference/activity/get-holdings-per-currency-summed-across-chains.md)
- [Count recent transactions by status](https://docs.tetlith.com/api-reference/activity/count-recent-transactions-by-status.md)
- [List recent transactions](https://docs.tetlith.com/api-reference/activity/list-recent-transactions.md)
- [List money arriving, one row per chain arrival](https://docs.tetlith.com/api-reference/compliance/list-money-arriving-one-row-per-chain-arrival.md)
- [List deposits still held for your tenant](https://docs.tetlith.com/api-reference/compliance/list-deposits-still-held-for-your-tenant.md)
- [List your customer withdrawal policies](https://docs.tetlith.com/api-reference/policies-&-allowlists/list-your-customer-withdrawal-policies.md)
- [List your treasury withdrawal policies](https://docs.tetlith.com/api-reference/treasury/list-your-treasury-withdrawal-policies.md)
- [List your reconciliation runs](https://docs.tetlith.com/api-reference/reconciliation/list-your-reconciliation-runs.md)

## OpenAPI Specs

- [core.openapi](/openapi/core.openapi.json)
- [webhooks.openapi](/openapi/webhooks.openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.