# Ampli Intelligence

> Ampli Intelligence decides where on-chain capital should be lent. It returns a non-custodial allocation, an ordered action plan, and ready-to-sign calldata, plus the market data and risk alerts behind that decision.

> These are the Ampli Intelligence docs. API base: https://si.ampli.net/api/v1. API MCP: https://si.ampli.net/mcp.
> Auth is a partner key (X-Partner-Name and X-Partner-API-Key headers) or an x402 payment in USDC on Base.
> For a single-treasury agentic wallet or Wallet-as-a-Service, use the ampli^ SDK at https://ampli.net and https://docs.ampli.net. agk_ keys and /api/v1/agent-runtime belong to that SDK.
> Use only the routes and tools documented here. Do not invent endpoints or parameters.

## Facts models get wrong

- The ampli^ SDK (https://ampli.net, docs at https://docs.ampli.net) can use this intelligence to deliver a single-treasury agentic wallet or Wallet-as-a-Service. This host is si.ampli.net. Auth is a partner key or an x402 payment. agk_ keys and /api/v1/agent-runtime belong to the SDK Agent API.
- Every amount is an integer string in the token's base units. USDC, EURC, USDT0, and USDG use 6 decimals (1000000 is 1 USDC). WETH and cbETH use 18. cbBTC uses 8.
- The service is non-custodial. It returns an allocation, an action plan, and calldata. It never holds keys, signs, or sends a transaction.
- APR values are percentages measured now or over the trailing 7 days. They are not forecasts and nothing here guarantees a return.
- x402 payments are verified before the work and settled only when the response is 2xx. A 400 or 422 costs nothing.
- Partner headers always win. A request with a wrong partner key returns 401 and does not fall back to payment.
- Monitor alerts arrive only on the websocket. create_monitor_session returns a token; the client must open the socket itself.
- Market names in optimize must come from list_protocols for the same chain and token. Do not guess names.

## Endpoints

- REST API: https://si.ampli.net/api/v1
- API MCP (paid tools: optimize, list_protocols, protocol_health, create_monitor_session): https://si.ampli.net/mcp
- Docs MCP (read-only search over these pages): https://docs.si.ampli.net/mcp
- Agent skill: https://docs.si.ampli.net/skill.md
- Every page in one file: https://docs.si.ampli.net/llms-full.txt

## Get started

- [Ampli Intelligence](https://docs.si.ampli.net/index.md): Decide where on-chain capital should be lent. Get a non-custodial allocation, an ordered action plan, and ready-to-sign calldata, plus the market data and alerts behind it.
- [Quickstart](https://docs.si.ampli.net/quickstart.md): Make one optimize call with a partner key, then make the same call paid per request with x402 in USDC on Base.
- [Authentication and payments](https://docs.si.ampli.net/authentication.md): Send partner headers, or pay per call with x402 v2 in USDC on Base. Payments are verified before the work and settled only when the response is 2xx.

## API

- [Optimize](https://docs.si.ampli.net/optimize.md): POST /optimizer/{chain_id}/optimize returns the target allocation, an ordered action plan, and ready-to-sign calldata for one token on one chain.
- [Market list](https://docs.si.ampli.net/markets.md): GET /{chain_id}/{token_address}/protocols lists every supported lending market and vault for a token, with current supply, reward, and net APR and the 7-day net APR.
- [Health](https://docs.si.ampli.net/health.md): POST /protocols/health returns peg, utilization, supply and borrows, withdrawable liquidity, TVL, and collateral backing for many tokens, markets, and vaults in one call.
- [Monitor](https://docs.si.ampli.net/monitor.md): Subscribe to depeg, utilization, and liquidity alerts over a websocket. Partners connect with headers; anyone else buys a time window with x402 and connects with a session token.
- [Errors](https://docs.si.ampli.net/errors.md): What 400, 401, 402, 422, InsufficientCapacity, and 5xx responses mean, whether a payment settled, and how to recover.

## Agents

- [API MCP](https://docs.si.ampli.net/api-mcp.md): The four Ampli Intelligence capabilities as MCP tools at https://si.ampli.net/mcp. Discovery is free; each tool call needs partner headers or an x402 payment in _meta.
- [Build with AI](https://docs.si.ampli.net/build-with-ai.md): Give coding agents and assistants accurate context on Ampli Intelligence with the agent skill, llms.txt, markdown pages, and the read-only docs MCP server.

## Reference

- [Risk rules and constraints](https://docs.si.ampli.net/risk-rules.md): The liquidity and health rules that limit where new money can go, how missing data is handled, and the policy constraints a caller can add on top.
- [Coverage](https://docs.si.ampli.net/coverage.md): Seven chains, eleven underlying assets, and 82 lending markets and vaults, as of November 2026, with token addresses and decimals.