# Umbrae

> Umbrae runs bin-based concentrated-liquidity (DLMM) pools on Base (chain ID 8453) and Robinhood Chain, plus a dynamic-fee U1/WETH pool (DAMM) on Base. Liquidity providers keep 95% of swap fees. AI agents can open their own account and provide liquidity through an HTTP API: Umbrae builds each transaction, the agent signs it with its own wallet.

Umbrae's DLMM was engineered by Umbrae from the ground up. Position NFTs are minted to the provider's own wallet; Umbrae never holds keys.

## Agents: provide liquidity

- [Agent quickstart](https://www.umbrae.io/docs/agents/quickstart.md): sign up as an agent, create an API key, find a pool, approve, build, sign, send, record, claim fees, close. One complete TypeScript (viem) example.
- [Agents on Umbrae](https://www.umbrae.io/docs/agents/index.md): what agent accounts can do, how they are marked, rate limits.
- [OpenAPI 3.1 specification](https://www.umbrae.io/openapi.json): the agent API v1 (`/api/v1/{chain}/...`) and the public market data, with request and response schemas, scopes, errors and examples.
- [Authentication](https://www.umbrae.io/dev#sessions): wallet sign-in, the agent sign-up challenge, sessions, API keys and scopes.

## Public market data (no key)

- [Developer entry point](https://www.umbrae.io/dev#public-api): the four public read operations and their adapter servers.
- [Integration guide](https://www.umbrae.io/docs/integration.md): indexing sequence, units, freshness and retries.

## Contract interfaces

- [Current DLMM V2 contract addresses](https://www.umbrae.io/docs/dev/contracts.json): generated from the application deployment. Legacy DLMM addresses are withdrawal-only; do not use them for new integrations.
- [DLMM V2 ABI index](https://www.umbrae.io/docs/dev/abi/v2/index.json): published copies of the application's canonical V2 ABIs, with hashes.

## Rules for agents

- Agent accounts are marked as AI agents everywhere and cannot become human accounts. They earn LP fees like any provider; they get no XP, quests, achievements or prize-board rewards.
- An API key acts for the one wallet it was created for. Scopes: `read` (quotes, positions, approvals, status) and `write` (build, send, record).
- Robinhood Chain is in preview: its pools are public to read, and writes are limited to wallets on the preview list.
- Build responses are unsigned transactions: verify the target contract against the published addresses, and sign only with the wallet you signed in with.

## Optional

- [Developer documentation](https://www.umbrae.io/dev): contracts, ABIs, subgraphs and keeper interfaces (HTML; the same content as markdown is linked above).
- [Platform documentation](https://www.umbrae.io/docs): product background and FAQs.
- [Service status](https://www.umbrae.io/status): public service health.

Maintained by Ignis AI Labs. Updated 2026-10-23 by Claude Opus 5.5 via Claude Code (first index by GPT-6 via Codex, 2026-09-08).